バージョン 1: Google Cloud の SAP 用エージェントを Compute Engine インスタンスにインストールして構成する

Google Cloudの SAP 用エージェントは、SAP NetWeaver、SAP HANA、SAP ASE、SAP MaxDB など、 Google Cloud上で実行される SAP システムの SAP サポートに必要です。

SAP Host Agent の指標の場合、Compute Engine インスタンスに Google Cloudの SAP 用エージェントをインストールすると、Cloud Monitoring と Compute Engine API のモニタリング データが結合され、そのデータが SAP Host Agent に提供されます。

Google Cloudが提供する次の「SAP 用」RHEL または SLES OS イメージを使用する場合、 Google Cloudの SAP 用エージェントは OS イメージに含まれています。

• RHEL: すべての「SAP 用」イメージ
• SLES: SAP 用 SLES 15 SP4 以降のバージョン

Google Cloudの SAP 用エージェントでサポートされているオペレーティング システムについては、サポートされているオペレーティング システムをご覧ください。

Bare Metal Solution サーバーに Google Cloudの SAP 用エージェント バージョン 1 をインストールして構成するには、Bare Metal Solution サーバーに Google Cloudの SAP 用エージェントをインストールするをご覧ください。

インストールの概要

Linux の場合は、標準のオペレーティング システム パッケージ管理コマンド（RHEL の場合は yum コマンド、SLES の場合は zypper コマンド）を使用して、 Google Cloudの SAP 用エージェントをインストールします。パッケージ管理コマンドは次のタスクを実行します。

• Google Cloudの SAP 用エージェントをダウンロードします。
• エージェントを google-cloud-sap-agent という名前の Linux systemd サービスとして作成します。
• サービス google-cloud-sap-agent を有効にして開始します。

Windows の場合は、GooGet パッケージ管理コマンド googet を使用して、 Google Cloudの SAP 用エージェントをインストールします。パッケージ管理コマンドは次のタスクを実行します。

• Google Cloudの SAP 用エージェントをダウンロードします。

• google-cloud-sap-agent という名前の Windows サービスと、毎分実行されるスケジュール設定されたタスクを作成して、サービスがまだ稼働中かどうかを確認し、必要に応じて再起動します。

エージェントの前提条件

Google Cloudの SAP 用エージェントをインストールする前に、次の前提条件を満たしていることを確認する必要があります。

必要な IAM ロールを設定する

Google Cloudの SAP 用エージェントが使用するサービス アカウントには、少なくとも Compute 閲覧者（roles/compute.viewer）、モニタリング閲覧者（roles/monitoring.viewer）、Workload Manager Insights ライター（roles/workloadmanager.insightWriter）のロールを含める必要があります。

サービス アカウントに必要なロールを追加する手順は次のとおりです。

1. Google Cloud コンソールで、[IAM] ページに移動します。

   [IAM] に移動

2. Google Cloud プロジェクトを選択します。

3. ロールを追加するサービス アカウントを特定します。

   • サービス アカウントがまだプリンシパル リストに含まれていない場合、サービス アカウントには何もロールが割り当てられていません。[追加] をクリックし、サービス アカウントのメールアドレスを入力します。
   • このサービス アカウントがすでにプリンシパル リストに含まれている場合、サービス アカウントには既存のロールがあります。編集するサービス アカウントの [編集] ボタンをクリックします。

4. 使用可能なロールのリストから必要なロールを選択します。

   • Compute Engine > Compute 閲覧者
   • Monitoring > モニタリング閲覧者
   • Workload Manager > Workload Manager Insights ライター

5. [追加] または [保存] をクリックして、サービス アカウントにロールを適用します。

Google Cloud APIs へのアクセスを有効にする

Compute Engine では、すべての Cloud APIs にすべてのアクセス スコープを使用できるようにコンピューティング インスタンスを構成し、インスタンス サービス アカウントの IAM 権限のみを使用して Google Cloud リソースへのアクセスを制御することをおすすめします。詳細については、ユーザー管理のサービス アカウントを使用する VM を作成するをご覧ください。

