在 Compute Engine 实例上安装和配置 Google Cloud 的 Agent for SAP

Version 3.6 (latest)

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

若要为 Google Cloud 上运行的 SAP 系统（包括 SAP NetWeaver、SAP HANA、SAP ASE、SAP MaxDB 等）提供 SAP 支持，需要使用 Google Cloud's Agent for SAP。

在 Compute Engine 实例上安装 Google Cloud 的 Agent for SAP 时，对于 SAP Host Agent 指标，代理会整合来自 Cloud Monitoring 和 Compute Engine API 的监控数据，并将这些数据提供给 SAP Host Agent。

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

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

如需了解 Google Cloud 的 Agent for SAP 支持的操作系统，请参阅支持的操作系统。

如需在裸金属解决方案服务器上安装和配置 Google Cloud 的 Agent for SAP 3.6 版（最新版），请参阅在裸金属解决方案服务器上安装 Google Cloud 的 Agent for SAP。

安装概览

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

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

在 Windows 上，您可以使用 GooGet 软件包管理命令 googet 安装 Google Cloud 的 Agent for SAP。软件包管理命令可完成以下任务：

• 下载最新版本的 Google Cloud's Agent for SAP。

• 创建一项名为 google-cloud-sap-agent 的 Windows 服务以及每分钟运行一次的计划任务，以检查服务是否仍在运行，并在必要时重启服务。

  警告：请勿手动停止 Windows 服务或删除计划任务。

代理的前提条件

在安装 Google Cloud's Agent for SAP之前，您需要确保满足以下前提条件。

设置所需的 IAM 角色

Google Cloud 的 Agent for SAP 使用的服务账号必须至少具有 Compute Viewer (roles/compute.viewer)、Monitoring Viewer (roles/monitoring.viewer) 和 Workload Manager Insights Writer (roles/workloadmanager.insightWriter) 角色。

如需向您的服务账号添加所需的角色，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，转到 IAM 页面。

   转到 IAM

2. 选择您的 Google Cloud 项目。

3. 确定要向其添加角色的服务账号。

   • 如果该服务账号不在主账号列表中，则表明还没有为它分配任何角色。点击添加，然后输入该服务账号的电子邮件地址。
   • 如果该服务账号已经在主账号列表中，则表明它已具有角色。点击要修改的服务账号对应的修改按钮。

4. 从可用角色列表中选择所需角色：

   • Compute Engine > Compute Viewer
   • Monitoring > Monitoring Viewer
   • Workload Manager > Workload Manager Insights Writer

5. 点击添加或保存，将相应角色应用于该服务账号。

启用对 Google Cloud API 的访问权限

Compute Engine 建议将计算实例配置为允许对所有 Cloud API 的所有访问权限范围，并且仅使用实例服务账号的 IAM 权限来控制对 Google Cloud 资源的访问。如需了解详情，请参阅创建使用用户管理的服务账号的虚拟机。

如果您限制了对 Cloud API 的访问权限，则 Google Cloud 的 Agent for SAP 要求主机 Compute Engine 实例具有以下最小 Cloud API 访问权限范围：

• Cloud Platform：已启用
• Compute Engine：只读
• Stackdriver Monitoring API：只读

如果您是在没有外部 IP 地址的计算实例上运行 SAP 应用，则需要对该计算实例的子网启用专用 Google 访问通道 ，以便 Google Cloud's Agent for SAP 可以访问 Google API 和服务。如需在子网上启用专用 Google 访问通道，请参阅配置专用 Google 访问通道。

安装代理

如需在 Compute Engine 实例上安装 Google Cloud 的 Agent for SAP，请选择您的操作系统，然后完成以下步骤。

注意： 如需在多个计算实例上安装代理，请从 Agent for SAP 虚拟机管理器政策下载所需操作系统政策的 YAML 文件，然后使用它创建和发布操作系统政策分配任务。

Linux

如需在 Compute Engine 实例上安装代理，请按照以下步骤操作：

