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

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

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

始める前に

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

    エージェントのインストールを検証する方法については、 エージェントのインストールを検証するをご覧ください。

  • SAP オブザーバビリティの 前提条件を満たしていることを確認します。

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

VM Extension Manager

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

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

  1. VM Extension Manager を設定します。

  2. SAP ワークロードを実行するコンピューティング インスタンスに Google Cloud's SAP 用エージェントをインストールして管理する VM 拡張機能ポリシーを作成します。

パッケージ マネージャー

VM Extension Manager を使用する代わりにエージェントのライフサイクルを手動で管理する場合は、パッケージ マネージャーを使用して Google Cloud's の SAP 用エージェントを構成できます。

  1. SAP ワークロードを実行するコンピューティング インスタンスとの SSH 接続を確立します。

  2. の SAP 用エージェントの最新バージョンを実行していることを確認します。

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

  3. エージェントが SAP ワークロードの詳細をルックアップしてワークロード マネージャーに送信できるようにするには:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable
    
  4. エージェントが SAP ワークロードで実行されているプロセスから指標を収集できるようにします。

    1. エージェントのプロセス モニタリング機能を有効にします。
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    
    1. エージェントが SAP HANA データベース インスタンスに関連するプロセス指標を収集できるようにするには、hana_metrics_config セクションで追加のパラメータを構成する必要があります。

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

  5. エージェントが SAP ワークロードで実行されている SAP HANA インスタンスから指標を収集できるようにします。

    1. エージェントの SAP HANA モニタリング機能を有効にします。
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    
    1. エージェントが SAP HANA インスタンスに接続して指標を収集できるようにするには、追加のパラメータを構成する必要があります。

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

  6. 構成ファイルを保存します。

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

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

VM Extension Manager

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

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

  1. VM Extension Manager を設定します。

  2. SAP ワークロードのプライマリ サイトを実行するコンピューティング インスタンスに Google Cloudの SAP 用エージェントをインストールして管理する VM 拡張機能ポリシーを作成します。

    • SAP ワークロードのプライマリ サイトが実行されているゾーンに VM 拡張機能ポリシーを作成します。このような VM 拡張機能ポリシーを作成する方法については、 ゾーン VM 拡張機能ポリシーを作成するをご覧ください。
    • オブザーバビリティのエージェント構成の例については、 エージェント構成の例をご覧ください。
  3. 高可用性 SAP ワークロードを実行している場合、または SAP ワークロードの障害復旧(DR)サイトがある場合は、SAP ワークロードのセカンダリ サイトまたは DR サイトを実行するコンピューティング インスタンスに の SAP 用エージェントをインストールして管理する VM 拡張機能ポリシーを 作成します。 Google Cloud

パッケージ マネージャー

VM Extension Manager を使用する代わりにエージェントのライフサイクルを手動で管理する場合は、パッケージ マネージャーを使用して Google Cloud's の SAP 用エージェントを構成できます。

  1. SAP ワークロードを実行するコンピューティング インスタンスとの SSH 接続を確立します。

  2. の SAP 用エージェントの最新バージョンを実行していることを確認します。

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

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

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable
    
  4. エージェントが SAP ワークロードで実行されているプロセスから指標を収集できるようにします。

    1. エージェントのプロセス モニタリング機能を有効にします。
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    
    1. エージェントが SAP HANA データベース インスタンスに関連するプロセス指標を収集できるようにするには、hana_metrics_config セクションで追加のパラメータを構成する必要があります。

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

  5. エージェントが SAP ワークロードで実行されている SAP HANA インスタンスから指標を収集できるようにします。

    1. エージェントの SAP HANA モニタリング機能を有効にします。
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    
    1. エージェントが SAP HANA インスタンスに接続して指標を収集できるようにするには、追加のパラメータを構成する必要があります。

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

  6. 構成ファイルを保存します。

  7. 高可用性 SAP ワークロードを実行している場合、または SAP ワークロードのディザスタ リカバリ(DR)サイトがある場合は、SAP ワークロードを実行している他のすべてのコンピューティング インスタンスに対してこの手順を繰り返します。

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

ワークロード マネージャー オブザーバビリティの設定を検証する

Workload Manager オブザーバビリティ サービスを使用するために、 が正しく Google Cloud 設定されているかどうか確認するには、エージェントの status コマンドを実行します。

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

  1. SAP ワークロードを実行している Compute Engine インスタンスと SSH 接続を確立します。
  2. オブザーバビリティの Google Cloud 設定を確認します。

    sudo /usr/bin/google_cloud_sap_agent status
    

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

    Agent Status:
        Installed version: 3.13-....
        ...
        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 コマンドを再度実行して設定を検証します。

  4. 複数のコンピューティング インスタンスを使用してワークロードを実行している場合は、ワークロードを実行している他のすべてのコンピューティング インスタンスに対してこの手順を繰り返します。

エージェント構成の例

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

次の例では、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 のオブザーバビリティ指標を表示するをご覧ください。