收集有关 SAP 工作负载性能的诊断信息

本指南介绍如何使用 Google Cloud 的 Agent for SAP 3.4 版或更高版本收集 SAP 工作负载的性能诊断信息。

如果您联系 Cloud Customer Care 寻求与 SAP 工作负载性能问题排查有关的帮助，您需要分享工作负载的相关诊断信息。通过使用代理的内置性能诊断工具，您可以自动收集必要的诊断信息，从而帮助加快问题排查和解决速度。

如需了解代理可以为 SAP 工作负载运行的性能诊断，请参阅工作负载性能诊断。

准备工作

确保您使用的是 Google Cloud 的 Agent for SAP 3.4 版或更高版本。

如需了解如何检查和更新代理，请参阅更新 Google Cloud 的 Agent for 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：输出 ZIP 文件的名称，其中包含有关 SAP 工作负载的诊断信息
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`。如果要为数据、日志或目录备份使用单独的配置文件，想要为哪种备份类型收集诊断数据，就请指定与该备份类型相对应的路径。
`test-bucket`	`String` 若要运行 `backup` 诊断，请指定该工具在测试向 Cloud Storage 上传文件以及从 Cloud Storage 下载文件时必须使用的 Cloud Storage 存储桶的名称。例如：`mybucket`。确保用于测试的存储桶未设置保留政策。如需运行 `backup` 诊断，您需要指定以下至少一个参数：`backint-config-file` 或 `test-bucket`。如果您同时为这两个参数指定了值，则工具会使用为 `test-bucket` 指定的存储桶。
`output-bucket`	`String` 可选。指定要在其中上传性能诊断工具的输出的 Cloud Storage 存储桶名称。例如：`mytestbucket`。该工具会在此存储桶中创建一个名为“performancediagnostics”的文件夹来存储输出文件。如果未指定此参数，则工具将根据您是否指定了 `output-file-path` 参数来确定输出文件在目录中的保存位置。如需让该工具将输出上传到 Cloud Storage，您必须为代理使用的服务账号分配 Storage Object User (`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。

后续步骤

生成性能诊断工具的输出后，您需要将其发送给 Customer Care。这有助于 Customer Care 更快地排查 SAP 工作负载的性能问题。