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

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

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

准备工作

设置 IAM 权限

如需使 Google Cloud的 Agent for SAP 收集健康指标，您必须确保 Compute Engine 实例或裸金属解决方案服务器使用的服务账号包含所需的 IAM 权限。

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

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

    转到 IAM

  2. 选择您的 Google Cloud 项目。

  3. 确定要向其添加角色的服务账号。

    • 如果该服务账号不在主账号列表中，则表明还没有为它分配任何角色。点击授予访问权限，然后输入该服务账号的电子邮件地址。
    • 如果该服务账号已经在主账号列表中，则表明它已具有角色。点击要修改的服务账号对应的修改按钮。

  4. 从可用角色列表中选择所需角色：

    • Monitoring > Monitoring Metric Writer

  5. 点击保存以将角色应用于服务账号。

如需精细控制访问权限，您可以为自己的自定义角色设置以下 IAM 权限：

  • 指标收集：
    • 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
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "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/utilization 和 sap/agent/memory/utilization 指标捕获。默认值为 60 秒。频率不得低于 5 秒。

collection_configuration.agent_health_frequency

Int

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