バージョン 1: Google Cloud の SAP 用エージェントを Bare Metal Solution サーバーにインストールして構成する

Bare Metal Solution サーバーで実行されている SAP システムの SAP サポートには、Google Cloud の SAP 用エージェントが必要です。

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

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

Bare Metal Solution サーバーで SAP の実行に使用できるオペレーティングシステムについては、以下をご覧ください。

SAP HANA の場合は、認定されたオペレーティングシステムをご覧ください。
SAP NetWeaver の場合は、認定されたオペレーティングシステムをご覧ください。

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

インストールの概要

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

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

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

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

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

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

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

Bare Metal Solution サーバーと SSH 接続を確立します。

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

systemctl status google-cloud-sap-agent

エージェントが正常に機能している場合、出力には active (running) が含まれます。例:

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

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

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

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

SAP システムで、トランザクションとして「ST06」を入力します。
概要ウィンドウで可用性と以下のフィールドの内容を確認し、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 指標のみの収集が有効になっています。

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

Workload Manager 評価指標と Process Monitoring 指標の収集を有効にする場合は、次の前提条件を満たす必要があります。

エージェントが Google Cloud リソースにアクセスするための IAM サービスアカウントを作成します。サービスアカウントに必要な IAM ロールを付与します。詳細については、サービスアカウントを設定するをご覧ください。
Bare Metal Solution サーバーに gcloud CLI をインストールします。詳細については、gcloud CLI をインストールするをご覧ください。
Google Cloud にアクセスするには、gcloud CLI を承認します。詳細については、gcloud CLI を承認するをご覧ください。
Google Cloud APIs への接続を確立します。詳細については、オンプレミスホスト用の限定公開の Google アクセスの構成をご覧ください。

サービスアカウントを設定する

エージェントが Bare Metal Solution 環境から Google Cloud リソースにアクセスできるようにするには、IAM サービスアカウントを設定する必要があります。

エージェントが使用するサービスアカウントには、少なくともモニタリング指標の書き込み（roles/monitoring.metricWriter）ロールが含まれている必要があります。

サービスアカウントを作成するには、次の操作を行います。

Create a service account:
1. In the Google Cloud console, go to the Create service account page.
  Go to Create service account
2. Select your project.
3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
  
  In the Service account description field, enter a description. For example, Service account for quickstart.
4. Click Create and continue.
5. Grant the Monitoring > Monitoring Metric Writer role to the service account.
  
  To grant the role, find the Select a role list, then select Monitoring > Monitoring Metric Writer.
  
  Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
6. Click Continue.
7. Click Done to finish creating the service account.
  
  Do not close your browser window. You will use it in the next step.
Create a service account key:
1. In the Google Cloud console, click the email address for the service account that you created.
2. Click Keys.
3. Click Add key, and then click Create new key.
4. Click Create. A JSON key file is downloaded to your computer.
5. Click Close.

エージェントがアクセスできる Bare Metal Solution サーバーの安全な場所に JSON キーファイルをアップロードします。

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

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

Bare Metal Solution サーバーと SSH 接続を確立します。

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

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

collection_configuration セクションで、次のパラメータを true に設定します。
- collect_process_metrics: エージェントによる Process Monitoring 指標の収集を可能にします。SAP HANA データベースの指標を収集するために SAP HANA データベースにアクセスしてクエリを実行するには、hana_metrics_config セクションで追加のパラメータを設定する必要があります。
- collect_workload_validation_metrics: エージェントによる Workload Manager 評価指標の収集を可能にします。
パラメータの詳細については、次の表をご覧ください。
構成ファイルを保存します。
エージェントを再起動して、新しい設定を有効にします。
```
sudo systemctl restart google-cloud-sap-agent
```

構成パラメータ

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

