Google Cloud の SAP 用エージェントを使用した SAP HANA のモニタリング

このプランニング ガイドでは、Google Cloud の SAP 用エージェントの SAP HANA モニタリング指標収集機能を中心に説明します。エージェントとその他の機能の詳細については、Google Cloud の SAP 用エージェントのプランニング ガイドをご覧ください。

Linux では、Google Cloud の SAP 用エージェントを使用して、SAP HANA インスタンスと基盤となるインフラストラクチャをモニタリングできます。これは、SAP HANA モニタリング指標の収集を通じて行われます。この収集機能は、Compute Engine インスタンスまたは Bare Metal Solution サーバーにエージェントをインストールした後に有効にできます。

SAP HANA モニタリング指標の収集を有効にすると、エージェントは SAP HANA インスタンスにクエリを実行し、収集した指標を Cloud Monitoring に送信します。収集された指標は、Monitoring のダッシュボードで可視化できます。また、指標のしきい値に基づいてアラートを設定することもできます。ダッシュボードとアラートの作成については、Cloud Monitoring のドキュメントをご覧ください。

SAP HANA モニタリング指標を収集するように Google Cloud の SAP 用エージェントを構成する方法については、SAP HANA モニタリング指標の収集を構成するをご覧ください。

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

クエリのサンプリング間隔により、エージェントが SAP HANA インスタンスに指標をクエリする頻度が決まります。この間隔は Monitoring に送信される指標の量に影響します。SAP HANA モニタリング指標は変化が緩やかな指標で、デフォルトでは、有効にすると 5 分ごとに収集されます。

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

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

費用見積もりの例

Google Cloud の SAP 用エージェントを使用して SAP HANA モニタリング指標を収集する際の費用の見積もりについては、取り込まれたバイト数で課金される指標の料金の例をご覧ください。

クエリについて

SAP HANA モニタリング指標を収集するために、Google Cloud の SAP 用エージェントは SAP HANA インスタンスに SQL クエリを実行します。このクエリの構文は SAP によって定義されています（SAP HANA SQL and System Views Reference をご覧ください）。

Google Cloud の SAP 用エージェントは、次のタイプのクエリをサポートしています。

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

デフォルト クエリ

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

デフォルト クエリの頻度は、エージェントの構成ファイルの hana_monitoring_configuration セクションの先頭にあるグローバル sample_interval_sec パラメータによって決まります。デフォルトでは、この値は 300 秒（5 分）に設定されています。このグローバルでのデフォルト設定は変更できます。カスタムクエリとは異なり、個々のデフォルト クエリにサンプル間隔を設定することはできません。

デフォルト クエリは変更できませんが、不要なデフォルト クエリは無効にできます。デフォルト クエリを無効にする手順については、SQL クエリを無効にするをご覧ください。

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

カスタムクエリ

SAP HANA インスタンスについてより詳しい分析情報を収集するには、Google Cloud の SAP 用エージェントでカスタムクエリを定義して実行します。

カスタムクエリは queries セクションで定義します。これは、エージェントの構成ファイルの hana_monitoring_configuration セクションに指定します。

カスタムクエリごとに sample_interval_sec パラメータを指定し、デフォルトの sample_interval_sec パラメータをオーバーライドできます。詳細については、クエリのサンプリング間隔をご覧ください。

このドキュメントのカスタムクエリの例は、独自のクエリの作成に役立ちます。カスタムクエリの作成の詳細については、カスタムクエリの定義をご覧ください。

クエリのサンプリング間隔

Google Cloud の SAP 用エージェントを使用した SAP HANA モニタリング指標の収集では、すべてのクエリのグローバルsample interval_secと、各カスタムクエリの個々のサンプル間隔を定義できます。このサンプリング間隔により、エージェントが SAP HANA インスタンスでクエリを実行する頻度が決まります。

すべてのクエリのデフォルトのサンプリング間隔は 300 秒（5 分）です。デフォルトのサンプリング間隔を調整するには、エージェント構成ファイルの hana_monitoring_configuration セクションの先頭にある sample_interval_sec パラメータに別の値を指定します。

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

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

Google Cloud の SAP 用エージェントは、Compute Engine インスタンスまたは Bare Metal Solution サーバーにインストールできます。

Google Cloud の SAP 用エージェントは、SAP HANA インスタンスと同じホストまたは別のホストにインストールできます。

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

中央の Compute Engine インスタンスからのリモート収集

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

Compute Engine インスタンスと Bare Metal Solution サーバーのローカル収集

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

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

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

エージェントは、SAP HANA インスタンスをホストする Compute Engine インスタンスにインストールできます。また、Bare Metal Solution サーバーで実行されている SAP HANA インスタンスをモニタリングするようにエージェントを構成することもできます。

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

エージェントの高可用性構成

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

エージェントの構成ファイルで、フローティング IP アドレスに対するモニタリングを構成することをおすすめします。この構成では、エージェントはアクティブなノードからのみ指標を収集します。

SSL / TLS のサポート

