配置代理健康状况指标收集

本指南介绍如何配置 Google Cloud 的 Agent for SAP，以从 Compute Engine 虚拟机实例或裸金属解决方案服务器上的代理守护进程收集健康指标。

如需了解此功能，请参阅代理健康指标收集。

准备工作

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

设置 IAM 角色

如需使 Google Cloud 的 Agent for SAP 收集健康指标，您必须确保 Compute Engine 虚拟机实例或裸金属解决方案服务器使用的服务账号包含以下角色：

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

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

转到 IAM
选择您的 Google Cloud 项目。
确定要向其添加角色的服务账号。
- 如果该服务账号不在主账号列表中，则表明还没有为它分配任何角色。点击授予访问权限，然后输入该服务账号的电子邮件地址。
- 如果该服务账号已经在主账号列表中，则表明它已具有角色。点击要修改的服务账号对应的修改按钮。
从可用角色列表中选择所需角色：
- Compute Engine > Compute Viewer
- Monitoring > Monitoring Metric Writer
点击保存以将角色应用于服务账号。

启用代理健康指标收集功能

如需使 Google Cloud 的 Agent for SAP 收集其守护进程在主机上的健康指标，请按照以下步骤操作：

与主机虚拟机实例或裸金属解决方案服务器建立 SSH 连接。
启用代理健康指标收集功能：
运行命令
1. 如需启用代理健康指标收集功能，请运行以下命令：
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
```
2. （可选）您可以修改代理收集其守护进程的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
  
  如需修改此频率，请运行以下命令：
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY
```
  将 FREQUENCY 替换为所需的值（以秒为单位）。频率不得低于 5 秒。
3. （可选）您可以修改代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
  
  如需修改此频率，请运行以下命令。频率不得低于 5 秒。
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```
修改配置文件
作为运行代理命令的替代方法，您可以按如下方式手动修改代理的配置：
1. 打开 Backint 配置文件：
```
/etc/google-cloud-sap-agent/configuration.json
```
2. 在 collection_configuration 部分中，添加以下内容：
```
"collect_agent_metrics": true
```
3. （可选）您可以修改代理收集其守护进程的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
  
  如需修改此频率，请在 collection_configuration 部分中添加以下内容。
```
"agent_metrics_frequency": FREQUENCY
```
  将 FREQUENCY 替换为所需的值（以秒为单位）。频率不得低于 5 秒。
4. （可选）您可以修改代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
  
  如需修改此频率，请在 collection_configuration 部分中添加以下内容。频率不得低于 5 秒。
```
"agent_health_frequency": FREQUENCY
```
5. 保存配置文件。
6. 重启代理以使新设置生效：
```
sudo systemctl restart google-cloud-sap-agent
```

配置文件示例

Compute Engine 虚拟机实例

以下示例是一个在 Compute Engine 虚拟机实例上运行的 Google Cloud 的 Agent for SAP（其中启用了代理健康指标收集功能）的已完成配置文件：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

裸金属解决方案服务器

以下示例是一个在裸金属解决方案服务器上运行的 Google Cloud 的 Agent for SAP（其中启用了代理健康指标收集功能）的已完成配置文件：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

配置参数

下表说明了 Google Cloud 的 Agent for SAP 的特定于代理健康指标收集的配置参数。

参数

参数
`collection_configuration.collect_agent_metrics`	`Boolean` 可选。指定 `true` 以让代理收集以下信息并发送到 Cloud Monitoring：主机上代理的守护进程的 CPU 和内存用量。主机上代理的守护进程的运行健康状况。默认值为 `false`。
`collection_configuration.agent_metrics_frequency`	`Int` 可选。指定代理收集其守护进程在主机上的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。此信息由 `sap/agent/cpu/utilization` 和 `sap/agent/memory/utilization` 指标捕获。默认值为 `60` 秒。频率不得低于 5 秒。
`collection_configuration.agent_health_frequency`	`Int` 可选。指定代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。此信息由 `sap/agent/health` 指标捕获。默认值为 `60` 秒。频率不得低于 5 秒。

collection_configuration.collect_agent_metrics

Boolean

可选。指定 true 以让代理收集以下信息并发送到 Cloud Monitoring：

主机上代理的守护进程的 CPU 和内存用量。
主机上代理的守护进程的运行健康状况。

默认值为 false。

collection_configuration.agent_metrics_frequency

Int

可选。指定代理收集其守护进程在主机上的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。此信息由 sap/agent/cpu/utilization 和 sap/agent/memory/utilization 指标捕获。默认值为 60 秒。频率不得低于 5 秒。

collection_configuration.agent_health_frequency