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 インスタンスにバージョン 3.6（最新） の Google Cloud の SAP 用エージェントをインストールして構成するには、Google Cloud の SAP 用エージェントを Compute Engine VM インスタンスにインストールするをご覧ください。

インストールの概要

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

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

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

Bare Metal Solution サーバーに Google Cloud の SAP 用エージェントをインストールするには、次の操作を行います。

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

ターミナルでオペレーティングシステムに固有のコマンドを実行して、エージェントをインストールします。

（推奨）エージェントのバージョン 3.6（最新）をインストールするには:

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent

SLES15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

特定のバージョンのエージェントをインストールするには:

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

VERSION_NUMBER は、インストールするエージェントのバージョン番号（3.1-606637668 など）に置き換えます。インストール可能なエージェントバージョンについては、使用可能なすべてのエージェントバージョンを一覧取得するをご覧ください。

次の構成ファイルを開きます。
```
/etc/google-cloud-sap-agent/configuration.json
```
別の方法として、コマンドを実行してこの構成を行うこともできます。詳細については、Google Cloud の SAP 用エージェントの構成コマンドをご覧ください。
次のパラメータを変更するか、構成ファイルに追加します。
- 最初のセクション:
  - bare_metal: true に設定します
- cloud_properties セクションを追加し、次のパラメータを指定します。
  - project_id: Google Cloud プロジェクトを指定します
  - instance_name: Bare Metal Solution サーバーの名前を指定します
  - region: Bare Metal Solution サーバーのリージョンを指定します
構成ファイルを保存します。

エージェントを再起動します。

sudo systemctl restart google-cloud-sap-agent

構成パラメータの詳細については、構成パラメータおよび構成例をご覧ください。

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 用エージェントをインストールしたら、必要に応じて、次の構成を行うことでエージェントの他の機能を有効にできます。デフォルトでは、SAP Host Agent の指標と Workload Manager 評価指標の収集が有効になっています。

前提条件

エージェントが Bare Metal Solution 環境から Google Cloud リソースにアクセスできるようにするには、次の前提条件を満たす必要があります。

エージェントが 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 サービスアカウントを設定する必要があります。

エージェントが使用するサービスアカウントに、少なくとも Workload Manager Insights ライター（roles/workloadmanager.insightWriter）ロールが含まれている必要があります。

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

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 Workload Manager > Workload Manager Insights Writer role to the service account.
  
  To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights 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.
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.

サービスアカウントを作成したら、その JSON キーファイルを、エージェントがアクセスできる Bare Metal Solution サーバー上の安全な場所にアップロードしてください。

機能を有効にする

Bare Metal Solution のサービスアカウントを設定して必要なロールを付与したら、次の構成を行うことで、Google Cloud の SAP 用エージェントの他の機能を有効にできます。

デフォルトの構成ファイル

次のスニペットは、Google Cloud の SAP 用エージェントバージョン 3.6（最新）のデフォルト構成の例です。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

機能固有の構成ファイルの例については、その機能の構成ガイドをご覧ください。

構成パラメータ

次の表に、Bare Metal Solution サーバーで実行されている Google Cloud の SAP 用エージェントの構成パラメータ（指標の収集に関連するパラメータを含む）を示します。エージェントの Backint 機能に関連する構成パラメータについては、構成パラメータをご覧ください。