Cloud APIs へのアクセスを制限する場合、 Google Cloudの SAP 用エージェントには、ホスト Compute Engine インスタンスで次の最小 Cloud API アクセス スコープが必要です。

• Cloud Platform: 有効
• Compute Engine: 読み取り専用
• Stackdriver Monitoring API: 読み取り専用

外部 IP アドレスを持たないコンピューティング インスタンスで SAP アプリケーションを実行している場合は、コンピューティング インスタンスのサブネットでプライベート Google アクセスを有効にして、 Google Cloudの SAP 用エージェントが Google API とサービスにアクセスできるようにする必要があります。サブネットでプライベート Google アクセスを有効にするには、プライベート Google アクセスの構成をご覧ください。

エージェントをインストールする

より多くの機能をサポートする Google Cloudの SAP 用エージェントの最新バージョンをインストールすることをおすすめします。手順については、 Google Cloudの SAP 用エージェントを Compute Engine インスタンスにインストールして構成するをご覧ください。

Google Cloudの SAP 用エージェント バージョン 1 をインストールする場合は、Cloud カスタマーケアにお問い合わせください。

Google Cloudの SAP 用エージェントと SAP Host Agent をインストールしたら、エージェントのインストールを検証するの説明に従って、 Google Cloudの SAP 用エージェントのインストールを検証します。

エージェントのインストールを検証する

エージェントが実行されていることを確認するには、ご使用のオペレーティング システムに合わせて次の操作を行います。

エージェントが実行されていない場合は、エージェントを再起動します。

SAP Host Agent が指標を受信していることを確認する

Google Cloudの SAP 用エージェントによってインフラストラクチャの指標が収集され、SAP Host Agent に正しく送信されていることを確認するには、次の操作を行います。

1. SAP システムで、トランザクションとして「ST06」を入力します。

2. 概要ウィンドウで可用性と以下のフィールドの内容を確認し、SAP と Google モニタリング インフラストラクチャのエンドツーエンドの設定が正しいか調べます。

   • クラウド プロバイダ: Google Cloud Platform
   • Enhanced Monitoring Access: TRUE
   • Enhanced Monitoring Details: ACTIVE

Linux で Google Cloudの SAP 用エージェントを構成する

Google Cloudの SAP 用エージェントをインストールしたら、必要に応じてエージェントを構成し、Process Monitoring 指標と Workload Manager 評価指標の収集を有効にできます。デフォルトでは、SAP Host Agent 指標のみの収集が有効になっています。

Process Monitoring 指標と Workload Manager 評価指標の収集は Linux でのみサポートされています。

Process Monitoring 指標と Workload Manager 評価指標の収集を有効にする場合は、ホスト コンピューティング インスタンスのサービス アカウントに IAM モニタリング指標書き込み（roles/monitoring.metricWriter）ロールを付与する必要があります。

Secret Manager を使用して SAP HANA データベース パスワードを保存する場合は、ホスト コンピューティング インスタンスのサービス アカウントに IAM Secret Manager のシークレット アクセサー（roles/secretmanager.secretAccessor）ロールがあることを確認します。

ホスト コンピューティング インスタンスのアクセス スコープには、 Google Cloud プロジェクトに指標データを公開するための書き込みアクセス権が必要です。新しい Compute Engine コンピューティング インスタンスを作成すると、書き込みアクセス スコープ https://www.googleapis.com/auth/monitoring.write が自動的に構成されます。

必要な IAM ロールを設定する

サービス アカウントに必要なロールを追加する手順は次のとおりです。

1. Google Cloud コンソールで、[IAM] ページに移動します。

   [IAM] に移動

2. Google Cloud プロジェクトを選択します。

3. ロールを追加するサービス アカウントを特定します。

   • サービス アカウントがまだプリンシパル リストに含まれていない場合、サービス アカウントには何もロールが割り当てられていません。[追加] をクリックし、サービス アカウントのメールアドレスを入力します。
   • このサービス アカウントがすでにプリンシパル リストに含まれている場合、サービス アカウントには既存のロールがあります。編集するサービス アカウントの [編集] ボタンをクリックします。

4. 使用可能なロールのリストから必要なロールを選択します。

   • [Monitoring] > [モニタリング指標の書き込み]
   • [Secret Manager] > [Secret Manager のシークレット アクセサー]

