SAP HANA V2.0 用モニタリングエージェントのプランニングガイド

重要: 新規のインストールでは、SAP HANA 用モニタリングエージェントではなく、その後継である Google Cloud の SAP 用エージェントの使用をおすすめします。バージョン 2.0 以降、Google Cloud の SAP 用エージェントは、SAP Host Agent 指標の収集機能に加え、SAP HANA のモニタリングなどの機能も備えています。

SAP HANA 用のモニタリングエージェントを使用している場合は、そのサポートが終了する前に Google Cloud の SAP 用エージェントバージョン 3.5（最新）へ切り替えることをおすすめします。アップグレード手順については、他の Google Cloud エージェントから Google Cloud の SAP 用エージェントにアップグレードするをご覧ください。

SAP HANA 用モニタリングエージェントのサポートは、2024 年 5 月 31 日に終了します。

SAP HANA 用 Google Cloud モニタリングエージェントを使用すると、Cloud Monitoring を使用して Google Cloud コンソールに SAP HANA システムの指標を表示できます。エージェントは、ホストマシンで systemd サービスとして実行されます。

指標を収集するには、SAP HANA 用モニタリングエージェントが、SAP HANA SQL and System Views Reference で SAP が定義している SQL 構文とシステムビューを使用して、SAP HANA にクエリを実行します。

SAP HANA のメモリ使用率指標は、キャパシティプランニングに利用でき、またメモリベースの SAP HANA ライセンスの管理にも役立ちます。SAP HANA の指標と Compute Engine の指標を関連付けることで、使用状況とパフォーマンスの傾向を把握できます。

SAP HANA のインストールをさらに分析するには、カスタムクエリを定義して追加の指標をキャプチャします。

Cloud Monitoring を使用すると、SAP HANA の指標を可視化するダッシュボードを作成し、指標のしきい値に基づくアラートを設定できます。ダッシュボードとアラートを設定する方法の詳細については、Cloud Monitoring のドキュメントをご覧ください。

Cloud Monitoring の指標の料金

SAP HANA のモニタリングエージェントが収集して Monitoring に送信する指標は、Monitoring によって請求可能な指標に分類されます。取り込み量で請求可能な指標をモニタリングする。

SAP HANA 用モニタリングエージェントが SAP HANA に指標についてクエリする頻度を規定するクエリのサンプリング間隔は、Monitoring に送信される指標の数に影響します。

Monitoring の料金の詳細については、Google Cloud Observability の料金をご覧ください。

クエリのサンプリング間隔の詳細については、クエリのサンプル間隔をご覧ください。

クエリ: デフォルトとカスタム

SAP HANA 用モニタリングエージェントは、SQL クエリを使用して SAP HANA から指標を収集します。エージェントには、一連のデフォルトクエリが含まれており、カスタムクエリを追加できます。

デフォルトクエリとカスタムクエリはいずれも、SAP HANA SQL and System Views Reference に記載されている SAP HANA システムビューによって定義される指標を取得します。

デフォルトクエリのタイプ

デフォルトクエリは、SAP HANA で最もよく使用される指標を収集する組み込みクエリです。

デフォルトクエリの頻度は、configuration.yaml ファイルの先頭にあるグローバルな sample_interval プロパティによって決まります。デフォルトでは、この値は 300 秒（5 分）に設定されています。このグローバルでのデフォルト設定は変更できます。カスタムクエリとは異なり、個々のデフォルトクエリにサンプル間隔を設定することはできません。

デフォルトクエリは変更できませんが、エージェント構成ファイル configuration.yaml で不要なデフォルトクエリは無効にできます。

デフォルトクエリ、収集される指標、および基盤となる SQL ステートメントの詳細については、デフォルトクエリのリファレンスをご覧ください。

カスタムクエリのタイプ

カスタムクエリを作成するには、SAP HANA 用モニタリングエージェントの configuration.yaml ファイル内でカスタムクエリを定義します。

カスタムクエリの場合、クエリごとに _sample_interval_ を指定すると、すべてのクエリのデフォルトのサンプル間隔がオーバーライドされます。詳細については、クエリのサンプル間隔をご覧ください。