SAP HANA インスタンスが Transport Layer Secure（TLS）または Secure Sockets Layer（SSL）プロトコルを使用して、SAP HANA データベースと SAP HANA SQL インターフェースを使用するクライアント間の通信を保護している場合は、Google Cloud の SAP 用エージェントで TLS / SSL サポートを有効にする必要があります。これを行うには、Google Cloud の SAP 用エージェントの構成ファイルで、このような SAP HANA インスタンスのすべてに次のパラメータを指定する必要があります。

• enable_ssl パラメータを指定して、値を true に設定します。
• host_name_in_certificate パラメータを指定し、値として TLS / SSL 証明書で指定されているホスト名を設定します。
• tls_root_ca_file パラメータを指定し、値として TLS / SSL 証明書が保存されているパスを設定します。

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

SSL に関連するエージェント構成パラメータの説明については、構成パラメータをご覧ください。

カスタムクエリの定義

Google Cloud の SAP 用エージェントでは、カスタムクエリを定義して実行できます。

カスタムクエリには次の情報が含まれます。

• クエリを記述するパラメータとパラメータ値。
• SAP HANA インスタンスからデータを取得する SQL ステートメント。
• SQL ステートメントが返す 1 つ以上の指標。

これらのクエリ パラメータの詳細については、構成パラメータをご覧ください。

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

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

Google Cloud の SAP 用エージェントは、クエリ内の列を順序付きリストとして扱うため、カスタムクエリを定義する際は次のガイドラインに従ってください。

• SQL ステートメントでは、クエリ定義に含まれるすべての列を使用する必要があります。
• SQL ステートメントの列順序は、クエリ定義の列順序と一致する必要があります。
• カスタムクエリの例で説明したように、クエリブロック内に enabled: true を指定して、カスタムクエリを有効にしました。

たとえば、custom_memory_utilization という名前のカスタムクエリのクエリ定義の場合、クエリ定義に mem_used 列と resident_mem_used 列がこの順番で含まれています。この列の順序は、sql パラメータに指定された SQL ステートメントの列順序と一致します。

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

カスタムクエリの例

次の例は、2 つのカスタムクエリを示しています。これらのクエリの例は、独自のカスタムクエリを作成するためのモデルとして使用されることを意図しています。