1. 与计算实例建立 SSH 连接。
2. 在您的终端中，通过运行特定于您的操作系统的命令来安装此代理：
   • （推荐）如需安装代理 3.6 版（最新版），请运行以下命令：

     RHEL

     sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
     [google-cloud-sap-agent]
     name=Google Cloud Agent for SAP
     baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
     EOM
     sudo yum install google-cloud-sap-agent

     SLES15

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent

     SLES 12

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent

   • 如需安装代理的特定版本，请运行以下命令：

     RHEL

     sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
     [google-cloud-sap-agent]
     name=Google Cloud Agent for SAP
     baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
     EOM
     sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     SLES15

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     SLES 12

     sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
     sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     将 VERSION_NUMBER 替换为您要安装的代理的版本号，例如 3.1-606637668。如需了解您可以安装的代理版本，请参阅列出代理的所有可用版本。

     如需了解如何将代理降级到特定版本，请参阅降级 Google Cloud 的 Agent for SAP。

Windows

如需在 Compute Engine 实例上安装代理，请按照以下步骤操作：

1. 使用 RDP 连接到计算实例。
2. 以管理员身份从 PowerShell 运行以下命令：

   googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows
   googet install google-cloud-sap-agent

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

验证代理安装

如需验证代理正在运行，请选择您的操作系统，然后按照以下步骤操作：

Linux

1. 与您的 Compute Engine 实例建立 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
   

3. 在 SLES 映像上，为了确保您使用的是最新版本的 Google Cloud 的 Agent for SAP，请运行以下命令。

   注意：Google Cloud 的 Agent for SAP 与 RHEL、15 SP4 及更高版本的 SLES 的所有“for SAP”映像捆绑在一起。由于 SLES for SAP 映像每季度更新一次，因此与这些操作系统映像捆绑在一起的代理版本可能不是最新版本。以下命令会将代理实例更新为 Google Cloud 提供的最新版本。

   sudo zypper remove google-cloud-sap-agent
   sudo zypper addrepo -p 98 --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent
   sudo zypper install google-cloud-sap-agent

Windows

1. 使用 RDP 连接到 Compute Engine 实例。

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

   $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status

   如果代理正在运行，则状态会显示 Running。

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

验证 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 的 SAP for Agent 后，您可以通过执行以下配置来启用该代理的其他功能。默认情况下，SAP Host Agent 指标和 Workload Manager 评估指标收集功能处于启用状态。

只有 Linux 支持以下功能。Windows 不支持这些功能。

• 配置进程监控指标收集
• 配置 Workload Manager 评估指标收集
• 配置 SAP HANA 监控指标收集。
• 为 SAP HANA 配置基于 Backint 的备份和恢复。
• 使用磁盘快照备份和恢复 SAP HANA。

默认配置文件

以下代码段是 Google Cloud 的 Agent for SAP 3.6 版（最新版）的默认配置示例：

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

如需查看特定于功能的示例配置文件，请参阅该功能的配置指南。

配置参数

下表介绍了在 Compute Engine 实例上运行的 Google Cloud 的 Agent for SAP 的配置参数，包括与指标收集相关的参数。如需了解与代理的 Backint 功能相关的配置参数，请参阅配置参数。