configuration.yaml ファイルには、デフォルトで無効になっているカスタムクエリの 2 つの例が含まれています。提供されたカスタムクエリは、独自のカスタムクエリのモデルとして使用できます。カスタムクエリの例は、カスタムクエリの例で示されています。

カスタムクエリのエラー処理

エージェントは、クエリが SAP HANA に送信されるまでカスタムクエリに含まれる SQL を検証しません。

カスタムクエリが SQL 例外で失敗した場合、またはクエリ内の構成列が SAP HANA から返された結果と一致しない場合、エージェントはログにエラーを書き込みます。いずれの場合でも、エージェントは引き続きカスタムクエリを実行し、カスタムクエリが修正されるまでエラーメッセージをログに書き込みます。

カスタムクエリに必要な SQL 構文については、SAP HANA SQL and System Views Reference をご覧ください。

クエリのサンプル間隔

すべてのクエリに対してグローバルなサンプル間隔を定義し、カスタムクエリに対しては個々のサンプル間隔を定義できます。サンプル間隔によって、モニタリングエージェントが SAP HANA に指標のクエリを行う頻度が決まります。

すべてのクエリのデフォルトのサンプル間隔は 300 秒（5 分）です。デフォルトのサンプル間隔を調整するには、configuration.yaml ファイルの先頭の sample_interval プロパティで別の値を指定します。

個々のカスタムクエリのデフォルトのサンプル間隔をオーバーライドするには、クエリの定義で sample_interval プロパティを指定します。

インストールアーキテクチャ

SAP HANA 用のモニタリングエージェントは、Compute Engine VM または Bare Metal Solution サーバーにインストールします。

エージェントは、SAP HANA と同じホストにインストールすることも、別のホストにインストールすることもできます。

また、エージェントは、適切に構成されたサービスアカウントを使用して Google Cloud APIs にアクセスできる限り、オンプレミスホストまたは別のクラウドプラットフォームのホスト上で実行されている SAP HANA インスタンスもモニタリングできます。

中央の Compute Engine VM からのリモート収集

次の図は、SAP HANA インスタンスを実行している VM またはサーバーとは別のホスト VM にエージェントがインストールされるインストールアーキテクチャを示しています。

HANA モニタリングエージェントの設定 1

Compute Engine VM と Bare Metal Solution サーバーのローカル収集

ファイアウォールルールで環境へのアクセスが制限されている場合は、SAP HANA インスタンスを使用して、同じ Compute Engine VM または Bare Metal Solution サーバーにエージェントをインストールできます。

次の図は、エージェントが Compute Engine VM と Bare Metal Solution サーバーに個別にインストールされるインストールアーキテクチャを示しています。

HANA モニタリングエージェントの設定 2

ハイブリッド収集アーキテクチャ

SAP HANA インスタンスと同じホスト VM にエージェントをインストールし、Bare Metal Solution サーバーで SAP HANA インスタンスをモニタリングするようにエージェントを構成することもできます。

HANA モニタリングエージェントの設定 3

複数の Google Cloud プロジェクトの SAP HANA インスタンスをモニタリングする場合は、モニタリング対象の SAP HANA インスタンスを含む Google Cloud プロジェクトごとに SAP HANA 用のモニタリングエージェントを 1 つ以上インストールする必要があります。

SAP HANA 用モニタリングエージェントの高可用性構成

高可用性クラスタで SAP HANA インスタンスをモニタリングする場合は、エージェントをクラスタ内のノードではないホストにインストールして、フェイルオーバーの影響をエージェントが受けないようにします。

構成ファイル configuration.yaml で、フローティング IP アドレスに対するモニタリングを構成することをおすすめします。この構成では、現在アクティブなノードの指標のみが収集されます。

HANA モニタリングエージェント設定 4

サポートされているオペレーティングシステム

SAP HANA 用モニタリングエージェントは、次のオペレーティングシステムの一般的なプロダクトと SAP プロダクトの両方をサポートします。

Red Hat Enterprise Linux（RHEL）7、8、9 ^注
SUSE Linux Enterprise Server（SLES）12、15

