版本 1：在裸金属解决方案服务器上安装和配置 Google Cloud 的 Agent for SAP

Version 1

• 版本 3.5 (latest)
• 版本 2
• 版本 1

警告：我们已于 2024 年 6 月 4 日停止支持 Google Cloud 的 Agent for SAP 版本 1。

如果您使用的是代理版本 1，我们建议您尽快更新到支持的版本。如需了解支持的版本，请参阅 SAP on Google Cloud 支持的版本。如需了解如何更新到受支持的代理版本，请参阅更新 Google Cloud 的 Agent for SAP。

若要为裸金属解决方案服务器上运行的 SAP 系统提供 SAP 支持，需要使用 Google Cloud 的 Agent for SAP。

如果您使用 Google Cloud 提供的以下 RHEL 或 SLES“for SAP”操作系统映像，则 Google Cloud 的 SAP for Agent 会与操作系统映像打包在一起：

• RHEL：所有“for SAP”映像
• SLES：SLES 15 SP4 for SAP 及更高版本

如需了解可用于在裸金属解决方案服务器上运行 SAP 的操作系统，请参阅以下内容：

• 对于 SAP HANA，请参阅经认证的操作系统。
• 对于 SAP NetWeaver，请参阅经认证的操作系统。

如需在 Compute Engine 实例上安装和配置 Google Cloud 的 Agent for SAP 版本 1，请参阅在 Compute Engine 实例上安装 Google Cloud 的 Agent for SAP。

安装概览

您可以使用标准操作系统软件包管理命令（在 RHEL 上使用 yum 命令；在 SLES 上使用 zypper 命令）安装 Google Cloud 的 Agent for SAP。软件包管理命令可完成以下任务：

• 下载 Google Cloud 的 Agent for SAP。
• 将该代理创建为一项名为 google-cloud-sap-agent 的 Linux systemd 服务。
• 启用并启动服务 google-cloud-sap-agent。

安装代理

我们建议您安装 Google Cloud 的 Agent for SAP 的最新版本，它支持更多功能。如需查看相关说明，请参阅在裸金属解决方案服务器上安装和配置 Google Cloud 的 Agent for SAP。

如需安装 Google Cloud 的 Agent for SAP 版本 1，请与 Cloud Customer Care 联系。

安装 Google Cloud's Agent for SAP和 SAP Host Agent 后，请按照验证代理安装中的说明验证 Google Cloud's Agent for SAP安装。

验证代理安装

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
   

如果代理未在运行，请重启代理。

验证 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

在 Linux 上配置 Google Cloud's Agent for SAP

安装 Google Cloud 的 Agent for SAP 后，您可以根据情况配置代理以启用 Process Monitoring 指标和 Workload Manager 评估指标收集功能。默认情况下，只有 SAP Host Agent 指标收集功能处于启用状态。

只有 Linux 支持 Workload Manager 评估指标和 Process Monitoring 指标收集。

如果您启用 Workload Manager 评估指标和 Process Monitoring 指标收集功能，则需要满足以下前提条件：

• 为代理创建 IAM 服务账号以访问 Google Cloud 资源。向服务账号授予所需的 IAM 角色。如需了解详情，请参阅设置服务账号。
• 在裸金属解决方案服务器上，安装 gcloud CLI。如需了解详情，请参阅安装 gcloud CLI。
• 如需访问 Google Cloud，请向 gcloud CLI 授权。如需了解详情，请参阅向 gcloud CLI 授权。
• 与 Google Cloud API 建立连接。如需了解详情，请参阅配置适用于本地主机的专用 Google 访问通道。

设置服务账号

如需允许代理从裸金属解决方案环境访问 Google Cloud 资源，您需要设置 IAM 服务账号。

代理使用的服务账号必须至少具有 Monitoring Metric Writer (roles/monitoring.metricWriter) 角色。

如需创建服务账号，请按照以下步骤操作：

1. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Monitoring > Monitoring Metric Writer role to the service account.

      To grant the role, find the Select a role list, then select Monitoring > Monitoring Metric Writer.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

2. Create a service account key:

   1. In the Google Cloud console, click the email address for the service account that you created.
   2. Click Keys.
   3. Click Add key, and then click Create new key.
   4. Click Create. A JSON key file is downloaded to your computer.
   5. Click Close.

将 JSON 密钥文件上传到裸金属解决方案服务器上可供代理访问的安全位置。

启用 Process Monitoring 指标和 Workload Manager 评估指标收集功能

如需启用 Process Monitoring 指标和 Workload Manager 评估指标收集功能，请按照以下步骤操作：

1. 与裸金属解决方案服务器建立 SSH 连接。

2. 打开以下配置文件：

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

