指標の収集用に SAP 用エージェントを構成する

Google Cloudの SAP 用エージェントは、Compute Engine インスタンスで実行されている SAP ワークロードのモニタリングをサポートし、 Google Cloudで SAP システムを効率的に実行するのに役立ちます。SAP システムを実行するすべての VM に、 Google Cloudの SAP 用エージェントをインストールする必要があります。このエージェントは、SAP が必須とするすべての情報を収集し、SAP Host Agent に送信します。詳細については、SAP Note 2469354 をご覧ください。

オブザーバビリティに使用される基盤となるインフラストラクチャとアプリケーションの指標を収集するには、SAP 用エージェントの追加機能を有効にする必要があります。

このドキュメントでは、Agent for SAP でこれらの機能を有効にする方法について説明します。

SAP 用エージェントのチェックリスト

次のチェックリストは、オブザーバビリティのために SAP 用エージェントが適切に設定されていることを確認するために必要なタスクをまとめたものです。

SAP 用エージェントをインストールして構成する		 モニタリングする各 Compute Engine VM に Google Cloudの SAP 用エージェントをインストールして構成します。
の SAP 用エージェントは、次の「SAP 用」公開 OS イメージに含まれています。
  • RHEL: すべての「SAP 用」イメージ
  • SLES: SAP 用 SLES 15 SP4 以降のバージョン

詳細については、VM に SAP 用エージェントをインストールして構成するをご覧ください。
SAP 用エージェントを更新する		 SAP 用エージェントのバージョン 3.10 には、SAP のオブザーバビリティの設定に必要なすべての機能が含まれています。エージェントが以前にインストールされている場合は、最新バージョンに更新することをおすすめします。

詳細については、 Google Cloudの SAP 用エージェントを更新するをご覧ください。
Agent for SAP のシステム ディスカバリ機能を有効にする		 エージェントの構成ファイルで、次のパラメータを true に設定する必要があります。2024 年 2 月 14 日以降にエージェントをインストールした場合、これらのフラグはデフォルトで true に設定されているため、変更は必要ありません。
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
2024 年 2 月 14 日より前にエージェントをインストールした場合、またはシステムの検出機能を無効にしている場合は、次のコマンドを実行します。
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 

sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

詳細については、 Google Cloudの SAP 用エージェントを構成するをご覧ください。
SAP 用エージェントの Process Monitoring 指標の収集を有効にする		 エージェントの構成ファイルで、collection_configuration.collect_process_metrics パラメータを true に設定する必要があります。この機能を有効にするには、次のコマンドを実行します。
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

詳細については、Process Monitoring 指標の収集を構成するをご覧ください。
SAP 用エージェントの HANA モニタリング指標の収集を有効にする		 HANA VM では、HANA Process Monitoring 指標の収集を有効にする必要があります。この機能を有効にするには、次のコマンドを実行します。
 sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

エージェントの構成ファイルの hana_monitoring_configuration セクションを編集して、HANA インスタンス名、SID、ホスト、ポート、ユーザー、パスワードを指定します（Secret または hdbuserstore キーを使用）。

指定した HANA ユーザーには、デフォルトのクエリでクエリされるテーブルに対する読み取りアクセス権が必要です。

詳細については、SAP HANA モニタリング指標の収集を構成するをご覧ください。
エージェントの構成と Google Cloud の設定を検証する		 次のコマンドを実行して、エージェントが正しく構成されていることを確認します。
sudo /usr/bin/google_cloud_sap_agent status

詳細については、Workload Manager オブザーバビリティの設定を検証するをご覧ください。

Workload Manager のオブザーバビリティの設定を確認する

エージェントの status コマンドを実行して、Workload Manager 可観測性サービスを使用するために Google Cloud が正しく設定されているかどうかを確認できます。

Google Cloud の設定を検証するには、次の操作を行います。

  1. Compute Engine インスタンスと SSH 接続を確立します。

  2. 次のコマンドを実行します。

    sudo /usr/bin/google_cloud_sap_agent status

    Workload Manager 可観測性サービスを使用するための Google Cloud 設定が正しい場合、出力には次のものが含まれます。構成には、default 以外の値が含まれている場合があります。

    Agent Status:
    Installed version: 3.10-....
    ...
    Systemd Service Enabled: True
    Systemd Service Running: True
    Cloud API Full Scopes: True
    Configuration File: /etc/google-cloud-sap-agent/configuration.json
    Configuration Valid: True
...
----------------------------------------------------------------------------
Process Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        collect_process_metrics:        true (configuration file)
        process_metrics_frequency:      30    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 120   (default)
...
----------------------------------------------------------------------------
HANA Monitoring Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        connection_timeout:       120   (default)
        enabled:                  true  (configuration file)
        execution_threads:        10    (default)
        max_connect_retries:      1     (default)
        query_timeout_sec:        300   (default)
        sample_interval_sec:      300   (default)
        send_query_response_time: false (default)
...
----------------------------------------------------------------------------
System Discovery: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        enable_discovery:                  true  (default)
        enable_workload_discovery:         true  (default)
        sap_instances_update_frequency:    60    (default)
        system_discovery_update_frequency: 14400 (default)
...

  3. 出力に設定に不備があることが示されている場合は、前のセクションで説明した情報を確認して必要なアクションを実行し、status コマンドを再度実行して設定を検証します。

構成ファイルの例

オブザーバビリティの機能を有効にすると、SAP 用エージェントの構成ファイルは次のようになります。

  {
    "provide_sap_host_agent_metrics": true,
    "bare_metal": false,
    "log_level": "INFO",
    "log_to_cloud": true,
    "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "host": "localhost",
          "port": "30015",
          "user": "system",
          "secret_name": "password-secret-name"
        }
      ]
    }
  }

次のステップ