版本 2：配置 Workload Manager 评估指标收集

Version 2

• 版本 3.6 (latest)
• 版本 2
• 版本 1

本指南介绍了如何配置Google Cloud的 Agent for SAP 版本 2 以从 SAP 系统收集 Workload Manager 评估指标。

如需了解此功能，请参阅使用 Google Cloud的 Agent for SAP 进行 Workload Manager 评估。

注意：只有 Linux 支持收集 Workload Manager 评估指标。Windows 不支持此功能。

准备工作

• 验证 Google Cloud的 Agent for SAP 的安装情况。如需查看相关说明，请参阅适合您的场景的安装指南。
• 如果您已在裸金属解决方案服务器上安装代理，请确保已满足所需的前提条件并设置服务账号。如需查看相关说明，请参阅在 Linux 上配置 Google Cloud的 Agent for SAP。

设置 IAM 角色

如需允许 Google Cloud的 Agent for SAP 收集 Workload Manager 评估指标，您必须确保 Compute Engine 实例或裸金属解决方案服务器使用的服务账号具有以下角色：

• Compute Viewer (roles/compute.viewer)
• Monitoring Metric Writer (roles/monitoring.metricWriter)
• Secret Manager Secret Accessor (roles/secretmanager.secretAccessor)（如果您使用 Secret Manager 存储 SAP HANA 数据库密码）。

如需向您的服务账号添加这些必需的角色，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，转到 IAM 页面。

   转到 IAM

2. 选择您的 Google Cloud 项目。

3. 确定要向其添加角色的服务账号。

   • 如果该服务账号不在主账号列表中，则表明还没有为它分配任何角色。点击添加，然后输入该服务账号的电子邮件地址。
   • 如果该服务账号已经在主账号列表中，则表明它已具有角色。点击要修改的服务账号对应的修改按钮。

4. 从可用角色列表中选择所需角色：

   • Compute Viewer
   • Monitoring > Monitoring Metric Writer
   • Secret Manager > Secret Manager Secret Accessor

5. 点击添加或保存，将相应角色应用于该服务账号。

启用 Workload Manager 评估指标收集功能

如需启用使用 Google Cloud的 Agent for SAP 收集 Workload Manager 评估指标的功能，请按照以下步骤操作：

1. 与 Compute Engine 实例或裸金属解决方案服务器建立 SSH 连接。

2. 打开代理的配置文件：

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

3. 在 collection_configuration 部分中，对于参数 collect_workload_validation_metrics，设置值 true。

4. 如需在 Workload Manager 中启用 workload.googleapis.com/sap/validation/hanasecurity 指标收集功能来启用安全评估规则，请在 collect_workload_validation_metrics 后面添加 workload_validation_db_metrics_config 部分，然后指定以下参数：

   • hana_db_user：指定用于查询 SAP HANA 实例的用户账号。
   • hana_db_password_secret_name：指定 Secret Manager 中用来存储用户账号密码的 Secret 的名称。
   • hostname：指定托管 SAP HANA 实例的机器（本地或远程）的标识符。
   • port：指定 SAP HANA 实例接收查询的端口。

   如需了解这些参数，请参阅配置参数。

5. （可选）在 cloud_properties 部分下，您可以更新自动设置的参数值。为此，请将 cloud_properties 部分添加到您的配置文件中，然后指定必需的参数及其值。

6. 保存配置文件。

7. 重启代理以使新设置生效：

   sudo systemctl restart google-cloud-sap-agent

配置文件示例

Compute Engine 实例

以下示例是一个在Compute Engine 实例上运行的Google CloudAgent for SAP 第 2 版的已完成配置文件，其中启用了 Workload Manager 评估指标收集功能：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

裸金属解决方案服务器

以下示例是一个在裸金属解决方案服务器上运行的Google CloudAgent for SAP 第 2 版的已完成配置文件，其中启用了 Workload Manager 评估指标收集功能：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

配置参数

下表说明了Google Cloud的 Agent for SAP 特定于 Workload Manager 评估指标收集的配置参数。

参数
provide_sap_host_agent_metrics	Boolean 如需启用 SAP Host Agent 所需的指标收集功能，请指定 true。 默认值为 true。 除非有 Cloud Customer Care 或 SAP 支持团队的指导，否则请勿将 provide_sap_host_agent_metrics 设置为 false。
bare_metal	Boolean 在裸金属解决方案服务器上安装代理后时，请指定 true。默认值为 false。
log_level	String 如需设置代理的日志记录级别，请设置所需的值。可用的日志级别如下： DEBUG INFO WARNING ERROR 默认为 INFO。除非有 Cloud Customer Care 的指导，否则请勿更改日志记录级别。
log_to_cloud	Boolean 如需将代理的日志重定向到 Cloud Logging，请指定 true。默认值为 true。
sap_system_discovery	Boolean 如需启用 SAP 系统发现，请指定 true。 默认值为 true。
cloud_properties.project_id	String 如果您的 SAP 系统在裸金属解决方案服务器上运行，请指定您用于裸金属解决方案的 Google Cloud 项目的 ID。 当代理在 Compute Engine 实例上运行时，默认情况下，代理会自动检测项目 ID。
cloud_properties.instance_name	String 如果您的 SAP 系统在 Compute Engine 实例上运行，请指定该计算实例的名称。代理会在安装时自动检测计算实例名称。 如果您的 SAP 系统在裸金属解决方案服务器上运行，请指定该服务器的名称。 在代理版本 2.5 或更低版本中，为属性 instance_id 指定裸金属解决方案服务器名称。
cloud_properties.region	String 如果您的 SAP 系统在裸金属解决方案服务器上运行，请指定裸金属解决方案服务器的区域。 当代理在计算实例上运行时，默认情况下，代理会使用计算实例部署所在的区域。
cloud_properties.zone	String 当代理在计算实例上运行时，默认情况下，代理会使用部署计算实例的可用区。
cloud_properties.image	String 指定实例的操作系统映像名称。 当代理在计算实例上运行时，默认情况下，代理会自动检测计算实例使用的操作系统映像。
cloud_properties.numeric_project_id	String 指定运行 SAP 系统的 Google Cloud 项目的数字 ID。 当代理在计算实例上运行时，默认情况下，代理会自动检测项目编号。
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	String 指定用于查询 SAP HANA 实例的用户账号的密码。
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String 指定存储用户账号密码的 Secret Manager 中的密文的名称。
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 地址。
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 秒。