版本 2：配置 Process Monitoring 指标收集

本指南介绍如何配置 Google Cloud 的 SAP 代理版本 2 以从 SAP 系统收集 Process Monitoring 指标。

如需详细了解此功能，请参阅使用 Google Cloud 的 Agent for SAP 进行进程监控。

准备工作

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

设置 IAM 角色

如需允许 Google Cloud 的 Agent for SAP 收集 Process Monitoring 指标，您必须确保 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. 点击添加或保存，将相应角色应用于该服务账号。

启用 Process Monitoring 指标收集功能

如需启用使用 Google Cloud's Agent for SAP 收集 Process Monitoring 指标的功能，请按照以下步骤操作：

1. 与主机 Compute Engine 实例建立 SSH 连接。

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

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

3. 在 collection_configuration 部分中，执行以下操作：

   • 对于参数 collect_process_metrics，请指定值 true。
   • 如需启用收集与 SAP HANA 数据库实例相关的 Process Monitoring 指标的功能，您需要在 hana_metrics_config 部分中配置其他参数。如需了解这些参数，请参阅配置参数。

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

5. 保存配置文件。

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

   sudo systemctl restart google-cloud-sap-agent

配置文件示例

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "sap_system_discovery": true,
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "sap_system_discovery": true,
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name"
    }
  },
  "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 的特定于 Process Monitoring 指标收集的配置参数。

查看收集的指标

如需直观呈现代理收集的 Process Monitoring 指标，您可以使用 Google Cloud 提供的以下自定义信息中心：

• SAP 代理 - HANA 概览：此信息中心提供显示以下指标的状态概览的图表：SAP HANA 可用性、SAP HANA HA 可用性、SAP HANA HA 复制、SAP HANA 服务状态、HA 集群 - 节点状态和 HA 集群 - SAP 实例的资源状态。

  此信息中心的 JSON 文件为 sap-agent-status-overview.json。

• SAP 代理 - HANA 原始指标：此信息中心提供显示以下指标的原始指标值的图表：SAP HANA 可用性、SAP HANA HA 可用性、SAP HANA HA 复制、SAP HANA 服务状态、HA 集群 - 节点状态和 HA 集群 - SAP 实例的资源状态。

  此信息中心的 JSON 文件为 sap-agent-raw-metrics.json。

安装信息中心

如需安装自定义信息中心，请完成以下步骤：

查看已安装的信息中心

如需查看已安装的信息中心，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Monitoring 页面：

   进入 Monitoring

2. 在 Monitoring 导航面板中，点击信息中心。

3. 在列表中点击信息中心名称。

如果您有许多信息中心，则可以针对自定义信息中心或新信息中心的名称进行过滤。如需了解如何过滤此列表，请参阅查看自定义信息中心。

下图是一个示例，展示了 Monitoring 中 SAP HANA 指标的自定义信息中心的一部分。