本指南介绍如何配置 Google Cloud的 Agent for SAP,以从 Compute Engine 实例或裸金属解决方案服务器上的代理守护进程收集健康指标。
如需了解此功能,请参阅代理健康指标收集。
准备工作
- 验证 Google Cloud的 Agent for SAP 的安装情况。如需查看相关说明,请参阅适合您的场景的安装指南。
- 如果您已在裸金属解决方案服务器上安装代理,请确保已满足所需的前提条件并设置服务账号。如需查看相关说明,请参阅在 Linux 上配置 Google Cloud的 Agent for SAP。
所需的角色
如需确保服务账号拥有允许 Google Cloud的 Agent for SAP 收集 Agent 健康指标所需的权限,请让您的管理员为服务账号授予项目的以下 IAM 角色:
-
Monitoring Metric Writer (
roles/monitoring.metricWriter
): 用于将收集的指标写入 Cloud Monitoring。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
这些预定义角色包含允许 Google Cloud的 Agent for SAP 收集 Agent 运行状况指标所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需允许 Google Cloud的 Agent for SAP 收集代理健康指标,您需要拥有以下权限:
-
如需从主机 Compute Engine 实例收集 Agent 健康状况指标并将其写入 Cloud Monitoring,请执行以下操作:
monitoring.timeSeries.create
您的管理员也可以使用自定义角色或其他预定义角色为服务账号授予这些权限。
启用代理健康指标收集功能
如需使 Google Cloud的 Agent for SAP 收集其守护进程在主机上的健康指标,请按照以下步骤操作:
与主机 Compute Engine 实例或裸金属解决方案服务器建立 SSH 连接。
启用代理健康指标收集功能:
运行命令
如需启用代理健康指标收集功能,请运行以下命令:
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
(可选)您可以修改代理收集其守护进程的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
如需修改此频率,请运行以下命令:
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY
将
FREQUENCY
替换为所需的值(以秒为单位)。频率不得低于 5 秒。(可选)您可以修改代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
如需修改此频率,请运行以下命令。频率不得低于 5 秒。
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
修改配置文件
作为运行代理命令的替代方法,您可以按如下方式手动修改代理的配置:
打开 Backint 配置文件:
/etc/google-cloud-sap-agent/configuration.json
在
collection_configuration
部分中,添加以下内容:"collect_agent_metrics": true
(可选)您可以修改代理收集其守护进程的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
如需修改此频率,请在
collection_configuration
部分中添加以下内容。"agent_metrics_frequency": FREQUENCY
将
FREQUENCY
替换为所需的值(以秒为单位)。频率不得低于 5 秒。(可选)您可以修改代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。默认频率为 60 秒。
如需修改此频率,请在
collection_configuration
部分中添加以下内容。频率不得低于 5 秒。"agent_health_frequency": FREQUENCY
保存配置文件。
重启代理以使新设置生效:
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 }, "discovery_configuration": { "enable_discovery": true, "enable_workload_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, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
配置参数
下表说明了Google Cloud的 Agent for SAP 的特定于代理健康指标收集的配置参数。
参数 | |
---|---|
collection_configuration.collect_agent_metrics |
可选。指定
默认值为 |
collection_configuration.agent_metrics_frequency |
可选。指定代理收集其守护进程在主机上的 CPU 和内存用量并发送到 Cloud Monitoring 的频率。此信息由 |
collection_configuration.agent_health_frequency |
可选。指定代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。此信息由 |