オブザーバビリティを設定するように SAP 用エージェントを構成する

このドキュメントでは、Workload Manager を使用して SAP ワークロードのオブザーバビリティを設定するように Google Cloudの SAP 用エージェントを構成する方法について説明します。

Workload Manager オブザーバビリティサービスでは、エージェントが SAP ワークロードと基盤となるインフラストラクチャから指標を収集する必要があります。詳細については、SAP オブザーバビリティの概要をご覧ください。

始める前に

オブザーバビリティを設定する SAP ワークロードを実行しているすべての Compute Engine インスタンスで、 Google Cloudの SAP 用エージェントのインストールを検証します。

エージェントのインストールを検証する方法については、エージェントのインストールを検証するをご覧ください。
SAP のオブザーバビリティの前提条件を満たしていることを確認します。

単一ゾーンワークロードのエージェントを構成する

VM Extension Manager

Compute Engine インスタンスのフリートでエージェントを構成して管理するには、そのための VM Extension Manager ポリシーを作成する必要があります。

単一のゾーンで実行されている SAP ワークロードのオブザーバビリティを設定するようにエージェントを構成するには、次の操作を行います。

VM Extension Manager を設定します。
- VM Extension Manager のドキュメントで、始める前にのセクションを確認します。
- VM Extension Manager ポリシーの作成と管理に必要な IAM ロールを設定します。詳しくは以下をご覧ください。
SAP ワークロードを実行するコンピューティングインスタンスに Google Cloudの SAP 用エージェントをインストールして管理する VM 拡張機能ポリシーを作成します。
- SAP ワークロードが実行されているゾーンに VM 拡張機能ポリシーを作成します。このような VM 拡張機能ポリシーの作成方法については、ゾーン VM 拡張機能ポリシーを作成するをご覧ください。
- オブザーバビリティのエージェント構成の例については、エージェント構成の例をご覧ください。

パッケージマネージャー

VM 拡張機能マネージャーを使用せずにエージェントのライフサイクルを手動で管理する場合は、パッケージマネージャーを使用して Google Cloudの SAP 用エージェントを構成できます。

SAP ワークロードを実行するコンピューティングインスタンスとの SSH 接続を確立します。
SAP 用エージェントの最新バージョンを実行していることを確認します。

エージェントを更新する方法については、 Google Cloudの SAP 用エージェントを更新するをご覧ください。

エージェントが SAP ワークロードの詳細を検索して Workload Manager に送信できるようにするには:

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

エージェントが SAP ワークロードで実行されているプロセスから指標を収集できるようにします。
1. エージェントのプロセスモニタリング機能を有効にします。
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. エージェントが SAP HANA データベースインスタンスに関連するプロセス指標を収集できるようにするには、hana_metrics_config セクションで追加のパラメータを構成する必要があります。
詳細については、プロセスモニタリング指標の収集を構成するをご覧ください。
エージェントが SAP ワークロードで実行されている SAP HANA インスタンスから指標を収集できるようにします。
1. エージェントの SAP HANA モニタリング機能を有効にします。
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. エージェントが SAP HANA インスタンスに接続して指標を収集できるようにするには、追加のパラメータを構成する必要があります。
詳細については、SAP HANA モニタリング指標の収集を構成するをご覧ください。
構成ファイルを保存します。

オブザーバビリティのエージェント構成の例については、エージェント構成の例をご覧ください。

マルチゾーンワークロードのエージェントを構成する

VM Extension Manager

Compute Engine インスタンスのフリートでエージェントを構成して管理するには、そのための VM Extension Manager ポリシーを作成する必要があります。

2 つ以上のゾーンで実行されている SAP ワークロードのオブザーバビリティを設定するようにエージェントを構成するには、次の手順を完了します。

