此页面由 Cloud Translation API 翻译。

配置 Agent for SAP 以收集指标
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。

Google Cloud的 Agent for SAP 支持监控在 Compute Engine 实例上运行的 SAP 工作负载，并帮助您在 Google Cloud上高效运行 SAP 系统。您必须在运行任何 SAP 系统的所有虚拟机上安装 Google Cloud的 Agent for SAP。此代理会收集 SAP 要求的所有必需信息，并将其发送到 SAP Host Agent。如需了解详情，请参阅 SAP 说明 2469354。

如需收集用于可观测性的底层基础架构和应用指标，您必须为 Agent for SAP 启用其他功能。

本文档介绍了如何在 Agent for SAP 中启用这些功能。

Agent for SAP 核对清单

以下核对清单总结了您需要执行的任务，以确保 Agent for SAP 设置正确，以便实现可观测性：

安装和配置 Agent for SAP	在要监控的每个 Compute Engine 虚拟机上安装和配置 Google Cloud的 Agent for SAP。 Agent for SAP 与以下“for SAP”公共操作系统映像打包在一起： RHEL：所有“for SAP”映像 SLES：SLES 15 SP4 for SAP 及更高版本如需了解详情，请参阅在虚拟机上安装和配置 Agent for SAP。
更新 Agent for SAP	Agent for SAP 的 3.5 版包含为 SAP 设置可观测性所需的所有功能。如果您之前安装了代理，我们建议您将其更新到最新版本。如需了解详情，请参阅更新 Google Cloud的 Agent for SAP。
启用 Agent for SAP 的系统发现功能	在代理的配置文件中，必须将以下参数设置为 `true`。如果您是在 2024 年 2 月 14 日之后安装的代理，则这些标志默认设置为 `true`，无需进行任何更改。 `discovery_configuration.enable_workload_discovery` `discovery_configuration.enable_discovery` 如果您在 2024 年 2 月 14 日之前安装了该代理，或者您已停用系统的发现功能，请运行以下命令： sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable 如需了解详情，请参阅配置 Google Cloud的 Agent for SAP。
启用 Agent for SAP 的 Process Monitoring 指标收集功能	在代理的配置文件中，`collection_configuration.collect_process_metrics` 参数必须设置为 `true`。如需启用此功能，请运行以下命令： sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable 如需了解详情，请参阅配置 Process Monitoring 指标收集。
为 Agent for SAP 启用 HANA 监控指标收集功能	在 HANA 虚拟机上，您必须启用 HANA Process Monitoring 指标收集。如需启用此功能，请运行以下命令： sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable 修改代理配置文件中的 `hana_monitoring_configuration` 部分，提供 HANA 实例名称、SID、主机、端口、用户和密码（使用 Secret 或 `hdbuserstore` 密钥）。请注意，指定的 HANA 用户必须对默认查询所查询的表拥有读取权限。如需了解详情，请参阅配置 SAP HANA 监控指标收集。
验证代理配置和 Google Cloud 设置	通过运行以下命令验证代理是否配置正确： sudo /usr/bin/google_cloud_sap_agent status 注意：此命令从代理版本 3.7 开始受支持。如需了解详情，请参阅验证 Workload Manager 可观测性设置。
重启 Agent for SAP	运行以下命令重启代理，以使更改生效：注意：从版本 3.7 开始，您无需重启代理，因为对代理配置的任何更改都会在接下来的 30 秒内自动应用。 sudo systemctl restart google-cloud-sap-agent 如需了解详情，请参阅重启代理。

验证 Workload Manager 可观测性设置

您可以通过运行代理的 status 命令来验证是否已正确 Google Cloud 设置了 Workload 管理器可观测性服务。此命令从代理版本 3.7 开始受支持。

如需验证 Google Cloud 设置，请完成以下步骤：

与 Compute Engine 实例建立 SSH 连接。

运行以下命令：

sudo /usr/bin/google_cloud_sap_agent status

如果您 Google Cloud 使用 Workload Manager 可观测性服务的设置正确无误，则输出将包含以下内容。您的配置可能包含 default 以外的值。

Agent Status:
    Installed version: 3.7-....
    ...
    Systemd Service Enabled: True
    Systemd Service Running: True
    Cloud API Full Scopes: True
    Configuration File: /etc/google-cloud-sap-agent/configuration.json
    Configuration Valid: True
...
----------------------------------------------------------------------------
Process Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        collect_process_metrics:        true (configuration file)
        process_metrics_frequency:      5    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 30   (default)
...
----------------------------------------------------------------------------
HANA Monitoring Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        connection_timeout:       120   (default)
        enabled:                  true  (configuration file)
        execution_threads:        10    (default)
        max_connect_retries:      1     (default)
        query_timeout_sec:        300   (default)
        sample_interval_sec:      300   (default)
        send_query_response_time: false (default)
...
----------------------------------------------------------------------------
System Discovery: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        enable_discovery:                  true  (default)
        enable_workload_discovery:         true  (default)
        sap_instances_update_frequency:    60    (default)
        system_discovery_update_frequency: 14400 (default)
...

如果输出显示缺少某些设置，请查看前面部分中提供的信息，执行所需的操作，然后重新运行 status 命令以重新验证设置。

示例配置文件

启用可观测性功能后，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": true
  },
  "discovery_configuration": {
     "enable_workload_discovery": true,
     "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
    ],
   }
  }

后续步骤

了解如何观察 SAP 工作负载。