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

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

了解代理生命周期

管理 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.5 版（最新版）。

如果您需要更新到非最新版代理，请与 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.5 版（最新版），请选择您的操作系统，然后按照相关步骤操作。

如果您需要安装非最新版代理，请与 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 日志会从 Compute Engine 实例和裸金属解决方案服务器重定向到 Cloud Logging。

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

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

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

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

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

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

打开以下配置文件：

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

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