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

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

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

准备工作

所需的角色

如需确保服务账号拥有允许 Google Cloud的 Agent for SAP 收集 Agent 健康指标所需的权限,请让您的管理员为服务账号授予项目的以下 IAM 角色:

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

这些预定义角色包含允许 Google Cloud的 Agent for SAP 收集 Agent 运行状况指标所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

如需允许 Google Cloud的 Agent for SAP 收集代理健康指标,您需要拥有以下权限:

  • 如需从主机 Compute Engine 实例收集 Agent 健康状况指标并将其写入 Cloud Monitoring,请执行以下操作: monitoring.timeSeries.create

您的管理员也可以使用自定义角色或其他预定义角色为服务账号授予这些权限。

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

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

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

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

    运行命令

    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
  },
  "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

Boolean

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

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

默认值为 false

collection_configuration.agent_metrics_frequency

Int

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

collection_configuration.agent_health_frequency

Int

可选。指定代理检查其运行健康状况并将该信息发送到 Cloud Monitoring 的频率。此信息由 sap/agent/health 指标捕获。默认值为 60 秒。频率不得低于 5 秒。