注: RHEL for SAP 9.x に SAP ソフトウェアをインストールする前に、ホストマシン、特に chkconfig と compat-openssl11 に追加パッケージをインストールする必要があります。Compute Engine が提供するイメージを使用する場合、これらのパッケージは自動的にインストールされます。SAP の詳細については、SAP Note 3108316 - Red Hat Enterprise Linux 9.x: Installation and Configuration をご覧ください。

認証とアクセス

SAP HANA 用モニタリングエージェントには、Google Cloud による認証と Google Cloud リソースへのアクセスのための Identity and Access Management（IAM）サービスアカウントが必要です。

サービスアカウントに割り当てられている IAM ロールによって、エージェントがアクセスできる Google Cloud リソースが決まります。

既存のサービスアカウントやデフォルトのサービスアカウントを使用する場合を除き、Google Cloud プロジェクトでサービスアカウントを作成し、サービスアカウントに 1 つ以上のロールを割り当てる必要があります。

必要な IAM のロール

新しいサービスアカウント、既存のサービスアカウント、デフォルトのサービスアカウントのいずれを使用するかに関係なく、サービスアカウントには SAP HANA 用モニタリングエージェントに必要な権限を与えるロールを含める必要があります。

モニタリング指標の書き込みの IAM 事前定義ロール（roles/monitoring.metricWriter）は、Monitoring に指標を書き込む権限を付与します。

パスワードの保存に Secret Manager を使用する場合は、以下が必要です。

サービスアカウントには、事前定義ロール「Secret Manager のシークレットアクセサー」（roles/secretmanager.secretAccessor）が含まれている必要があります。これにより、Secret Manager に保存されているシークレットへのアクセス権限が付与されます。
VM インスタンスには、Secret Manager API へのアクセスを許可する cloud-platform アクセススコープが必要です。詳細については、Secret Manager API へのアクセスをご覧ください。

サービスアカウントを指定する

エージェントが Compute Engine VM で実行されている場合、エージェントはデフォルトでホスト VM のサービスアカウントを使用します。構成ファイルでサービスアカウントを指定する必要はありません。

ホスト VM サービスアカウントは、通常、自分や同僚が作成した制限されたロールを持つサービスアカウントですが、代わりに、デフォルトで幅広い権限を持つ Compute Engine のデフォルトサービスアカウントを使用することもできます。

ホスト VM のサービスアカウント以外のサービスアカウントを使用する場合、またはエージェントが Compute Engine VM で実行されていない場合は、JSON サービスアカウントキーを使用してサービスアカウントを作成する必要があります。アクセス可能な場所に JSON キーファイルを保存し、エージェントの configuration.yaml ファイルの service_account_json プロパティで JSON ファイルへのパスを指定します。

サービスアカウント、ロール、権限の詳細については、以下をご覧ください。

Google Cloud APIs へのアクセス

Compute Engine VM でエージェントが実行されていない場合は、Google Cloud APIs への接続を確立する必要があります。詳細については、オンプレミスホスト用の限定公開の Google アクセスの構成をご覧ください。

Cloud Monitoring の SAP HANA 指標

SAP HANA 用のモニタリングエージェントは、SAP HANA から取得したデータをカスタム指標データとして Monitoring に送信します。データを送信するために、エージェントは Cloud Monitoring API を使用します。この API は、Google Cloud プロジェクトの作成時にデフォルトで有効になります。

Monitoring については、Cloud Monitoring の概要をご覧ください。

Cloud Monitoring での SAP HANA データの検索

SAP HANA の指標データは、Monitoring が受信するとすぐに表示できるようになります。

Monitoring で SAP HANA データを表示するには、Dashboard Editor または Metrics Explorer ツールを使用して Google Cloud コンソールでグラフを作成し、指標フィールドに「sap_hana」と入力します。これで、sap_hana を含む使用可能なすべての指標タイプのプルダウンリストから、指標タイプごとにデータを選択できます。