パラメータ
`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_name`	`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（数値）が自動的に検出されます。
`discovery_configuration.enable_workload_discovery`	`Boolean` エージェントがホストで実行されている SAP プロダクトの名前とバージョンを収集できるようにするには、`true` を指定します。デフォルト値は `true` です。詳細については、GoogleCloudPlatform/sapagent の `google-cloud-sap-agent` GitHub リポジトリにあるエージェントのコードベースをご覧ください。
`discovery_configuration.enable_discovery`	`Boolean` エージェントがホストで実行されている SAP プロダクトについて収集した情報を Cloud Logging に送信するには、`true` を指定します。デフォルト値は `true` です。値 `false` を指定すると、エージェントは収集した情報をホストに保存し、Cloud Logging に送信しません。
`collection_configuration.collect_process_metrics`	`Boolean` Process Monitoring 指標の収集を有効にするには、`true` を指定します。デフォルトは `false` です。このパラメータは Linux にのみ適用されます。 SAP HANA のプロセス指標の収集を有効にする場合は、`hana_metrics_config` の下にリストされている追加のパラメータを設定する必要があります。
`collection_configuration.process_metrics_frequency`	`Int` バージョン 2.6 以降では、このパラメータによって急速に変化する Process Monitoring 指標の収集頻度（秒単位）が決定されます。急速に変化する Process Monitoring 指標は、`sap/hana/availability`、`sap/hana/ha/availability`、`sap/nw/availability` です。このパラメータのデフォルト値は `5` 秒です。このデフォルト値を使用することをおすすめします。変化が緩やかな他の Process Monitoring 指標はすべて、デフォルトの 30 秒の頻度で収集されます。変化が緩やかな Process Monitoring 指標の収集頻度を変更するには、`slow_process_metrics_frequency` パラメータを使用します。
`collection_configuration.slow_process_metrics_frequency`	`Int` 変化が緩やかな Process Monitoring 指標の収集頻度を秒単位で指定します。このパラメータのデフォルト値は `30` 秒です。
`collection_configuration.process_metrics_to_skip`	`Array` エージェントで収集しない Process Monitoring 指標を指定します。このパラメータには、Process Monitoring 指標名のカンマ区切り値を指定できます。例: `"process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]`。
`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` キーを指定します。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `hana_db_password` パラメータよりも優先され、これは `hana_db_password_secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`collection_configuration.hana_metrics_config.hana_db_password_secret_name`	`String` エージェントが SAP HANA のクエリに使用するデータベースユーザーアカウントのパスワードを安全に指定するには、データベースユーザーアカウントのセキュリティ認証情報を含むシークレットの名前を指定します。重要: シークレットとホスト VM インスタンスは、同じ Google Cloud プロジェクト内に存在する必要があります。 `hana_db_password_secret_name`、`hdbuserstore_key`、または `hana_db_password` のいずれかを指定した場合にのみ、エージェントが SAP HANA 関連の指標を収集します。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `hana_db_password` パラメータよりも優先され、これは `hana_db_password_secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`collection_configuration.hana_metrics_config.hdbuserstore_key`	`String` SAP HANA システムに安全に接続するには、そのシステム用に作成したセキュアユーザーストア（`hdbuserstore`）鍵を指定します。認証に `hdbuserstore` 鍵を使用するには、次の点に注意してください。 SAP ツール `hdbsql` と `hdbuserstore` が、エージェントをホストする Compute インスタンスにインストールされている。 `hdbuserstore` キーが、特定の 1 つの SAP HANA インスタンスに対応している。複数の SAP HANA インスタンスのホスト名を含む鍵は使用できません。 `SIDadm` ユーザーは、このキーを使用して SAP HANA データベースにクエリを実行できます。ここで、`SID` は `sid` パラメータに指定した値を参照します。これを検証するには、`SIDadm` ユーザーとして次のコマンドを実行します。 hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" この構成パラメータは、エージェントのバージョン 3.3 以降でサポートされています。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `hana_db_password` パラメータよりも優先され、これは `hana_db_password_secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`collection_configuration.hana_metrics_config.sid`	`String` SAP HANA インスタンスの SID を指定します。 `hdbuserstore` キーを使用して SAP HANA の認証を行う場合は、`hdbuserstore_key` セクションをご覧ください。
`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_collection_definition.fetch_latest_config`	`Boolean` 省略可。デフォルト値は `true` です。これにより、エージェントを更新しなくても、エージェントは最新の Workload Manager 評価指標のセットを収集できます。この動作を無効にするには、構成ファイルでこのパラメータを指定し、値を `false` に設定します。
`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`	`String` SAP HANA インスタンスのクエリに使用するユーザーアカウントのパスワードを指定します。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `hana_db_password` パラメータよりも優先され、これは `hana_db_password_secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name`	`String` ユーザーアカウントのパスワードを保存する Secret Manager にシークレットの名前を指定します。または、`hdbuserstore_key` 構成パラメータを指定して、指定した SAP HANA ユーザーを認証することもできます。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `hana_db_password` パラメータよりも優先され、これは `hana_db_password_secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key`	`String` SAP HANA システムに安全に接続するには、そのシステム用に作成したセキュアユーザーストア（`hdbuserstore`）鍵を指定します。認証に `hdbuserstore` 鍵を使用するには、次の点に注意してください。 SAP ツール `hdbsql` と `hdbuserstore` が、エージェントをホストする Compute インスタンスにインストールされている。 `hdbuserstore` キーが、特定の 1 つの SAP HANA インスタンスに対応している。複数の SAP HANA インスタンスのホスト名を含む鍵は使用できません。 `SIDadm` ユーザーは、このキーを使用して SAP HANA データベースにクエリを実行できます。ここで、`SID` は `sid` パラメータに指定した値を参照します。これを検証するには、`SIDadm` ユーザーとして次のコマンドを実行します。 hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" この構成パラメータは、エージェントのバージョン 3.3 以降でサポートされています。 `hdbuserstore_key` を指定する場合、`hostname` パラメータと `port` パラメータを省略できます。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `hana_db_password` パラメータよりも優先され、これは `hana_db_password_secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`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` 秒以下にしてください。
`hana_monitoring_configuration.enabled`	`Boolean` 省略可。Google Cloud の SAP 用エージェントが SAP HANA モニタリング指標を収集できるようにするには、`true` を指定します。デフォルト値は `false` です。次の子パラメータは、`hana_monitoring_configuration.enabled: true` を指定した場合にのみ適用されます。
`hana_monitoring_configuration.sample_interval_sec`	`Int` 省略可。サンプル間隔を秒単位で指定します。これにより、Google Cloud の SAP 用エージェントが SAP HANA インスタンスにクエリを実行して SAP HANA モニタリング指標を収集する頻度を決定します。デフォルト値は 300 秒です。 Google Cloud の SAP 用エージェントの構成ファイルで定義されているクエリごとに、必要な間隔を `sample_interval_sec` パラメータに指定することで、グローバルサンプル間隔を上書きできます。サンプル間隔は 5 秒以上にする必要があります。
`hana_monitoring_configuration.query_timeout_sec`	`Int` 省略可。SAP HANA インスタンスに対して実行する各クエリのタイムアウトを指定します。デフォルト値は 300 秒です。
`hana_monitoring_configuration.execution_threads`	`Int` 省略可。SAP HANA インスタンスにクエリを送信するために使用するスレッド数を指定します。各クエリはそれぞれのスレッドで実行されます。デフォルト値は 10 です。
`hana_monitoring_configuration.hana_instances.name`	`String` SAP HANA インスタンスの名前識別子を指定します。
`hana_monitoring_configuration.hana_instances.sid`	`String` SAP HANA インスタンスの SID を指定します。この文字列は、SAP HANA インスタンスへのクエリの結果から得られるすべての指標にラベルとして追加されます。
`hana_monitoring_configuration.hana_instances.host`	`String` SAP HANA インスタンスをホストするマシン（ローカルまたはリモート）の識別子を指定します。サポートされている値は次のとおりです。ホストがローカルマシンの場合は、文字列 `localhost` または localhost ループバック IP アドレス（`127.0.0.1` など）を指定します。ホストがリモートマシンの場合は、内部 IP アドレスまたは外部 IP アドレスを指定します。
`hana_monitoring_configuration.hana_instances.port`	`String` SAP HANA インスタンスがクエリを受け付けるポートを指定します。最初の、または唯一のテナントデータベースインスタンスの場合、ポートは `3NN15` になります。ここで、`NN` は、SAP HANA インスタンスのインスタンス番号です。
`hana_monitoring_configuration.hana_instances.user`	`String` SAP HANA インスタンスのクエリに使用するユーザーアカウントを指定します。このユーザーに、SAP HANA データベースのモニタリングビューを読み取る権限があることを確認してください。この権限が付与されていないと、モニタリングビューに関連する SAP HANA モニタリング指標にはデータは含まれません。
`hana_monitoring_configuration.hana_instances.password`	`String` 省略可。SAP HANA インスタンスにクエリを行うためのユーザーアカウントを認証するパスワードを書式なしテキストとして指定します。認証には、次のいずれかを指定する必要があります。 `password` パラメータに書式なしテキストのパスワードを指定します。（推奨）Secret Manager を使用してパスワードをシークレットとして保存する場合は、対応するシークレット名を `secret_name` パラメータに指定する必要があります。（推奨）`hdbuserstore_key` パラメータの `hdbuserstore` キー。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `password` パラメータよりも優先され、これは `secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`hana_monitoring_configuration.hana_instances.secret_name`	`String` 省略可。ユーザーアカウントのパスワードを保存する Secret Manager にシークレットの名前を指定します。 SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、`hdbuserstore_key` 構成パラメータは `password` パラメータよりも優先され、これは `secret_name` パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
`hana_monitoring_configuration.hana_instances.hdbuserstore_key`	`String` SAP HANA システムに安全に接続するには、そのシステム用に作成したセキュアユーザーストア（`hdbuserstore`）鍵を指定します。認証に `hdbuserstore` 鍵を使用するには、次の点に注意してください。 SAP ツール `hdbsql` と `hdbuserstore` が、エージェントをホストする Compute インスタンスにインストールされている。 `hdbuserstore` キーが、特定の 1 つの SAP HANA インスタンスに対応している。複数の SAP HANA インスタンスのホスト名を含む鍵は使用できません。 `SIDadm` ユーザーは、このキーを使用して SAP HANA データベースにクエリを実行できます。ここで、`SID` は `sid` パラメータに指定した値を参照します。これを検証するには、`SIDadm` ユーザーとして次のコマンドを実行します。 hdbsql -U `HDB_USERSTORE_KEY` "SELECT * FROM DUMMY" この構成パラメータは、エージェントのバージョン 3.3 以降でサポートされています。 `hdbuserstore_key` を指定する場合、`host` パラメータと `port` パラメータを省略できます。
`hana_monitoring_configuration.hana_instances.enable_ssl`	`Boolean` 省略可。SAP HANA インスタンスで SSL を有効にするかどうかを指定します。デフォルト値は `false` です。
`hana_monitoring_configuration.hana_instances.host_name_in_certificate`	`String` SAP HANA インスタンスに `enable_ssl: true` を指定する場合は、SSL 証明書に設定されているホスト名を指定する必要があります。
`hana_monitoring_configuration.hana_instances.tls_root_ca_file`	`String` SAP HANA インスタンスに `enable_ssl: true` を指定する場合は、セキュリティ証明書のパスを指定する必要があります。
`hana_monitoring_configuration.queries.enabled`	`Boolean` 省略可。すべての SAP HANA インスタンスに対して SQL クエリを有効にするには、その SQL クエリの `enabled` パラメータに値 `true` を指定します。
`hana_monitoring_configuration.queries.name`	`String` 構成ファイルでカスタムクエリを定義している場合は、カスタムクエリごとに一意の名前を指定する必要があります。クエリ名は、Monitoring で指標のデフォルト URL を構築するために使用されるため、一意であることが必要です。
`hana_monitoring_configuration.queries.sql`	`String` エージェントが SAP HANA インスタンスに発行する SQL ステートメントを指定します。 SQL ステートメントは、SAP HANA SQL と System Views Reference で SAP が定義している SQL 構文に準拠している必要があります。
`hana_monitoring_configuration.queries.sample_interval_sec`	`Int` 省略可。SQL クエリのサンプル間隔を指定します。これはグローバルサンプル間隔をオーバーライドします。値は 5 秒以上にする必要があります。
`hana_monitoring_configuration.queries.columns.name`	`String` 各列を一意に識別する名前を指定します。列名は、Monitoring で指標のデフォルト URL を構築する際に使用されるため、一意であることが必要です。
`hana_monitoring_configuration.queries.columns.metric_type`	`String` Monitoring で処理する場合は、`METRIC_LABEL`、`METRIC_GAUGE`、または `METRIC_CUMULATIVE` のいずれかの指標タイプを指定します。 `METRIC_LABEL` タイプの指標は、Monitoring に送信されるすべての `METRIC_GAUGE` 指標と `METRIC_CUMULATIVE` 指標にラベルとして追加されます。
`hana_monitoring_configuration.queries.columns.value_type`	`String` Monitoring で処理する場合は、指標タイプでサポートされているデータ型を指定します。サポートされているデータ型は、`VALUE_BOOL`、`VALUE_INT64`、`VALUE_STRING`、または `VALUE_DOUBLE` です。詳細については、サポートされている組み合わせをご覧ください。
`hana_monitoring_configuration.queries.columns.name_override`	`String` 省略可。Monitoring で処理する場合は、クエリ名と列名の代わりに、指標 URL に表示するパスを指定します。例: 指標のデフォルトの URL: `workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME` カスタムパスを使用している指標の URL: `workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH`

トラブルシューティング

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

サポートを利用する

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

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

インストールの概要

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

RHEL

SLES15

SLES 12

RHEL

SLES15

SLES 12

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

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

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

前提条件

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

機能を有効にする

デフォルトの構成ファイル

構成パラメータ

トラブルシューティング

サポートを利用する

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