VM Extension Manager を設定します。
- VM Extension Manager のドキュメントで、始める前にのセクションを確認します。
- VM Extension Manager ポリシーの作成と管理に必要な IAM ロールを設定します。詳しくは以下をご覧ください。
SAP ワークロードのプライマリサイトを実行するコンピューティングインスタンスに Google Cloudの SAP 用エージェントをインストールして管理する VM 拡張機能ポリシーを作成します。
- SAP ワークロードのプライマリサイトが実行されているゾーンに VM 拡張機能ポリシーを作成します。このような VM 拡張機能ポリシーの作成方法については、ゾーン VM 拡張機能ポリシーを作成するをご覧ください。
- オブザーバビリティのエージェント構成の例については、エージェント構成の例をご覧ください。
高可用性 SAP ワークロードを実行している場合、または SAP ワークロードの障害復旧（DR）サイトがある場合は、SAP ワークロードのセカンダリサイトまたは DR サイトを実行するコンピューティングインスタンスに Google Cloudの SAP 用エージェントをインストールして管理する VM 拡張機能ポリシーを作成します。

パッケージマネージャー

SAP ワークロードを実行するコンピューティングインスタンスとの SSH 接続を確立します。
SAP 用エージェントの最新バージョンを実行していることを確認します。

エージェントを更新する方法については、 Google Cloudの SAP 用エージェントを更新するをご覧ください。

エージェントが SAP ワークロードの詳細を収集して Workload Manager に送信できるようにするには:

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

エージェントが SAP ワークロードで実行されているプロセスから指標を収集できるようにします。
1. エージェントのプロセスモニタリング機能を有効にします。
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. エージェントが SAP HANA データベースインスタンスに関連するプロセス指標を収集できるようにするには、hana_metrics_config セクションで追加のパラメータを構成する必要があります。
詳細については、プロセスモニタリング指標の収集を構成するをご覧ください。
エージェントが SAP ワークロードで実行されている SAP HANA インスタンスから指標を収集できるようにします。
1. エージェントの SAP HANA モニタリング機能を有効にします。
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. エージェントが SAP HANA インスタンスに接続して指標を収集できるようにするには、追加のパラメータを構成する必要があります。
詳細については、SAP HANA モニタリング指標の収集を構成するをご覧ください。
構成ファイルを保存します。
高可用性 SAP ワークロードを実行している場合や、SAP ワークロードの障害復旧（DR）サイトがある場合は、SAP ワークロードを実行している他のすべてのコンピューティングインスタンスに対してこの手順を繰り返します。

オブザーバビリティのエージェント構成の例については、エージェント構成の例をご覧ください。

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

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

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

SAP ワークロードを実行している Compute Engine インスタンスと SSH 接続を確立します。

オブザーバビリティの Google Cloud 設定を確認します。

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)
...

出力に設定に不備があることが示されている場合は、前のセクションで説明した情報を確認して必要なアクションを実行し、status コマンドを再度実行して設定を検証します。
複数のコンピューティングインスタンスを使用してワークロードを実行している場合は、ワークロードを実行している他のすべてのコンピューティングインスタンスに対してこの手順を繰り返します。

エージェント構成の例

次の例は、SAP HANA ワークロードのオブザーバビリティをサポートするように構成された Google Cloudの SAP 用エージェントの完全な構成ファイルです。

次の例では、SAP HANA 認証にセキュアユーザーストア（hdbuserstore）キーを使用します。

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

次の例では、SAP HANA 認証にユーザー名と Secret Manager シークレットを使用します。

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "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": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

次の例では、SAP HANA 認証にユーザー名とパスワードを使用します。この方法ではなく、SAP HANA 認証にはセキュアユーザーストア（hdbuserstore）キーまたは Secret Manager シークレットを使用することをおすすめします。

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "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": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

エージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。

次のステップ

SAP ワークロードのオブザーバビリティの設定が正常に完了してから、そのワークロードが Google Cloud コンソールの Workload Manager の [オブザーバビリティ] ページに表示されるまでに最大 15 分かかることがあります。

SAP ワークロードをモニタリングする方法については、SAP のオブザーバビリティ指標を表示するをご覧ください。

オブザーバビリティを設定するように SAP 用エージェントを構成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

単一ゾーン ワークロードのエージェントを構成する

VM Extension Manager

パッケージ マネージャー

マルチゾーン ワークロードのエージェントを構成する

VM Extension Manager

パッケージ マネージャー

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

エージェント構成の例

次のステップ

オブザーバビリティを設定するように SAP 用エージェントを構成する

単一ゾーンワークロードのエージェントを構成する

パッケージマネージャー

マルチゾーンワークロードのエージェントを構成する

パッケージマネージャー