版本 2：Google Cloud 的 Agent for SAP 操作指南

本指南介绍在 Compute Engine 虚拟机实例和裸金属解决方案服务器上运行 Google Cloud 的 Agent for SAP 版本 2 的操作注意事项和步骤。

了解代理生命周期

管理 Google Cloud 的 Agent for SAP 的操作时，了解该代理的作用会很有帮助。一般而言，其工作原理如下：

  • 您必须在托管 SAP 系统的每个 Compute Engine 虚拟机实例或裸金属解决方案服务器上安装 Google Cloud's Agent for SAP。该代理以 Linux 服务或 Windows 服务的形式运行。
  • 在 Compute Engine 虚拟机实例上，该代理将来自 Monitoring 和 Compute Engine API 的监控数据相结合。
  • 在裸金属解决方案服务器上，为了仅收集 SAP Host Agent 指标，代理不会访问 Google Cloud API。
  • SAP Host Agent 通过 HTTP 轮询 Google Cloud 的 Agent for SAP 以获取其缓存的数据。它会汇总 SAP Host Agent 指标、报告这些指标并将其存储在 SAP NetWeaver 数据库中。
  • SAP 的事务 ST06 或 saposcol 命令行界面会显示经汇总的 SAP Host Agent 指标。
  • 您可以在终端窗口中运行命令，以查看来自 Google Cloud 的 Agent for SAP 的 SAP Host Agent 指标。

验证代理是否正在运行

安装代理或重启代理后，您可以验证代理是否按预期运行。

如要检查代理是否正在运行，请按以下步骤操作：

Linux

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

  2. 运行以下命令： 

    systemctl status google-cloud-sap-agent

    如果代理正常运行，则输出包含 active (running)。例如：

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

  1. 使用 RDP 连接到虚拟机实例。

  2. 以管理员身份从 PowerShell 运行以下命令：

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
     如果代理正在运行，则状态会显示 Running。

如果 Google Cloud 的 Agent for SAP 未运行，请重启代理。

检查代理的版本

安装或重启 Google Cloud 的 Agent for SAP 代理后，您可以查看代理的版本。

如需查看代理的版本，请完成以下步骤：

Linux

对于 RHEL，请按照以下步骤操作：

  1. 使用 SSH 连接到宿主机。
  2. 运行以下命令：
    yum info google-cloud-sap-agent

对于 SLES，请按照以下步骤操作：

  1. 使用 SSH 连接到宿主机。
  2. 运行以下命令：
    zypper info google-cloud-sap-agent

Windows

  1. 使用 RDP 连接到宿主机。
  2. 以管理员身份从 PowerShell 运行以下命令：
    googet installed google-cloud-sap-agent

验证 SAP Host Agent 正在接收指标

如需验证基础架构指标是否由 Google Cloud's Agent for SAP 收集并正确发送到 SAP Host Agent，请按照以下步骤操作：

  1. 在您的 SAP 系统中，输入事务 ST06。

  2. 在概览窗格中，检查以下字段的可用性和内容，以确保 SAP 与 Google 监控基础架构的端到端设置正确无误：

    • Cloud Provider：Google Cloud Platform
    • Enhanced Monitoring Access：TRUE
    • Enhanced Monitoring Details：ACTIVE

查看 SAP Host Agent 指标

安装或更新 Google Cloud 的 Agent for SAP 的配置后，您可以查看收集的 SAP Host Agent 指标。

如需查看 Google Cloud 的 Agent for SAP 收集的 SAP Host Agent 指标，请按照以下步骤操作：

Linux

  1. 与裸金属解决方案服务器的主机虚拟机实例建立 SSH 连接。

  2. 运行以下命令： 

    curl http://localhost:18181

    如果能得到这些指标，您应该会收到一个包含系统相关信息的 XML 输出。例如：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

  1. 使用 RDP 连接到虚拟机实例。

  2. 以管理员身份从 PowerShell 运行以下命令： 

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    如果能得到这些指标，您应该会看到一个包含系统相关信息的 XML 输出。例如：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

查看其他指标