参数
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。 当代理在 Compute Engine 实例上运行时，默认情况下，代理会自动检测项目 ID。
cloud_properties.instance_name	String 指定 Compute Engine 实例的名称。代理会在安装时自动检测此名称。
cloud_properties.region	String 如果您的 SAP 系统在裸金属解决方案服务器上运行，请指定裸金属解决方案服务器的区域。 当代理在计算实例上运行时，默认情况下，代理会使用计算实例部署所在的区域。
cloud_properties.zone	String 当代理在计算实例上运行时，默认情况下，代理会使用部署计算实例的可用区。
cloud_properties.image	String 指定实例的操作系统映像名称。 当代理在计算实例上运行时，默认情况下，代理会自动检测计算实例使用的操作系统映像。
cloud_properties.numeric_project_id	String 指定运行 SAP 系统的 Google Cloud 项目的数字 ID。 当代理在计算实例上运行时，默认情况下，代理会自动检测项目编号。
discovery_configuration.enable_workload_discovery	Boolean 如需让代理收集主机上运行的 SAP 产品的名称和版本，请指定 true。默认值为 true。 如需了解详情，请在 google-cloud-sap-agent GitHub 代码库中的 GoogleCloudPlatform/sapagent 下查看该代理的代码库。
discovery_configuration.enable_discovery	Boolean 如需将代理收集的有关主机上运行的 SAP 产品的信息发送到 Cloud Logging，请指定 true。默认值为 true。 如果您指定值 false，则代理会将收集的信息存储在主机上，并且不会将其发送到 Cloud Logging。
collection_configuration.collect_process_metrics	Boolean 如需启用 Process Monitoring 指标收集功能，请指定 true。 默认为 false。 此参数仅适用于 Linux。 如果您为 SAP HANA 启用 Process 指标收集，则需要设置 hana_metrics_config 下列出的其他参数。
collection_configuration.process_metrics_frequency	Int 从 2.6 版开始，此参数决定了快速变化的 Process Monitoring 指标的收集频率（以秒为单位）。快速变化的 Process Monitoring 指标包括：sap/hana/availability、sap/hana/ha/availability 和 sap/nw/availability。 此参数的默认值为 5 秒。我们建议您使用此默认值。 所有其他（缓慢变化的）Process Monitoring 指标按默认频率 30 秒收集。如需更改缓慢变化的 Process Monitoring 指标的收集频率，请使用参数 slow_process_metrics_frequency。
collection_configuration.slow_process_metrics_frequency	Int 指定缓慢变化的 Process Monitoring 指标的收集频率（以秒为单位）。 此参数的默认值为 30 秒。
collection_configuration.process_metrics_to_skip	Array 指定您不希望代理收集的 Process Monitoring 指标。此参数接受 Process Monitoring 指标名称的英文逗号分隔值。例如："process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]。
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。 hdbuserstore_key，您为其指定 hdbuserstore 密钥。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 hana_db_password 参数，而 hana_db_password 参数优先于 hana_db_password_secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
collection_configuration.hana_metrics_config.hana_db_password_secret_name	String 为了安全地提供代理用于查询 SAP HANA 的数据库用户账号的密码，请指定包含数据库用户账号的安全凭据的 Secret 的名称。 重要提示：Secret 和主机 Compute Engine 实例必须位于同一 Google Cloud 项目中。 仅当您指定 hana_db_password_secret_name、hdbuserstore_key 或 hana_db_password 时，代理才会收集 SAP HANA 相关指标。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 hana_db_password 参数，而 hana_db_password 参数优先于 hana_db_password_secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
collection_configuration.hana_metrics_config.hdbuserstore_key	String 如需安全地连接到 SAP HANA 系统，请指定您为该系统创建的安全用户存储区 (hdbuserstore) 密钥。 如需使用 hdbuserstore 密钥进行身份验证，请确保满足以下条件： SAP 工具 hdbsql 和 hdbuserstore 安装在托管代理的计算实例上。 hdbuserstore 密钥对应于一个特定的 SAP HANA 实例。您无法使用包含多个 SAP HANA 实例主机名的密钥。 SIDadm 用户可以使用此密钥查询 SAP HANA 数据库。其中，SID 是指您为 sid 参数指定的值。您可以通过以 SIDadm 用户身份运行以下命令来验证这一点： hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY" 此配置参数从代理版本 3.3 开始受支持。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 hana_db_password 参数，而 hana_db_password 参数优先于 hana_db_password_secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
collection_configuration.hana_metrics_config.sid	String 指定 SAP HANA 实例的 SID。 如果您使用 hdbuserstore 密钥对 SAP HANA 进行身份验证，请参阅 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_collection_definition.fetch_latest_config	Boolean 可选。默认值为 true，该值可让代理收集一组最新的 Workload Manager 评估指标，而无需更新代理。如果要关闭此行为，请在配置文件中指定此参数并将其值设置为 false。
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	String 指定用于查询 SAP HANA 实例的用户账号的密码。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 hana_db_password 参数，而 hana_db_password 参数优先于 hana_db_password_secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name	String 指定存储用户账号密码的 Secret Manager 中的密文的名称。 或者，您可以指定 hdbuserstore_key 配置参数，以对指定的 SAP HANA 用户进行身份验证。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 hana_db_password 参数，而 hana_db_password 参数优先于 hana_db_password_secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key	String 如需安全地连接到 SAP HANA 系统，请指定您为该系统创建的安全用户存储区 (hdbuserstore) 密钥。 如需使用 hdbuserstore 密钥进行身份验证，请确保满足以下条件： SAP 工具 hdbsql 和 hdbuserstore 安装在托管代理的计算实例上。 hdbuserstore 密钥对应于一个特定的 SAP HANA 实例。您无法使用包含多个 SAP HANA 实例主机名的密钥。 SIDadm 用户可以使用此密钥查询 SAP HANA 数据库。其中，SID 是指您为 sid 参数指定的值。您可以通过以 SIDadm 用户身份运行以下命令来验证这一点： hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY" 此配置参数从代理版本 3.3 开始受支持。 如果您指定 hdbuserstore_key，则可以跳过指定 hostname 和 port 参数。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 hana_db_password 参数，而 hana_db_password 参数优先于 hana_db_password_secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
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 秒。
hana_monitoring_configuration.enabled	Boolean 可选。如需使 Google Cloud's Agent for SAP 能够收集 SAP HANA 监控指标，请指定 true。默认值为 false。 仅当您指定 hana_monitoring_configuration.enabled: true 时，以下子参数才适用。
hana_monitoring_configuration.sample_interval_sec	Int 可选。指定采样时间间隔（以秒为单位），用于确定 Google Cloud's Agent for SAP 查询 SAP HANA 实例以收集 SAP HANA 监控指标的频率。默认值为 300 秒。 对于在 Google Cloud 的 Agent for SAP 的配置文件中定义的每个查询，您可以通过为参数 sample_interval_sec 指定所需的时间间隔来覆盖全局采样时间间隔。采样时间间隔必须至少为 5 秒。
hana_monitoring_configuration.query_timeout_sec	Int 可选。指定对 SAP HANA 实例执行的每个查询的超时时间。 默认值为 300 秒。
hana_monitoring_configuration.execution_threads	Int 可选。指定用于将查询发送到 SAP HANA 实例的线程数。每个查询都在其自己的线程上运行。默认值为 10。
hana_monitoring_configuration.hana_instances.name	String 指定 SAP HANA 实例的名称标识符。
hana_monitoring_configuration.hana_instances.sid	String 指定 SAP HANA 实例的 SID。此字符串会作为标签添加到查询 SAP HANA 实例时生成的所有指标。
hana_monitoring_configuration.hana_instances.host	String 指定托管 SAP HANA 实例的机器（本地或远程）的标识符。支持的值如下： 如果主机是本地机器，则指定字符串 localhost 或 localhost 环回 IP 地址，例如 127.0.0.1。 如果主机是远程机器，则指定其内部或外部 IP 地址。
hana_monitoring_configuration.hana_instances.port	String 指定 SAP HANA 实例接收查询的端口。对于第一个或唯一租户数据库实例，该端口为 3NN15，其中 NN 是 SAP HANA 实例的编号。
hana_monitoring_configuration.hana_instances.user	String 指定用于查询 SAP HANA 实例的用户账号。 确保此用户具有读取 SAP HANA 数据库中的监控视图的权限。如果未授予此权限，则与监控视图相关的 SAP HANA 监控指标将不包含任何数据。
hana_monitoring_configuration.hana_instances.password	String 可选。以纯文本形式指定密码，用于对查询 SAP HANA 实例的用户账号进行身份验证。 对于身份验证，您必须指定以下其中一项： 为参数 password 指定明文密码。 （推荐）如果您使用 Secret Manager 将密码存储为密文，则必须为参数 secret_name 指定相应的密文名称。 （推荐）参数 hdbuserstore_key 的 hdbuserstore 密钥。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 password 参数，而 password 参数优先于 secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
hana_monitoring_configuration.hana_instances.secret_name	String 可选。指定存储用户账号密码的 Secret Manager 中的密文的名称。 对于 SAP HANA 身份验证，代理使用以下优先级顺序：如果指定，hdbuserstore_key 配置参数优先于 password 参数，而 password 参数优先于 secret_name 参数。我们建议您在配置文件中仅设置一个身份验证选项。
hana_monitoring_configuration.hana_instances.hdbuserstore_key	String 如需安全地连接到 SAP HANA 系统，请指定您为该系统创建的安全用户存储区 (hdbuserstore) 密钥。 如需使用 hdbuserstore 密钥进行身份验证，请确保满足以下条件： SAP 工具 hdbsql 和 hdbuserstore 安装在托管代理的计算实例上。 hdbuserstore 密钥对应于一个特定的 SAP HANA 实例。您无法使用包含多个 SAP HANA 实例主机名的密钥。 SIDadm 用户可以使用此密钥查询 SAP HANA 数据库。其中，SID 是指您为 sid 参数指定的值。您可以通过以 SIDadm 用户身份运行以下命令来验证这一点： hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY" 此配置参数从代理版本 3.3 开始受支持。 如果您指定 hdbuserstore_key，则可以跳过指定 host 和 port 参数。
hana_monitoring_configuration.hana_instances.enable_ssl	Boolean 可选。指定是否在 SAP HANA 实例中启用 SSL。默认值为 false。
hana_monitoring_configuration.hana_instances.host_name_in_certificate	String 如果您为 SAP HANA 实例指定 enable_ssl: true，则必须指定在 SSL 证书中设置的主机名。
hana_monitoring_configuration.hana_instances.tls_root_ca_file	String 如果您为 SAP HANA 实例指定 enable_ssl: true，则必须指定安全证书的路径。
hana_monitoring_configuration.queries.enabled	Boolean 可选。如需为所有 SAP HANA 实例启用 SQL 查询，请为该 SQL 查询的参数 enabled 指定值 true。
hana_monitoring_configuration.queries.name	String 如果您已在配置文件中定义了自定义查询，则必须为每个自定义查询指定唯一的名称。 查询名称必须是唯一的，因为它用于在 Monitoring 中构建指标的默认网址。
hana_monitoring_configuration.queries.sql	String 指定代理向 SAP HANA 实例发出的 SQL 语句。 SQL 语句必须符合 SAP 在 SAP HANA SQL 和系统视图参考文档中定义的 SQL 语法。
hana_monitoring_configuration.queries.sample_interval_sec	Int 可选。指定 SQL 查询的采样时间间隔。这会替换全局采样时间间隔。该值必须至少为 5 秒。
hana_monitoring_configuration.queries.columns.name	String 指定唯一标识每一列的名称。 列名称必须是唯一的，因为它用于在 Monitoring 中构建指标的默认网址。
hana_monitoring_configuration.queries.columns.metric_type	String 为了让 Monitoring 进行处理，请指定以下指标类型之一：METRIC_LABEL、METRIC_GAUGE 或 METRIC_CUMULATIVE。 METRIC_LABEL 类型的指标会作为标签附加到向 Monitoring 发送的所有 METRIC_GAUGE 和 METRIC_CUMULATIVE 指标。
hana_monitoring_configuration.queries.columns.value_type	String 为了让 Monitoring 进行处理，请指定指标类型支持的数据类型。 支持的数据类型如下：VALUE_BOOL、VALUE_INT64、VALUE_STRING 或 VALUE_DOUBLE。如需了解详情，请参阅支持的组合。
hana_monitoring_configuration.queries.columns.name_override	String 可选。为了让 Monitoring 进行处理，请指定要在指标网址中显示的路径，而不是查询名称和列名称。例如： 指标的默认网址： workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME 使用自定义路径的指标网址： workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

问题排查

如需了解如何诊断和解决在安装和配置 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 支持。