3. 在 collection_configuration 部分中，将以下参数设置为 true：

   • collect_process_metrics：允许代理收集 Process Monitoring 指标。对于 SAP HANA 数据库指标收集，如需访问和查询 SAP HANA 数据库，您需要在 hana_metrics_config 部分中设置其他参数。
   • collect_workload_validation_metrics：允许代理收集 Workload Manager 评估指标。

   如需详细了解这些参数，请参阅下表。

4. 保存配置文件。

5. 重启代理以使新设置生效。

   sudo systemctl restart google-cloud-sap-agent

配置参数

下表说明了 Google Cloud 的 Agent for SAP 版本 1 的配置参数。

参数
provide_sap_host_agent_metrics	Boolean 如需启用 SAP Host Agent 所需的指标收集功能，请指定 true。 默认值为 true。 除非有 Cloud Customer Care 或 SAP 支持团队的指导，否则请勿将 provide_sap_host_agent_metrics 设置为 false。
bare_metal	Boolean 在裸金属解决方案服务器上安装代理后时，请指定 true。默认值为 false。
log_level	String 如需设置代理的日志记录级别，请设置所需的值。可用的日志级别如下： DEBUG INFO WARNING ERROR 默认为 INFO。除非有 Cloud Customer Care 的指导，否则请勿更改日志记录级别。
log_to_cloud	Boolean 如需将代理的日志重定向到 Cloud Logging，请指定 true。默认值为 true。
cloud_properties.project_id	String 如果您的 SAP 系统在裸金属解决方案服务器上运行，请指定您用于裸金属解决方案的 Google Cloud 项目的 ID。 当代理在虚拟机实例上运行时，默认情况下，代理会自动检测项目 ID。
cloud_properties.instance_id	String 指定已安装代理的裸金属解决方案服务器的名称。
cloud_properties.region	String 如果您的 SAP 系统在裸金属解决方案服务器上运行，请指定裸金属解决方案服务器的区域。 当代理在虚拟机实例上运行时，默认情况下，代理会使用安装了该代理的虚拟机实例的区域。
cloud_properties.zone	String 当代理在虚拟机实例上运行时，默认情况下，代理会使用安装了该代理的虚拟机实例的可用区。
cloud_properties.image	String 指定实例的操作系统映像名称。 当代理在虚拟机实例上运行时，默认情况下，代理会检测安装了该代理的虚拟机实例的操作系统映像。
cloud_properties.numeric_project_id	String SAP 系统在其中运行的 Google Cloud 项目的数字 ID。 当代理在虚拟机实例上运行时，默认情况下，代理会自动检测数字项目 ID。
collection_configuration.collect_process_metrics	Boolean 如需启用 Process Monitoring 指标收集功能，请指定 true。 默认为 false。 此参数仅适用于 Linux。 如果您为 SAP HANA 启用 Process 指标收集，则需要设置 hana_metrics_config 下列出的其他参数。
collection_configuration.process_metrics_frequency	Int 指定 Process Monitoring 指标的收集频率（以秒为单位）。此参数的默认值为 5 秒。 虽然您可以更新 Process Monitoring 指标的收集频率，但我们建议您使用默认值。如果您需要修改默认值，请在 collection_configuration 部分下添加 process_metrics_frequency 参数并提供所需的值。
collection_configuration.hana_metrics_config.hana_db_user	String 指定代理用于查询 SAP HANA 的数据库用户账号。默认值为 SYSTEM。
collection_configuration.hana_metrics_config.hana_db_password	String 指定代理用于查询 SAP HANA 的数据库用户账号的纯文本密码。 我们建议您使用以下选项之一，而不是指定明文密码： hana_db_password_secret_name，您为其指定存储在 Secret Manager 中的 Secret。
collection_configuration.hana_metrics_config.hana_db_password_secret_name	String 为了安全地提供代理用于查询 SAP HANA 的数据库用户账号的密码，请指定包含数据库用户账号的安全凭据的 Secret 的名称。 重要提示：Secret 和主机虚拟机实例必须存在于同一 Google Cloud 项目中。 仅当您指定 hana_db_password_secret_name 或 hana_db_password 时，代理才会收集 SAP HANA 相关指标。
collection_configuration.hana_metrics_config.sid	String 指定 SAP HANA 实例的 SID。如果使用 HANA Userstore 密钥，请参阅 hdbuserstore_key 部分。
collection_configuration.collect_workload_validation_metrics	Boolean 如需启用 Workload Manager 评估指标收集功能，请指定 true。从 3.2 版开始，默认值为 true。 此参数仅适用于 Linux。
collection_configuration.workload_validation_metrics_frequency	Int Workload Manager 评估指标的收集频率（以秒为单位）。默认值为 300 秒。 我们建议您不要修改默认收集频率，因为这可能会影响整个功能本身。 如果您需要修改 Workload Manager 指标的收集频率，请在 collection_configuration 部分下添加 workload_validation_metrics_frequency 参数并提供所需的值。
collection_configuration.workload_validation_db_metrics_config.hana_db_user	String 指定用于查询 SAP HANA 实例的用户账号。 用户账号必须具有 SAP HANA 数据库的读取权限。
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String 指定存储用户账号密码的 Secret Manager 中的密文的名称。
collection_configuration.workload_validation_db_metrics_config.sid	String 指定 SAP HANA 实例的 SID。
collection_configuration.workload_validation_db_metrics_config.hostname	String 指定托管 SAP HANA 实例的机器（本地或远程）的标识符。支持的值如下： 如果主机是本地机器，则指定字符串 localhost 或 localhost 环回 IP 地址，例如 127.0.0.1。 如果主机是远程机器，则指定其内部或外部 IP 地址。
collection_configuration.workload_validation_db_metrics_config.port	String 指定 SAP HANA 实例接收查询的端口。对于第一个或唯一租户数据库实例，该端口为 3NN15，其中 NN 是 SAP HANA 实例的编号。
collection_configuration.workload_validation_db_metrics_frequency	Int 用于进行 Workload Manager 评估的 SAP HANA 数据库指标的收集频率（以秒为单位）。 默认值为 3600 秒。 虽然您可以更新 SAP HANA 数据库指标的收集频率，但我们建议您使用默认值。如果您需要修改默认值，请在 collection_configuration 部分下添加 workload_validation_db_metrics_frequency 参数并提供所需的值。切勿将收集频率设置为大于 3600 秒。

