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

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

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

准备工作

设置 IAM 角色

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

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

  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 秒。