更新 Google Cloud 的 Agent for SAP 的配置来收集 Process Monitoring 指标、Workload Manager 评估指标或 SAP HANA 监控指标后，您应查看这些指标以验证代理是否按预期收集指标。

您可以通过完成以下步骤在 Cloud Monitoring 中查看 Google Cloud 的 Agent for SAP 收集的指标和信息：

  1. 在 Google Cloud 控制台，进入 Monitoring Metrics Explorer 页面。

    转到 Metrics Explorer

  2. 选择 Configuration（配置）标签页。

  3. 展开选择指标菜单。

  4. 在资源菜单中，选择虚拟机实例。

  5. 在 Metric category（指标类别）菜单中，选择 SAP。

  6. 在指标菜单中，选择 metric: workload.googleapis.com/sap/service/active 或任何要绘制的新指标。

  7. 点击应用。

您应该会看到包含时序指标值的图表。

重启代理

如果 Google Cloud 的 Agent for SAP 停止运行或您要更新其配置，请重启该代理。

选择您的操作系统，然后按照以下步骤操作：

Linux

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

  2. 运行以下命令：

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. 与主机虚拟机实例建立 RDP 连接。

  2. 以管理员身份从 PowerShell 运行以下命令：

    Restart-Service -Name 'google-cloud-sap-agent' -Force

从其他 Google Cloud 代理升级到 Google Cloud 的 Agent for SAP

安装 Google Cloud 的 Agent for SAP 时，系统会自动检测旧版 SAP NetWeaver 监控代理和 SAP HANA 监控代理，停用代理，然后在安装期间从宿主机中移除代理。

如果检测到这些 Google Cloud 代理，则其配置文件中的配置也会在安装期间迁移到 Google Cloud 的 Agent for SAP。出于备份和参考目的，SAP HANA 监控代理的配置会复制到以下文件：

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

如需了解如何安装和配置 Google Cloud's Agent for SAP，请参阅选择 Google Cloud's Agent for SAP 安装和配置指南。

升级启用了 SSL 的实例

如果您已将 SAP HANA 监控代理配置为使用 SSL 证书与 SAP HANA 实例进行通信，则安装 Google Cloud 的 Agent for SAP 时，除 SSL 配置以外的所有 SAP HANA 监控配置都会迁移到 Google Cloud 的 Agent for SAP。在这种情况下，如需使用 Google Cloud 的 Agent for SAP 来监控 SAP HANA 实例，您必须完成以下步骤：

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

  2. 打开 Google Cloud 的 Agent for SAP 的配置文件：

    /etc/google-cloud-sap-agent/configuration.json

  3. 在 hana_monitoring_configuration 部分中，将参数 enabled 设置为 true。

  4. 在 hana_monitoring_configuration.hana_instances 部分中，对使用 TLS/SSL 协议进行安全通信的每个 SAP HANA 实例执行以下操作：

    1. 指定参数 enable_ssl 并将其值设置为 true。

    2. 指定参数 host_name_in_certificate，并将 TLS/SSL 证书中指定的 SAP HANA 主机名设置为其值。

    3. 指定参数 tls_root_ca_file，并将 TLS/SSL 证书的存储路径设置为其值。

  5. 保存配置文件。

  6. 重启代理以使新设置生效：

    sudo systemctl restart google-cloud-sap-agent

  7. 验证代理是否正在收集 SAP HANA 监控指标。如需查看相关说明，请参阅查看其他指标。

  8. 卸载 SAP HANA 监控代理。

如果您在此升级后遇到任何与 SAP HANA 实例相关的连接问题，则可以在 Logging 中查看代理的日志并使用问题排查指南来解决问题。

更新 Google Cloud 的 Agent for SAP

本部分介绍了如何检查 Google Cloud 的 Agent for SAP 的更新后版本是否可用，以及如何更新到 Google Cloud 的 Agent for SAP 3.2 版（最新版）。

如果您需要更新到非最新版代理，请与 Cloud Customer Care 联系。

检查更新

选择您的操作系统，然后按照以下步骤操作：

