适用于 SAP NetWeaver 的 Google Cloud 监控代理问题排查指南

本指南介绍了如果 SAP NetWeaver 监控代理无法正常工作时，您可以调查的常见问题。

查看日志

您可以通过检查 SAP NetWeaver 的监控代理的日志来开始排查与该代理相关的问题。

检查特定于您的操作系统的目录中的日志：

Linux

/var/log/google-sapnetweavermonitoring-agent.log

Windows

C:\Program Files\Google\google-sapnetweavermonitoring-agent\logs\google-sapnetweavermonitoring-agent.log

IAM 权限不足

在 Google Cloud 控制台中的“虚拟机实例详情”页面上，记下虚拟机服务账号的名称。例如：sap-example@example-project-123456.iam.gserviceaccount.com。在“IAM 和管理”首页上，确认服务账号包含拥有 monitoring.timeSeries.list 权限的 IAM 角色。

如果您安装了 Cloud Monitoring 代理（而不是 SAP NetWeaver 的监控代理），则可能需要向虚拟机服务账号授予其他 IAM 权限，例如预定义的 Monitoring Metric Writer 角色。如需确认 Monitoring 代理所需的权限，请参阅 Cloud Monitoring 文档：

虚拟机服务账号的访问权限范围不正确

访问权限范围是为实例指定权限的传统方法。

最佳做法是在实例上设置完整的 cloud-platform 访问权限范围，然后使用 IAM 角色安全地限制服务账号的 API 访问权限。例如：

  • https://www.googleapis.com/auth/cloud-platform

如果您确实限制了虚拟机的访问权限范围，则必须确保主机虚拟机具有以下访问权限范围：

  • https://www.googleapis.com/auth/source.read_write
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/servicecontrol
  • https://www.googleapis.com/auth/service.management.readonly
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/devstorage.full_control

要更改访问权限范围，您需要停止虚拟机实例，进行更改，然后重启实例。如需查看相关说明，请参阅 Compute Engine 文档。您无需针对此问题对 IAM 角色权限进行任何更改。

SAP Host Agent 缺失或不正确

要使监控系统正常工作，您的 SAP NetWeaver 系统必须安装 SAP Host Agent，且必须具有该 Host Agent 所需的最低补丁程序级别。如需了解如何安装 SAP Host Agent，请参阅 SAP 文档。

如需了解 SAP Host Agent 的版本要求，请参阅以下 SAP 说明：

下载失败

如果创建了主机服务器来运行 SAP NetWeaver 的监控代理，但没有分配公共 IP 地址，则无法下载监控代理。如需了解如何设置 NAT 网关，以授予主机服务器对互联网的出站访问权限，请参阅适用于您的操作系统的部署指南：

端口不可用

SAP NetWeaver 的监控代理侦听端口 18181 上的请求。此端口必须可用，否则监控代理将无法启动。否则，SAP Host Agent 日志会显示 Connection Refused 错误。确保端口 18181 适用于 SAP NetWeaver 的监控代理。如果其他服务使用的是端口 18181，您可能需要重启其他服务，否则请重新配置服务，以便使用其他端口。

缺少配置文件（仅限裸金属解决方案）

主机服务器上需要有 configuration.yaml 文件，才能在裸金属解决方案环境中启用 SAP NetWeaver 的监控代理。如需在安装 SAP NetWeaver 的监控代理后创建 configuration.yaml 文件，请按照以下步骤操作：

  1. 在您的操作系统对应的以下目录中创建 configuration.yaml 文件：

    Linux

    /usr/sap/google-sapnetweavermonitoring-agent/configuration.yaml

    Windows

    C:\Program Files\Google\google-sapnetweavermonitoring-agent\configuration.yaml

  2. 在 configuration.yaml 文件中，添加以下行： 

    bare_metal: true

  3. 重新启动 SAP NetWeaver 的监控代理。如需了解详情，请参阅重启 SAP NetWeaver 的监控代理。

获取 SAP NetWeaver 的监控代理的支持

如果您在解决 SAP NetWeaver 监控代理问题时需要帮助，请收集所需的诊断信息并联系 Cloud Customer Care。如需了解详情，请参阅 SAP NetWeaver 的监控代理诊断信息。