Monitoring で特定の SAP HANA インスタンスのみのデータを表示するには、SAP HANA ホスト VM の名前（Monitoring の指標ラベル）などを使用してビューをフィルタします。

詳しくは、次のトピックをご確認ください。

GitHub 上の SAP HANA のダッシュボード定義

GitHub には、Google Cloud プロジェクトにインストールできる SAP HANA のカスタムダッシュボードの定義があります。GitHub の GoogleCloudPlatform/monitoring-dashboard-samples リポジトリをご覧ください。SAP HANA ダッシュボード定義ファイル、performance.json ファイル、README.md ファイルは、/dashboards/sap-hana サブディレクトリにあります。

SAP HANA のカスタムダッシュボードは、インストールした後そのまま使用するか、Google Cloud コンソールでカスタマイズできます。

SAP HANA のカスタムダッシュボードをインストールするには、インストール可能なダッシュボードをご覧ください。

アラート通知

定義したしきい値に指標が達したときにアラートを受けるには、Monitoring でアラート通知を構成します。

詳細については、アラートの概要をご覧ください。

パスワードの管理

デフォルトでは、SAP HANA 用モニタリングエージェントは、事前定義された SAP HANA システムデータベースユーザーアカウントを使用して SAP HANA の指標にクエリを実行します。エージェントは、エージェントがモニタリングする SAP HANA データベースごとに、データベースユーザーアカウントのパスワードを指定する必要があります。

SAP HANA 用モニタリングエージェントにパスワードを安全に提供するには、Secret Manager を使用します。これは Google Cloud の有料サービスです。

または、configuration.yaml ファイルの各インスタンス定義の password プロパティで、データベースユーザーパスワードを書式なしテキストで指定できます。

Secret Manager の料金については、料金をご覧ください。

SSL / TLS のサポート

SAP HANA インスタンスで Transport Layer Secure（TLS）/ Secure Sockets Layer（SSL）プロトコルを使用して、SAP HANA データベースと SAP HANA SQL インターフェースを使用するクライアントとの間の通信を保護するには、configuration.yaml ファイルのインスタンス定義内の enable_ssl: true を指定して、SAP HANA 用モニタリングエージェントの TLS/SSL サポートを有効にします。

証明書を検証するように SAP HANA が構成されている場合は、証明書の検証をサポートするようにエージェントを構成し、キーストアとトラストストアのパスとパスワードを指定できます。

SSL と証明書チェックのためのエージェント構成プロパティの説明については、構成プロパティの説明をご覧ください。

ロギング

SAP HANA 用モニタリングエージェントを初めて起動すると、すべてのログエントリが書き込まれるログファイル /var/log/google-saphanamonitoring-agent.log がローカルホストに作成されます。

デフォルトでは、ログファイルが 10.5 MB に達すると、新しいログがファイルに追加される際に古いログが破棄されます。

エージェントのロギングは、conf/logging.properties ファイルによって構成されます。

サポート

Google Cloud のインフラストラクチャやサービスに関する問題については、カスタマーケアにお問い合わせください。連絡先は、Google Cloud コンソールのサポートの概要ページで確認できます。カスタマーケアが SAP システムに問題があると判断した場合は、SAP サポートをご案内します。

SAP プロダクト関連の問題については、SAP サポートでサポートリクエストを送信してください。SAP はサポートチケットを評価し、Google Cloud インフラストラクチャの問題と判断した場合は、そのチケットをシステム内の適切な Google Cloud コンポーネント（BC-OP-LNX-GOOGLE または BC-OP-NT-GOOGLE）に転送します。

サポート要件

SAP システムと、そのシステムが使用する Google Cloud のインフラストラクチャおよびサービスに対するサポートを受けるには、サポートプランの最小限の要件を満たす必要があります。

Google Cloud での SAP に関する最小限のサポート要件について詳しくは、以下をご覧ください。

Google Cloud での SAP に関するサポートを受ける
SAP Note 2456406 - SAP on Google Cloud Platform: Support Prerequisites（SAP ユーザーアカウントが必要です）

カスタムクエリの定義

カスタムクエリは configuration.yaml ファイルで定義します。