RHEL

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

  2. 运行以下命令：

    sudo yum check-update google-cloud-sap-agent

SLES

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

  2. 运行以下命令：

    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. 与主机虚拟机实例建立 RDP 连接。

  2. 以管理员身份从 PowerShell 运行以下命令：

    googet latest google-cloud-sap-agent

安装更新

如需将 Google Cloud 的 Agent for SAP 实例更新到 3.2 版（最新版），请选择您的操作系统，然后按照相关步骤操作。

如果您需要安装非最新版代理，请与 Cloud Customer Care 联系。

RHEL

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

  2. 运行以下命令：

    sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

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

  2. 运行以下命令：

    sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

  1. 与主机虚拟机实例建立 RDP 连接。

  2. 以管理员身份从 PowerShell 运行以下命令：

    googet install google-cloud-sap-agent

回滚到使用 SAP HANA 监控代理

如果您要回滚到使用 SAP HANA 监控代理，并停止使用 Google Cloud 的 Agent for SAP 的 SAP HANA 监控功能，请按照以下步骤操作：

RHEL

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

  2. 为防止收集重复的指标，请停用通过 Google Cloud 的 Agent for SAP 收集 SAP HANA 监控指标的功能：

    1. 打开 Google Cloud 的 Agent for SAP 的配置文件：

      /etc/google-cloud-sap-agent/configuration.json

    2. 在 hana_monitoring_configuration 部分中，将参数 enabled 设置为 false。

    3. 保存配置文件。

    4. 重启代理以使新设置生效：

      sudo systemctl restart google-cloud-sap-agent

  3. 从以下文件中复制 SAP HANA 监控代理的配置：

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. 安装 SAP HANA 监控代理版本 2。如需查看安装说明，请参阅 SAP HANA 监控代理 V2.0 安装和操作指南。

  5. 在以下文件中，粘贴您在上一步中复制的适用于 SAP HANA 的监控代理配置：

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. 重启 SAP HANA 监控代理：

    sudo systemctl start google-saphanamonitoring-agent

SLES

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

  2. 为防止收集重复的指标，请停用通过 Google Cloud 的 Agent for SAP 收集 SAP HANA 监控指标的功能：

    1. 打开 Google Cloud 的 Agent for SAP 的配置文件：

      /etc/google-cloud-sap-agent/configuration.json

    2. 在 hana_monitoring_configuration 部分中，将参数 enabled 设置为 false。

    3. 保存配置文件。

    4. 重启代理以使新设置生效：

      sudo systemctl restart google-cloud-sap-agent

  3. 从以下文件中复制 SAP HANA 监控代理的配置：

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. 安装 SAP HANA 监控代理版本 2。如需查看安装说明，请参阅 SAP HANA 监控代理 V2.0 安装和操作指南。

  5. 在以下文件中，粘贴您在上一步中复制的适用于 SAP HANA 的监控代理配置：

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. 重启 SAP HANA 监控代理：

    sudo systemctl start google-saphanamonitoring-agent

在 Cloud Logging 中查看该代理的日志

默认情况下，Google Cloud 的 Agent for SAP 日志会从虚拟机实例和裸金属解决方案服务器重定向到 Cloud Logging。

如需在 Logging 中查看代理的日志，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，转到日志浏览器页面。

    转到日志浏览器

  2. 转到查询窗格。

  3. 从资源下拉菜单中选择全局，然后点击应用。

  4. 在查询编辑器中，输入 google-cloud-sap-agent。

  5. 点击运行查询。

您应该会看到在所有虚拟机实例或裸金属解决方案服务器上运行的代理实例生成的日志。如需过滤特定机器的日志，请使用界面中提供的过滤条件。

您可以停用代理日志的这种默认重定向。为此，请按以下步骤操作：

  1. 与裸金属解决方案服务器的主机虚拟机实例建立 SSH 连接。

  2. 打开以下配置文件：

    /etc/google-cloud-sap-agent/configuration.json

  3. 对于参数 log_to_cloud，将值更新为 false。

  4. 保存配置文件。

  5. 重启代理以使此更改生效。