指標の収集用に 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 用エージェントが正しく設定されていることを確認するために必要なタスクを示します。

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

詳細については、VM に Agent for SAP をインストールして構成するをご覧ください。

SAP 用エージェントを更新する
SAP 用エージェントのバージョン 3.5 には、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 用エージェントを構成するをご覧ください。

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

詳細については、Process Monitoring 指標の収集を構成するをご覧ください。

Agent for SAP の HANA モニタリング指標の収集を有効にする
HANA VM では、HANA Process Monitoring 指標の収集を有効にする必要があります。この機能を有効にするには、次のコマンドを実行します。
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

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

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

詳細については、SAP HANA モニタリング指標の収集を構成するをご覧ください。

エージェントの構成と設定を検証する Google Cloud
次のコマンドを実行して、エージェントが正しく構成されていることを確認します。
         sudo /usr/bin/google_cloud_sap_agent status

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

SAP 用エージェントを再起動する
変更を有効にするには、次のコマンドを実行してエージェントを再起動します。
         sudo systemctl restart google-cloud-sap-agent

詳細については、エージェントを再起動するをご覧ください。

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

エージェントの status コマンドを実行して、Workload Manager オブザーバビリティ サービスを使用するための正しい設定がされていることを確認できます。 Google Cloud このコマンドは、エージェントのバージョン 3.7 以降でサポートされています。

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

  1. Compute Engine インスタンスと SSH 接続を確立します。
  2. 次のコマンドを実行します。

    sudo /usr/bin/google_cloud_sap_agent status
    

    Google Cloud Workload Manager オブザーバビリティ サービスの使用設定が正しい場合、出力には次のものが表示されます。構成には、default 以外の値が設定されている場合があります。

    Agent Status:
        Installed version: 3.7-....
        ...
        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:      5    (default)
            process_metrics_to_skip:        []   (default)
            slow_process_metrics_frequency: 30   (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 コマンドを再実行して設定を再検証します。

例: 構成ファイル

オブザーバビリティの機能を有効にすると、Agent for 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"
      },
    ],
   }
  }
  

次のステップ