パラメータ
`provide_sap_host_agent_metrics`	`Boolean` SAP Host Agent に必要な指標の収集を有効にするには、`true` を指定します。デフォルトは `true` です。 Cloud カスタマーケアまたは SAP サポートから指示されない限り、`provide_sap_host_agent_metrics` を `false` に設定しないでください。
`bare_metal`	`Boolean` エージェントが Bare Metal Solution サーバーにインストールされている場合は、`true` を指定します。デフォルトは `false` です。
`log_level`	`String` エージェントのロギングレベルを設定するには、必要な値を設定します。使用可能なログレベルは次のとおりです。 `DEBUG` `INFO` `WARNING` `ERROR` デフォルトは `INFO` です。Cloud カスタマーケアから指示されない限り、ロギングレベルを変更しないでください。
`log_to_cloud`	`Boolean` エージェントのログを Cloud Logging にリダイレクトするには、`true` を指定します。デフォルトは `true` です。
`cloud_properties.project_id`	`String` SAP システムが Bare Metal Solution サーバーで実行されている場合は、Bare Metal Solution で使用する Google Cloud プロジェクトのプロジェクト ID を指定します。エージェントが VM インスタンスで実行されている場合、デフォルトでは、プロジェクト ID が自動的に検出されます。
`cloud_properties.instance_id`	`String` エージェントをインストールした Bare Metal Solution サーバーの名前を指定します。
`cloud_properties.region`	`String` SAP システムが Bare Metal Solution サーバーで実行されている場合は、Bare Metal Solution サーバーのリージョンを指定します。エージェントが VM インスタンスで実行されている場合、デフォルトでは、エージェントがインストールされている VM インスタンスのリージョンが使用されます。
`cloud_properties.zone`	`String` エージェントが VM インスタンスで実行されている場合、デフォルトでは、エージェントがインストールされている VM インスタンスのゾーンが使用されます。
`cloud_properties.image`	`String` インスタンスの OS イメージ名を指定します。エージェントが VM インスタンスで実行されている場合、デフォルトでは、エージェントがインストールされている VM インスタンスの OS イメージが検出されます。
`cloud_properties.numeric_project_id`	`String` SAP システムが実行されている Google Cloud プロジェクトの数値 ID を指定します。エージェントが VM インスタンスで実行されている場合、デフォルトでは、プロジェクト ID（数値）が自動的に検出されます。
`collection_configuration.collect_process_metrics`	`Boolean` Process Monitoring 指標の収集を有効にするには、`true` を指定します。デフォルトは `false` です。このパラメータは Linux にのみ適用されます。 SAP HANA のプロセス指標の収集を有効にする場合は、`hana_metrics_config` の下にリストされている追加のパラメータを設定する必要があります。
`collection_configuration.process_metrics_frequency`	`Int` Process Monitoring 指標の収集頻度（秒単位）を指定します。このパラメータのデフォルト値は `5` 秒です。プロセスモニタリング指標の収集頻度は更新できますが、デフォルト値を使用することをおすすめします。デフォルト値を変更する必要がある場合は、`collection_configuration` セクションに `process_metrics_frequency` パラメータを追加して必要な値を指定します。
`collection_configuration.hana_metrics_config.hana_db_user`	`String` エージェントが SAP HANA のクエリに使用するデータベースユーザーアカウントを指定します。デフォルトは `SYSTEM` です。
`collection_configuration.hana_metrics_config.hana_db_password`	`String` エージェントが SAP HANA のクエリに使用するデータベースユーザーアカウントのパスワード（書式なしテキスト）を指定します。書式なしテキストパスワードを指定する代わりに、次のいずれかのオプションを使用することをおすすめします。 `hana_db_password_secret_name`。Secret Manager に保存されているシークレットを指定します。 `hdbuserstore_key`。`hdbuserstore` キーを指定します。
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` エージェントが SAP HANA のクエリに使用するデータベースユーザーアカウントのパスワードを安全に指定するには、データベースユーザーアカウントのセキュリティ認証情報を含むシークレットの名前を指定します。重要: Secret とホスト VM インスタンスは、同じ Google Cloud プロジェクト内に存在する必要があります。 `hana_db_password_secret_name`、`hdbuserstore_key`、または `hana_db_password` のいずれかを指定した場合にのみ、エージェントが SAP HANA 関連の指標を収集します。
`collection_configuration.hana_metrics_config.hdbuserstore_key`	`String` `hana_db_user` に指定した SAP HANA ユーザーを認証するには、そのユーザー用に作成した `hdbuserstore` キーを指定します。認証に `hdbuserstore` キーを使用するには、次の条件を満たす必要があります。 SAP ツール `hdbsql` と `hdduserstore` が、エージェントをホストする Compute インスタンスにインストールされている。 `hdbuserstore` キーが、特定の 1 つの SAP HANA インスタンスに対応している。複数の SAP HANA インスタンスのホスト名を含む鍵は使用できません。
`collection_configuration.hana_metrics_config.sid`	`String` SAP HANA インスタンスの SID を指定します。
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Workload Manager 評価指標の収集を有効にするには、`true` を指定します。バージョン 3.2 以降、デフォルト値は `true` です。このパラメータは Linux にのみ適用されます。
`collection_configuration.workload_validation_metrics_frequency`	`Int` Workload Manager 評価指標の収集頻度（秒）。デフォルト値は `300` 秒です。デフォルトの収集頻度は、機能全体に影響する可能性があるため、変更しないことをおすすめします。 Workload Manager 指標の収集頻度を変更する必要がある場合は、`collection_configuration` セクションに `workload_validation_metrics_frequency` パラメータを追加して必要な値を指定します。
`collection_configuration.workload_validation_db_metrics_config.hana_db_user`	`String` SAP HANA インスタンスのクエリに使用するユーザーアカウントを指定します。ユーザーアカウントには、SAP HANA データベースに対する読み取り権限が必要です。
`collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name`	`String` ユーザーアカウントのパスワードを保存する Secret Manager に Secret の名前を指定します。または、`hdbuserstore_key` 構成パラメータを指定して、指定した SAP HANA ユーザーを認証することもできます。
`collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key`	`String` `hana_db_user` に指定した SAP HANA ユーザーを認証するには、そのユーザー用に作成した `hdbuserstore` キーを指定します。認証に `hdbuserstore` キーを使用するには、次の条件を満たす必要があります。 SAP ツール `hdbsql` と `hdduserstore` が、エージェントをホストする Compute インスタンスにインストールされている。 `hdbuserstore` キーが、特定の 1 つの SAP HANA インスタンスに対応している。複数の SAP HANA インスタンスのホスト名を含む鍵は使用できません。 `hdbuserstore_key` を指定する場合、`hostname` パラメータと `port` パラメータを省略できます。
`collection_configuration.workload_validation_db_metrics_config.sid`	`String` SAP HANA インスタンスの SID を指定します。
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` SAP HANA インスタンスをホストするマシン（ローカルまたはリモート）の識別子を指定します。サポートされている値は次のとおりです。ホストがローカルマシンの場合は、文字列 `localhost` または localhost ループバック IP アドレス（`127.0.0.1` など）を指定します。ホストがリモートマシンの場合は、内部 IP アドレスまたは外部 IP アドレスを指定します。
`collection_configuration.workload_validation_db_metrics_config.port`	`String` SAP HANA インスタンスがクエリを受け付けるポートを指定します。最初の、または唯一のテナントデータベースインスタンスの場合、ポートは `3NN15` になります。ここで、`NN` は、SAP HANA インスタンスのインスタンス番号です。
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` Workload Manager の評価に関する SAP HANA データベース指標の収集頻度（秒）。デフォルトは `3600` 秒です。 SAP HANA データベースの指標の収集頻度は更新できますが、デフォルト値を使用することをおすすめします。デフォルト値を変更する必要がある場合は、`collection_configuration` セクションに `workload_validation_db_metrics_frequency` パラメータを追加して必要な値を指定します。収集頻度は `3600` 秒以下にしてください。

デフォルト構成

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

構成の例

Bare Metal Solution サーバーにエージェントをインストールする場合は、必要なパラメータを構成ファイルに追加する必要があります。以下は、エージェントを Bare Metal Solution サーバーにインストールするための完全な構成ファイルを示しています。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "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"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

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

エージェントが収集する 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 です。

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

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

Google Cloud コンソール

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

[Monitoring] に移動
Monitoring のナビゲーションパネルで、[ダッシュボード] をクリックします。
[サンプルライブラリ] タブをクリックします。
エージェント固有のカスタムダッシュボードをフィルタするには、[フィルタ] フィールドに「Agent for SAP」と入力します。
（省略可）ダッシュボードの詳細を表示するか、コンテンツをプレビューするには、[プレビュー] をクリックします。
インストールするダッシュボードを選択します。
[インポート]、[確認] の順にクリックします。

ダッシュボードが Google Cloud プロジェクトで使用可能なダッシュボードに追加されます。ダッシュボードを表示するには、インストールされているダッシュボードを表示するの手順に沿って操作します。

Google Cloud CLI

Cloud Shell を開きます。

Cloud Shell を開く
Cloud Shell で、リポジトリのクローンを作成するか、リポジトリをダウンロードします。
```
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/
```
Cloud Shell で、対応する JSON ファイルを使用して必要なダッシュボードをインストールします。
```
gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE
```
CONFIG_FROM_FILE は、ダッシュボード構成を含む JSON ファイルのパスに置き換えます。ダッシュボード構成ファイルはパス monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap にあります。

ダッシュボードが Google Cloud プロジェクトで使用可能なダッシュボードに追加されます。ダッシュボードを表示するには、インストールされているダッシュボードを表示するの手順に沿って操作します。

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

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

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

[Monitoring] に移動
Monitoring のナビゲーションパネルで、[ダッシュボード] をクリックします。
リスト内のダッシュボード名をクリックします。

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

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

Monitoring に SAP HANA 指標のカスタムダッシュボードが表示されているスクリーンキャプチャ。

トラブルシューティング

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

サポートを利用する

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