SAP ワークロードのパフォーマンスに関する診断情報を収集する

このガイドでは、Google Cloud の SAP 用エージェントバージョン 3.4 以降を使用して、SAP ワークロードのパフォーマンス診断情報を収集する方法について説明します。

SAP ワークロードのパフォーマンスの問題のトラブルシューティングについて Cloud カスタマーケアにお問い合わせになる場合は、ワークロードに関連する診断情報を共有する必要があります。エージェントの組み込みのパフォーマンス診断ツールを使用すると、必要な診断情報の収集を自動化できます。これにより、トラブルシューティングと解決を迅速化できます。

エージェントが SAP ワークロードに対して実行できるパフォーマンス診断については、ワークロードのパフォーマンス診断をご覧ください。

始める前に

Google Cloud の SAP 用エージェントのバージョン 3.4 以降を使用していることを確認します。

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

パフォーマンス診断情報を収集する

SAP ワークロードのパフォーマンス診断情報を収集するには、performancediagnostics コマンドを使用してエージェントのツールを呼び出します。

sudo /usr/bin/google_cloud_sap_agent performancediagnostics \
    --type="COMMA_SEPARATED_DIAGNOSTIC_TYPES" \
    --test-bucket=STORAGE_BUCKET_NAME \
    --backint-config-file=BACKINT_CONFIG_FILE_PATH \
    --output-file-name=OUTPUT_FILE_NAME \
    --output-file-path=OUTPUT_FILE_PATH

次のように置き換えます。

COMMA_SEPARATED_DIAGNOSTIC_TYPES: 実行する診断タイプ。
STORAGE_BUCKET_NAME: backup 診断を実行するために、ツールで使用する必要がある Cloud Storage の名前。
BACKINT_CONFIG_FILE_PATH: 必要な Backint 構成ファイルのパス。
OUTPUT_FILE_NAME: SAP ワークロードに関する診断情報を含む出力 ZIP ファイルの名前
OUTPUT_FILE_PATH: パフォーマンス診断ツールで出力 ZIP ファイルを保存するディレクトリのパス。指定されたパスが存在しない場合は作成されます。

このコマンドでサポートされているパラメータについては、サポートされているパラメータをご覧ください。

サポートされるパラメータ

次の表に、performancediagnostics コマンドで使用できる引数を示します。

パラメータ	説明
`type`	`STRING` 実行する診断タイプのカンマ区切りリストを指定します。サポートされている診断タイプは次のとおりです。 `backup`: SAP HANA ワークロードに対して、Backint 機能のセルフ診断と `gsutil perfdiag` 診断を実行します。 `IO`: 入力 / 出力診断を実行します。これは、フレキシブル I/O テスター（FIO）を使用して行われます。これにより、ワークロードのストレージシステムの I/O 機能に対するストレステストが実行されます。また、ワークロードシミュレーションを実行して、ディスクやネットワークファイルシステムなどのワークロードのインフラストラクチャのパフォーマンスを評価します。 `all`: ツールでサポートされているすべてのオンデマンド診断とデフォルト診断を実行します。 `IO` 診断または `all` 診断を実行する場合は、コンピューティングインスタンスに FIO ツールがインストールされていることを確認する必要があります。このツールは、RHEL で `sudo yum install fio` を実行し、SLES で `sudo zypper install fio` を実行することでインストールできます。サポートされている診断の詳細については、ワークロードのパフォーマンス診断をご覧ください。
`backint-config-file`	`String` `backup` 診断を実行する場合は、Backint 構成ファイルのパスを指定します。例: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS.json`。 `backup` 診断を実行するには、`backint-config-file` または `test-bucket` のいずれかのパラメータを 1 つ以上指定する必要があります。データ、ログ、カタログのバックアップに対し個別の構成ファイルを使用している場合は、診断情報を収集するバックアップタイプに対応するパスを指定します。
`test-bucket`	`String` `backup` 診断を実行する場合は、Cloud Storage との間でのファイルのアップロードとダウンロードのテストにツールが使用する Cloud Storage バケットの名前を指定します。例: `mybucket`。テストに使用するバケットに保持ポリシーが設定されていないことを確認します。 `backup` 診断を実行するには、`backint-config-file` または `test-bucket` のいずれかのパラメータを 1 つ以上指定する必要があります。両方のパラメータに値を指定すると、ツールは `test-bucket` に対して指定されたバケットを使用します。
`output-bucket`	`String` 省略可。パフォーマンス診断ツールの出力をアップロードする Cloud Storage バケットの名前を指定します。例: `mytestbucket`。このツールは、このバケットに performancediagnostics という名前のフォルダを作成して、出力ファイルを保存します。このパラメータを指定しない場合、ツールは、`output-file-path` パラメータを指定するかどうかによって決まるディレクトリに出力を保存します。ツールが Cloud Storage に出力をアップロードできるようにするには、エージェントで使用されるサービスアカウントに Storage オブジェクトユーザー（`roles/storage.objectUser`）の IAM ロールを割り当てる必要があります。エージェントの Backint 機能を使用している場合、サービスアカウントには基盤となる権限があります。
`output-file-name`	`String` 省略可。パフォーマンス診断ツールが作成する出力 ZIP ファイルの名前を指定します。デフォルトでは、ZIP ファイルの名前は `performance-diagnostics-TIMESTAMP` です。ここで、`TIMESTAMP` は、ツールが ZIP ファイルを作成した日時です。
`output-file-path`	`String` 省略可。パフォーマンス診断ツールで出力 ZIP ファイルを保存するディレクトリのパスを指定します。指定されたパスが存在しない場合は作成されます。デフォルトでは、ZIP ファイルは `/tmp` ディレクトリに保存されます。
`hyper-threading`	`String` 省略可。Compute Engine ベアメタルマシンタイプ（X4 など）のハイパースレッディング設定を設定するように指定します。デフォルト値は `on` です。サポートされる値は `on` と `off` です。
`log-level`	`String` 省略可。パフォーマンス診断を実行する期間に対するエージェントのロギングレベルを設定します。デフォルト値は `info` です。サポートされている値は `debug`、`info`、`warn`、`error` です。診断情報の収集のためにツールによって実行されるオペレーションは、`/var/log/google-cloud-sap-agent/performancediagnostics.log` ファイルにキャプチャされます。

ログを表示する

performancediagnostics コマンドを実行すると、実行されたオペレーションが /var/log/google-cloud-sap-agent/performancediagnostics.log ファイルに記録されます。

次のステップ

パフォーマンス診断ツールの出力を生成したら、カスタマーケアに送信する必要があります。これにより、カスタマーケアは SAP ワークロードのパフォーマンスに関する問題のトラブルシューティングを迅速に行うことができます。