默认配置

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

配置示例

如需在裸金属解决方案服务器上安装代理，您需要将所需的参数添加到配置文件中。以下示例展示了一个用于在裸金属解决方案服务器上安装代理的已完成的配置文件。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_id": "bms-machine-1",
    "image": "rhel-8",
    "region": "us-central1"
  }
}

查看收集的指标

如需直观呈现代理收集的 Process Monitoring 指标，您可以使用 Google Cloud 提供的以下自定义信息中心：

• SAP 代理 - HANA 概览：此信息中心提供显示以下指标的状态概览的图表：SAP HANA 可用性、SAP HANA HA 可用性、SAP HANA HA 复制、SAP HANA 服务状态、HA 集群 - 节点状态和 HA 集群 - SAP 实例的资源状态。

  此信息中心的 JSON 文件为 sap-agent-status-overview.json。

• SAP 代理 - HANA 原始指标：此信息中心提供显示以下指标的原始指标值的图表：SAP HANA 可用性、SAP HANA HA 可用性、SAP HANA HA 复制、SAP HANA 服务状态、HA 集群 - 节点状态和 HA 集群 - SAP 实例的资源状态。

  此信息中心的 JSON 文件为 sap-agent-raw-metrics.json。

安装信息中心

如需安装自定义信息中心，请完成以下步骤：

Google Cloud 控制台

1. 在 Google Cloud 控制台中，前往 Monitoring 页面：

   进入 Monitoring

2. 在 Monitoring 导航面板中，点击信息中心。

3. 点击示例库标签页。

   

4. 如需过滤特定于代理的自定义信息中心，请在过滤条件字段中输入 Agent for SAP。

5. （可选）如需查看有关信息中心的详细信息或预览其内容，请点击预览。

6. 选择要安装的信息中心。

7. 点击导入，然后点击确认。

   信息中心会添加到 Google Cloud 项目中的可用信息中心。如需查看您的信息中心，请按照查看已安装的信息中心中的说明进行操作。

Google Cloud CLI

1. 打开 Cloud Shell：

   打开 Cloud Shell

2. 在 Cloud Shell 中，克隆或下载代码库：

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

3. 在 Cloud Shell 中，使用相应的 JSON 文件安装所需的信息中心：

   gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

   将 CONFIG_FROM_FILE 替换为包含信息中心配置的 JSON 文件的路径。信息中心配置文件可位于以下路径中：monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap。

   信息中心会添加到 Google Cloud 项目中的可用信息中心。如需查看您的信息中心，请按照查看已安装的信息中心中的说明进行操作。

查看已安装的信息中心

如需查看已安装的信息中心，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Monitoring 页面：

   进入 Monitoring

2. 在 Monitoring 导航面板中，点击信息中心。

3. 在列表中点击信息中心名称。

如果您有许多信息中心，则可以针对自定义信息中心或新信息中心的名称进行过滤。如需了解如何过滤此列表，请参阅查看自定义信息中心。

下图是一个示例，展示了 Monitoring 中 SAP HANA 指标的自定义信息中心的一部分。

问题排查

如需了解如何诊断和解决在安装和配置 Google Cloud's Agent for SAP 时可能遇到的问题，请参阅 Google Cloud's Agent for SAP 问题排查指南。

获取支持

如果您在解决 Google Cloud's Agent for SAP 的问题时需要帮助，请收集所有可用的诊断信息并与 Cloud Customer Care 联系。如需了解如何与 Customer Care 团队联系，请参阅获取 Google Cloud 上的 SAP 支持。