5. [追加] または [保存] をクリックして、サービス アカウントにロールを適用します。

Process Monitoring 指標と Workload Manager 評価指標の収集を有効にする

Process Monitoring 指標と Workload Manager 評価指標の収集を有効にするには、次の操作を行います。

1. ホスト コンピューティング インスタンスと SSH 接続を確立します。

2. 次の構成ファイルを開きます。

   /etc/google-cloud-sap-agent/configuration.json

3. collection_configuration セクションで、次のパラメータを true に設定します。

   • collect_process_metrics: エージェントによる Process Monitoring 指標の収集を可能にします。SAP HANA データベースの指標を収集するために SAP HANA データベースにアクセスしてクエリを実行するには、hana_metrics_config セクションで追加のパラメータを設定する必要があります。
   • collect_workload_validation_metrics: エージェントによる Workload Manager 評価指標の収集を可能にします。

   パラメータの詳細については、次の表をご覧ください。

4. 必要に応じて、cloud_properties で自動的に設定されたパラメータ値を更新できます。これを行うには、構成ファイルに cloud_properties セクションを追加した後、必要なパラメータとその値を指定します。

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

6. 新しい設定を有効にするには、エージェントを再起動します。

   sudo systemctl restart google-cloud-sap-agent

構成パラメータ

次の表に、 Google Cloudの SAP 用エージェント バージョン 1 の構成パラメータを示します。

デフォルト構成

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

構成の例

Compute Engine インスタンスにエージェントをインストールする場合、すべての構成パラメータと値は省略可能です。構成ファイルが変更されていない場合は、デフォルトの構成が使用されます。以下は、コンピューティング インスタンスにエージェントをインストールするための完成した構成ファイルの例です。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
      }
    }
}

収集された指標を表示する

エージェントが収集する Process Monitoring 指標を可視化するには、Google Cloud が提供する次のカスタム ダッシュボードを使用します。

• SAP 用エージェント - HANA の概要: このダッシュボードは、SAP HANA の可用性、SAP HANA HA の可用性、SAP HANA HA レプリケーション、SAP HANA サービス ステータス、HA クラスタ - ノードの状態、HA クラスタ - SAP インスタンスのリソース状態の指標のステータスの概要を表示するグラフを提供します。

  このダッシュボードの JSON ファイルは sap-agent-status-overview.json です。

• SAP 用エージェント - HANA の元の指標: このダッシュボードは、SAP HANA の可用性、SAP HANA HA の可用性、SAP HANA HA レプリケーション、SAP HANA サービス ステータス、HA クラスタ - ノードの状態、HA クラスタ - SAP インスタンスのリソース状態の指標の生の指標値を表示するグラフを提供します。

  このダッシュボードの JSON ファイルは sap-agent-raw-metrics.json です。

ダッシュボードをインストールする

カスタム ダッシュボードをインストールするには、次の手順を完了します。

インストールされているダッシュボードを表示する

インストールされているダッシュボードを表示するには、次の操作を行います。

1. Google Cloud コンソールで、[モニタリング] ページに移動します。

   [モニタリング] に移動

2. Monitoring のナビゲーション パネルで、[ダッシュボード] をクリックします。

3. リスト内のダッシュボード名をクリックします。

ダッシュボードの数が多い場合は、カスタム ダッシュボードや新しいダッシュボードの名前でフィルタできます。このリストをフィルタする方法については、カスタム ダッシュボードを表示するをご覧ください。

次の図は、Monitoring の SAP HANA 指標のカスタム ダッシュボードの一部を示す例です。

トラブルシューティング

Google Cloudの SAP 用エージェントをインストールして構成するときに発生する可能性のある問題の診断と解決については、Google Cloudの SAP 用エージェントのトラブルシューティング ガイドをご覧ください。

サポートを利用する

Google Cloudの SAP 用エージェントの問題を解決するには、利用可能なすべての診断情報を収集し、Cloud カスタマーケアにお問い合わせください。カスタマーケアへのお問い合わせ方法については、 Google Cloudでの SAP に関するサポートを利用するをご覧ください。