{
  "name": "custom_memory_utilization",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(TOTAL_MEMORY_USED_SIZE), 0) AS mem_used, IFNULL(SUM(PHYSICAL_MEMORY_SIZE), 0) AS resident_mem_used FROM M_SERVICE_MEMORY;",
  "columns": [
    {
      "name": "mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    },
    {
      "name": "resident_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}
{
  "name": "custom_total_memory_usage",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(MEMORY_SIZE_IN_TOTAL), 0) AS table_mem_used FROM M_CS_TABLES;",
  "columns": [
    {
      "name": "table_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}

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

Google Cloud の SAP 用エージェントは、SAP HANA インスタンスにクエリを送信する前に、カスタムクエリの SQL を検証しません。

カスタムクエリが SQL 例外で失敗した場合、またはクエリ内の構成列が SAP HANA から返された結果と一致しない場合、エージェントはログにエラーを書き込みます。いずれの場合も、2 回連続してエラーが発生するまで、エージェントはカスタムクエリの実行を継続し、エラー メッセージをログに書き込みます。2 回失敗すると、エージェントはそのクエリの実行を停止します。このようなカスタムクエリの実行を再開するには、エージェントを再起動する必要があります。

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

SAP HANA モニタリング指標

次の表に、Google Cloud の SAP 用エージェントが収集する組み込みまたはデフォルトの SAP HANA モニタリング指標を示します。表に示す指標文字列には、workload.googleapis.com/ という接頭辞を付ける必要がありますが、この表のエントリでは省略しています。

Monitoring での指標の表示

Google Cloud には、Google Cloud の SAP 用エージェントによって収集された SAP HANA モニタリング指標を可視化するためのカスタム ダッシュボードが用意されています。GitHub の GoogleCloudPlatform/monitoring-dashboard-samples リポジトリの dashboards/google-cloud-agent-for-sap ディレクトリをご覧ください。

インストール手順など、これらのダッシュボードの詳細については、収集された指標を表示するをご覧ください。

Monitoring での指標データの検出とアラート通知の構成については、Monitoring の指標をご覧ください。

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

Google Cloud の SAP 用エージェントの組み込みデフォルト クエリは、SAP HANA から次の情報を返します。

特定の組み込みクエリまたはデフォルト クエリによって提供される指標が不要な場合は、無効にできます。手順については、次のガイドをご覧ください。

• Compute Engine インスタンスの場合は、クエリを無効にするをご覧ください。
• Bare Metal Solution サーバーの場合は、クエリを無効にするをご覧ください。

column_queries

組み込みクエリ column_queries は、SAP HANA の M_CS_ALL_COLUMNS システムビューから列ごとにメモリの使用状況に関する情報を返します。

このクエリは、次の指標を Monitoring に送信します。

component_queries

組み込みクエリ component_queries は、サービス固有のメモリ使用量を論理コンポーネントごとに SAP HANA から返します。このクエリでは、SAP HANA M_SERVICE_COMPONENT_MEMORY システムビューを使用します。

このクエリは、次の指標を Monitoring に送信します。

connection_query

組み込みクエリ connection_query は、SAP HANA M_CONNECTIONS システムビューを使用して、SAP HANA から実行中の接続とアイドル状態の接続の数を返します。

このクエリは、次の指標を Monitoring に送信します。

cpu_queries

組み込みクエリ cpu_queries は、SAP HANA M_HOST_RESOURCE_UTILIZATION システムビューを使用して、SAP HANA から CPU 使用率の情報を返します。

このクエリは、次の指標を Monitoring に送信します。

alert_query

組み込みクエリ alert_query は、_SYS_STATISTICS スキーマの SAP HANA STATISTICS_CURRENT_ALERTS ビューを使用して、SAP HANA 統計サーバーから現在のアラートの数と評価を返します。

このクエリは、次の指標を Monitoring に送信します。

host_queries

組み込みクエリ host_queries は、SAP HANA からホストによるメモリ使用量を返します。このクエリでは、SAP HANA M_HOST_RESOURCE_UTILIZATION システムビューを使用します。

このクエリは、次の指標を Monitoring に送信します。

replication_query

組み込みクエリ replication_query は、高可用性クラスタを実行している SAP HANA からレプリケーション レイテンシ情報を返します。このクエリでは、SAP HANA M_SERVICE_REPLICATION システムビューを使用します。SAP HANA デプロイメントで実行されているノードが 1 つだけの場合、このクエリは指標を返しません。

このクエリは、次の指標を Monitoring に送信します。

rowstore_query

組み込みクエリ rowstore_query は、SAP HANA M_RS_TABLES システムビューを使用して、SAP HANA から行ストアのサイズを返します。

このクエリは、次の指標を Monitoring に送信します。

schema_type_queries

組み込みクエリ schema_type_queries は、SAP HANA M_CS_TABLES システムビューを使用して、SAP HANA からメモリ使用量とレコード数の情報を返します。

このクエリは、次の指標を Monitoring に送信します。

schema_queries

組み込みクエリ schema_queries は、SAP HANA M_CS_TABLES システムビューを使用して、SAP HANA からスキーマの使用状況情報を返します。

このクエリは、次の指標を Monitoring に送信します。

service_queries

組み込みクエリ service_queries は、サービスによって使用されたメモリに関する情報を SAP HANA から返します。このクエリでは、SAP HANA M_SERVICE_MEMORY システムビューを使用します。

このクエリは、次の指標を Monitoring に送信します。

transaction_query

組み込みクエリ transaction_query は、SAP HANA M_WORKLOAD システムビューを使用して、SAP HANA からトランザクション（更新、commit、ロールバック）の合計数を返します。

このクエリは、次の指標を Monitoring に送信します。

blocked_transaction_query

組み込みクエリ blocked_transaction_query は、SAP HANA M_DATABASES、M_SERVICES、M_BLOCKED_TRANSACTIONS システムビューを使用して、SAP HANA からブロックされたトランザクションの合計数を返します。

このクエリは、エージェントのバージョン 3.5 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。

data_backup_state_query

組み込みクエリ data_backup_state_query は、SAP HANA M_BACKUP_CATALOG システムビューを使用して、SAP HANA から最後の完全なデータ バックアップの最新の状態を返します。

このクエリは、エージェントのバージョン 3.5 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。

log_backup_state_query

組み込みクエリ log_backup_state_query は、SAP HANA M_BACKUP_CATALOG システムビューを使用して、SAP HANA からブロックされたトランザクションの合計数を返します。

このクエリは、エージェントのバージョン 3.5 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。

memory_unloads_query

組み込みクエリ memory_unloads_query は、メモリ不足が原因で SAP HANA で発生したテーブルのアンロードの合計数を返します。SAP HANA M_CS_UNLOADS システムビューを使用します。

このクエリは、エージェントのバージョン 3.5 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。

avg_write_time_queries

組み込みクエリ avg_write_time_queries は、SAP HANA M_VOLUMES システムビューと M_VOLUME_IO_DETAILED_STATISTICS システムビューを使用して、SAP HANA からデータ ボリュームとログボリュームの平均書き込み時間を返します。

このクエリは、エージェントのバージョン 3.5 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。

avg_read_time_queries

組み込みクエリ avg_read_time_queries は、SAP HANA M_VOLUMES システムビューと M_VOLUME_IO_DETAILED_STATISTICS システムビューを使用して、SAP HANA からデータ ボリュームの平均読み取り時間を返します。

このクエリは、エージェントのバージョン 3.5 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。

data_snapshot_state_queries

組み込みクエリ data_snapshot_state_queries は、SAP HANA M_BACKUP_CATALOG システムビューを使用して、SAP HANA から最後の完全なディスク スナップショット ベースのデータ バックアップの状態を返します。

このクエリは、エージェントのバージョン 3.6 以降でサポートされています。

このクエリは、次の指標を Monitoring に送信します。