カスタムクエリ定義は、クエリと返される指標を記述するプロパティ値と、SAP HANA からデータを取得する SQL ステートメントで構成されます。

SAP HANA でクエリに使用できるシステムビューの完全なリストについては、SAP HANA SQL and System Views Reference をご覧ください。

カスタムクエリを作成する場合、Monitoring は概要データや集計データに最適であり、カーディナリティの高いデータポイントを保存するためのものではないことに注意してください。SQL 集計関数（SUM、AVG、COUNT、MIN、MAX など）を使用して、返されるレコードの数を制限します。

カスタムクエリの例については、カスタムクエリの例をご覧ください。

カスタムクエリのプロパティ

次の表に、カスタムクエリの定義に使用するプロパティを示します。

プロパティ	値	説明
`sample_interval`	Int	`configuration.yaml` ファイルの先頭で、クエリ間のデフォルトの間隔を秒単位で定義します。カスタムクエリの定義では、プロパティはデフォルトをオーバーライドして、そのクエリのサンプル間隔のみを定義します。
`query_timeout`	Int	クエリが失敗する前にクエリの実行に必要な時間（秒単位）。デフォルトは 300 秒（5 分）です。
`queries`	次のプロパティの説明は、カスタムクエリにのみ適用されます。
`- name`	文字列	クエリの名前。
`enabled`	ブール値	エージェントが SAP HANA にクエリを送信するかどうかを指定します。有効な値は `true` または `false` です。
`description`	文字列	クエリで取得する指標の説明。
`sql`	文字列	エージェントが SAP HANA に対して発行するように指定した SQL ステートメント。SQL ステートメントは、SAP によって定義される SQL 構文に準拠している必要があります。詳細については、SAP HANA SQL and System Views Reference をご覧ください。
`columns`	各列定義は、Monitoring による処理の指標です。
`- name`	文字列	Monitoring で指標タイプを定義する指標の名前。
`metric_type`	文字列	Monitoring での処理では、指標のタイプ（GAUGE または CUMULATIVE）が使用されます。
`value_type`	文字列	Monitoring での処理では、指標のデータ型、BOOL、INT64、DOUBLE が使用されます。指標タイプでサポートされているデータ型を指定します。詳細については、サポートされる組み合わせをご覧ください。
`description`	文字列	指標の説明。
`units`	文字列	指標値が報告される単位。詳細については、`unit` フィールドのドキュメントをご覧ください。

カスタムクエリの例

次の例は、2 つのカスタムクエリを示しています。これらのクエリは、SAP HANA 用モニタリングエージェントをインストールするときに /usr/sap/google-saphanamonitoring-agent/conf/ ディレクトリ内に作成される configuration.yaml ファイルにも含まれます。このサンプルクエリは、独自のカスタムクエリのモデルとして使用することを目的としています。

- name: custom_memory_utilization
  enabled: false
  # sample_interval: 120
  description: |
    Custom Total memory utilization by services
  sql: |
    SELECT
           SUM(TOTAL_MEMORY_USED_SIZE) AS "mem_used",
           SUM(PHYSICAL_MEMORY_SIZE) AS "resident_mem_used"
    FROM M_SERVICE_MEMORY;
  columns:
  - name: mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory from the memory pool.
    units: By
  - name: resident_mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory used in total by all the services.
    units: By
- name: custom_total_memory_usage
  enabled: false
  # sample_interval: 120
  description: |
    Custom Amount of memory used in total by all column-tables
  sql: |
    SELECT
           SUM(MEMORY_SIZE_IN_TOTAL) AS "table_mem_used"
    FROM M_CS_TABLES;
  columns:
  - name: table_mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory used in total (sum of memory size in the main, delta, and history
      parts) by all column-tables.
    units: By
# Add additional queries for custom metrics

デフォルトクエリのリファレンス

SAP HANA 用モニタリングエージェントの組み込みデフォルトクエリは、SAP HANA から次の情報を取得します。

特定のデフォルトクエリによって提供される指標が不要な場合は、configuration.yaml ファイルでクエリ名の後に enabled: false を指定すると、クエリを無効にできます。