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

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

了解代理生命周期

管理 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

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

运行以下命令：

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

使用 RDP 连接到虚拟机实例。
以管理员身份从 PowerShell 运行以下命令：
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
如果代理正在运行，则状态会显示 Running。

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

验证 SAP Host Agent 正在接收指标

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

在您的 SAP 系统中，输入事务 ST06。
在概览窗格中，检查以下字段的可用性和内容，以确保 SAP 与 Google 监控基础架构的端到端设置正确无误：
- Cloud Provider：Google Cloud Platform
- Enhanced Monitoring Access：TRUE
- Enhanced Monitoring Details：ACTIVE

查看受监控的指标

安装或更新 Google Cloud's Agent for SAP 的配置后，您可以查看受监控的 SAP Host Agent 指标。

如需查看受监控的 SAP Host Agent 指标，请按照以下步骤操作：

Linux

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

运行以下命令：

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

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

以管理员身份从 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>

验证 Process Monitoring 指标和 Workload Manager 评估指标

更新配置后，您应验证 Process Monitoring 指标和 Workload Manager 评估指标是否可用。您可以在 Cloud Monitoring 中访问 Google Cloud 的 Agent for SAP 收集的指标和信息。

如需在 Monitoring 中验证指标，请按以下步骤操作：

在 Google Cloud 控制台，转到 Monitoring Metrics Explorer 页面。

转到 Metrics Explorer
选择 Configuration（配置）标签页。
展开选择指标菜单。
在资源菜单中，选择虚拟机实例。
在 Metric category（指标类别）菜单中，选择 SAP。
在指标菜单中，选择 metric: workload.googleapis.com/sap/service/active 或任何要绘制的新指标。
点击应用。

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

重启代理

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

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

Linux

与主机虚拟机实例建立 SSH 连接。

运行以下命令：

sudo systemctl restart google-cloud-sap-agent

Windows

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

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

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

从 SAP NetWeaver 监控代理升级到 Google Cloud 的 Agent for SAP

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

如果检测到 SAP NetWeaver 监控代理，并且安装期间找到了现有配置文件，则安装过程会自动将现有配置迁移到 Google Cloud 的 Agent for SAP。

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

更新 Google Cloud 的 Agent for SAP

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

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

检查更新

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

RHEL

与主机虚拟机实例建立 SSH 连接。

运行以下命令：

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

SLES

与主机虚拟机实例建立 SSH 连接。

运行以下命令：

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

Windows

与主机虚拟机实例建立 RDP 连接。
以管理员身份从 PowerShell 运行以下命令：
```
googet latest google-cloud-sap-agent
```

安装更新

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

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

RHEL

与主机虚拟机实例建立 SSH 连接。

运行以下命令：

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

SLES

与主机虚拟机实例建立 SSH 连接。

运行以下命令：

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

Windows

与主机虚拟机实例建立 RDP 连接。
以管理员身份从 PowerShell 运行以下命令：
```
googet install google-cloud-sap-agent
```

回滚到先前的某个版本

如果需要，您可以将 Google Cloud 的 Agent for SAP 版本 1 回滚到 SAP NetWeaver 监控代理版本 2。

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

RHEL

与主机虚拟机实例建立 SSH 连接。
运行以下命令：
```
sudo yum remove google-cloud-sap-agent
```
安装 SAP NetWeaver 的监控代理版本 2。如需了解如何安装 SAP NetWeaver 的监控代理，请参阅选择 SAP NetWeaver 监控代理的安装指南。

SLES

与主机虚拟机实例建立 SSH 连接。

运行以下命令：

sudo zypper remove google-cloud-sap-agent

安装 SAP NetWeaver 的监控代理版本 2。如需了解如何安装 SAP NetWeaver 的监控代理，请参阅选择 SAP NetWeaver 监控代理的安装指南。

Windows

与主机虚拟机实例建立 RDP 连接。
以管理员身份从 PowerShell 运行以下命令：
```
googet remove google-cloud-sap-agent
```
安装 SAP NetWeaver 的监控代理版本 2。如需了解如何安装 SAP NetWeaver 的监控代理，请参阅选择 SAP NetWeaver 安装的监控代理指南。

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

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

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

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

转到日志浏览器
转到查询窗格。
从资源下拉菜单中选择全局，然后点击应用。
在查询编辑器中，输入 google-cloud-sap-agent。
点击运行查询。

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

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

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

打开以下配置文件：

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

对于参数 log_to_cloud，将值更新为 false。
保存配置文件。
重启代理以使此更改生效。