Google Cloud 的 SAP 代理功能的新变化

本文档列出了 Google Cloud 的 SAP 代理的重大更改。

Google Cloud 的 Agent for SAP 是 Google Cloud 代理的后续产品：Google Cloud 的 SAP NetWeaver 监控代理、Google Cloud 的 SAP HANA 监控代理和适用于 SAP HANA 的 Cloud Storage Backint 代理。

如果您使用的是上述任何 Google Cloud 代理，我们建议您尽快升级到使用 Google Cloud 的 Agent for SAP 3.5 版（最新版）。如需详细了解 Google Cloud 的 Agent for SAP，请参阅 Google Cloud 的 Agent for SAP 规划指南。

如需查看 SAP on Google Cloud 的所有公告，请参阅版本说明。

3.5 版

Google Cloud 的 Agent for SAP 3.5 版引入了以下各项：

• 支持使用 Workload Manager 为 SAP 工作负载设置可观测性。如需了解详情，请参阅 SAP 系统发现。

• 启用 SAP HANA 监控指标收集功能后，代理默认还会收集以下指标：

  • sap/hanamonitoring/transactions/blocked
  • sap/hanamonitoring/backups/data
  • sap/hanamonitoring/backups/log
  • sap/hanamonitoring/memory/unloads
  • sap/hanamonitoring/disk/readtime
  • sap/hanamonitoring/disk/writetime

  如需了解这些指标，请参阅 SAP HANA 监控指标。

• 增强的 Workload Manager 评估指标 sap/validation/hana。此指标会收集其他标签-值对，以支持与 SAP HANA 备份相关的 Workload Manager 评估。

• 在 Linux 上，您现在可以通过运行配置命令来停用和启用代理的 systemd 服务。如需了解详情，请参阅停用或启用代理。

• 修复了 Process Monitoring 指标 sap/hana/ha/availability 的行为。在辅助 SAP HANA 实例停止时，安装在该实例上的代理实例错误地报告此指标的值为 0。此问题现在已修复，可根据指标状态显示适当的值。如需了解详情，请参阅 Process Monitoring 指标中此指标的说明。

版本 3.4

Google Cloud 的 Agent for SAP 3.4 版引入了以下各项：

• 工作负载性能诊断：为了帮助 Cloud Customer Care 加快排查在 Google Cloud 上运行的 SAP 工作负载的任何性能问题，在 Google Cloud 的 Agent for SAP 中内置了一个性能诊断工具。

  如需了解详情，请参阅工作负载性能诊断。

• 与 Backint 相关的增强功能：从 3.4 版开始，您可以在 PARAMETERS.json 文件中指定 custom-time 参数。此参数设置上传到 Cloud Storage 的备份的 Custom-Time 元数据。如需了解详情，请参阅配置参数中的参数说明。

• 与磁盘快照相关的增强功能：从 3.4 版开始，您可以使用以下增强功能：

  • 运行 hanadiskbackup 命令时，您可以使用 -confirm-data-snapshot-after-create 参数指定何时向 SAP HANA 确认创建快照。如需了解详情，请参阅创建基于磁盘快照的备份中此参数的说明。

  • 运行 hanadiskrestore 命令时：

    • 代理可以自动检测托管 /hana/data 目录的磁盘。 这意味着，从 3.4 版开始，参数 -data-disk-name 和 -data-disk-zone 是可选参数。但是，如果您在运行 hanadiskrestore 命令时指定了这些参数，则它们会覆盖代理的自动检测。
    • 如果您要创建新磁盘来托管 /hana/data 目录，则可以指定 -labels-on-detached-disk 参数。这样一来，您就可以向在恢复期间分离的磁盘添加标签值对。
    • 您可以让代理将完成恢复操作所需的时长发送到 Cloud Monitoring。您可以使用 send_metrics_to_monitoring 布尔值参数来执行此操作。

    如需了解详情，请参阅磁盘恢复支持的参数。

3.3 版

Google Cloud 的 Agent for SAP 3.3 版引入了以下各项：

• 磁盘快照相关增强功能：从 3.3 版开始，当您通过运行 hanadiskbackup 命令创建基于磁盘快照的备份时，代理可以自动检测托管 /hana/data 目录的磁盘。

  这意味着，从 3.3 版开始，参数 -source-disk 和 -source-disk-zone 是可选参数。但是，如果您在运行 hanadiskbackup 命令时指定了这些参数，则它们会覆盖代理的自动检测。

• Backint 相关增强功能：

  • 如需支持备份生命周期管理等活动，您可以将键值对作为元数据与 Cloud Storage 存储桶中的备份文件相关联。为此，您可以在运行 configurebackint 命令时添加 metadata 参数。如需了解详情，请参阅配置参数。
  • 如需自动缩短 Cloud Storage 存储桶中文件的路径，您可以在运行 configurebackint 命令时指定 shorten_folder_path 布尔值参数。如需了解详情，请参阅配置参数。
  • 您可以让代理将 Backint 相关指标发送到 Cloud Monitoring。这些指标表示 Backint 操作期间上传和下载的文件的状态和吞吐量。您可以使用 send_metrics_to_monitoring 布尔值参数来执行此操作。如需了解详情，请参阅 Backint 指标收集。
  • 在测试代理的 Backint 相关自行诊断工具时，您可以使用可选参数 diagnose_file_max_size_gb 和 diagnose_tmp_directory。如需了解这些参数，请参阅配置参数。

• 支持基于 hdbuserstore 密钥的身份验证：如需对代理用于查询 SAP HANA 数据库的数据库用户账号进行身份验证，您可以指定 hdbuserstore_key 配置参数的 hdbuserstore 密钥。执行以下操作时，此选项可用：

  • 创建基于磁盘快照的备份
  • 配置 Process Monitoring 指标收集
  • 配置 Workload Manager 评估指标收集
  • 配置 SAP HANA 监控指标收集

3.2 版

Google Cloud 的 Agent for SAP 3.2 版引入了以下各项：

• 默认免费收集 Workload Manager 评估指标：

  • 从 3.2 版开始，系统会默认启用新安装的代理来收集 Workload Manager 评估指标。收集这些指标不会产生任何费用。但是，您仍需要执行其他配置，以使代理收集 Workload Manager 评估指标。
  • 如果您要更新到 3.2 版，则如需收集 Workload Manager 评估指标，您需要为相关服务账号提供 Workload Manager Insights Writer (roles/workloadmanager.insightWriter) 角色。

  如需了解详情，请参阅配置 Workload Manager 评估指标收集。

• 配置命令：从 3.2 版开始，除了手动修改配置文件并重启代理，您还可以使用命令来配置代理并自动重启代理。如需了解详情，请参阅 Google Cloud 的 Agent for SAP 的配置命令。

• Backint 相关增强功能：

  • 通过将 xml_multipart_upload 参数与 parallel_streams 参数结合使用，您可以启用将备份并行上传到具有保留政策的 Cloud Storage 存储桶的功能。
  • 将备份上传到 Cloud Storage 存储桶时，您可以使用 storage_class 参数指定与上传的备份关联的存储类别。

  如需了解 Backint 配置参数，请参阅配置参数。

• 与磁盘快照相关的增强功能：从 3.2 版开始，在创建基于磁盘快照的备份时：

  • 您可以将 labels 参数与 hanadiskbackup 命令搭配使用，以将标签值对与快照相关联。如需了解详情，请参阅创建基于磁盘快照的备份。
  • 默认情况下，代理不会冻结或取消冻结 /hana/data 卷。如需了解详情，请参阅创建基于磁盘快照的备份。

• 新的 Process Monitoring 指标：sap/pacemaker 和 sap/hana/volumes。如需了解详情，请参阅 Process Monitoring 指标。

3.1 版

Google Cloud 的 Agent for SAP 3.1 版有以下新增内容：

• 引入了 enable_workload_discovery 和 enable_discovery 配置参数，用于发现 SAP 系统信息。这些参数使代理可以收集有关在虚拟机或裸金属解决方案服务器上运行的 SAP 产品的信息。如需了解详情，请参阅适用于您的场景的代理安装指南。
• 引入了 folder_prefix 和 recovery_folder_prefix 参数，用于代理的 Backint 功能。这些参数可让您在同一个 Cloud Storage 存储桶中整理多个 SAP HANA 系统的备份。如需了解详情，请参阅为 SAP HANA 配置基于 Backint 的备份和恢复。

3.0 版

注意：Google Cloud 的 Agent for SAP 3.0 版是适用于 SAP HANA 的 Cloud Storage Backint 代理的后续版本。

Google Cloud 的 Agent for SAP 3.0 版引入了以下功能：

• 使用 Backint 为 SAP HANA 执行备份和恢复：从 3.0 版开始，您可以使用代理的 Backint 功能为 SAP HANA 数据库执行备份和恢复。此功能适用于在 Google Cloud、裸金属解决方案、本地或其他云服务平台上运行的 SAP HANA 系统。如需详细了解代理的此功能，请参阅使用 Backint 为 SAP HANA 执行备份和恢复。
• 使用磁盘快照为 SAP HANA 执行备份和恢复：从 3.0 版开始，您可以使用代理的磁盘快照功能为在 Google Cloud 上运行的 SAP HANA 数据库执行备份和恢复。如需详细了解此功能，请参阅使用磁盘快照为 SAP HANA 执行备份和恢复。
• 收集一组最新的 Workload Manager 评估指标：从 3.0 版开始，启用该功能时，代理会收集一组最新的 Workload Manager 评估指标，而无需您更新代理。因此，这可让您根据 Workload Manager 中引入的任何新最佳实践无缝地评估 SAP 系统。如果您需要停用此行为，请将 fetch_latest_config 配置参数设置为 false。

如需详细了解 Google Cloud 的 Agent for SAP 3.0 版，请参阅 Google Cloud 的 Agent for SAP 规划指南。

2.8 版

Google Cloud 的 Agent for SAP 2.8 版还会收集 Google Cloud Hyperdisk 卷的 SAP Host Agent 指标 Guaranteed IOPS 和 Guaranteed Throughput。

版本 2.7

Google Cloud 的 Agent for SAP 2.7 版引入了以下各项：

• 修复了对包含特殊字符的 SAP HANA 数据库密码的处理。根据 SAP 的要求，现在使用英文双引号进行编码。
• 与 TCP 网络相关的 sap/networkstats 系列 Process Monitoring 指标。如需了解详情，请参阅 Process Monitoring 指标。
• 如需直观呈现代理版本 2.0 或更高版本收集的 SAP HANA 监控指标，请参阅 Agent for SAP - HANA 详细概览和 Agent for SAP - HANA 性能信息中心。如需了解这些信息中心，请参阅查看收集的指标。

版本 2.6

Google Cloud 的 Agent for SAP 2.6 版引入了以下各项：

• 针对与 SAP HANA 和 Pacemaker 实例相关的 Workload Manager 评估指标收集的修复。
• 从此版本开始，对于在裸金属解决方案服务器上运行的代理实例，代理配置属性 instance_id 已替换为参数 instance_name。如需了解详情，请参阅安装代理。

• 针对 Process Monitoring 指标收集的配置参数更新：

  • process_metrics_frequency：从 2.6 版开始，此参数决定了以下快速变化的 Process Monitoring 指标的收集频率：sap/hana/availability、sap/hana/ha/availability 和 sap/nw/availability。所有其他进程监控指标现在称为缓慢变化的进程监控指标。
  • slow_process_metrics_frequency：此参数决定了所有其他 Process Monitoring 指标的收集频率。
  • process_metrics_to_skip：此参数决定了代理跳过收集的 Process Monitoring 指标。此参数接受 Process Monitoring 指标名称的英文逗号分隔值。例如："process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]。

  如需详细了解与收集 Process Monitoring 指标相关的配置参数，请参阅：

  • 对于 Compute Engine 虚拟机上的代理实例，请参阅配置参数。
  • 对于裸金属解决方案服务器上的代理实例，请参阅配置参数。

版本 2.5

Google Cloud 的 Agent for SAP 2.5 版引入了以下各项：

• 新指标 sap/validation/hanasecurity，指示收集 SAP HANA 数据库指标以进行 Workload Manager 评估。如需了解详情，请参阅 Workload Manager 评估指标。
• 使用 sapcontrol 的 SOAP 接口收集 Process Monitoring 指标的增强功能。
• 为了收集 Process Monitoring 指标，SAP 系统发现中添加了用于忽略注释的条目的修复。

版本 2.4

Google Cloud 的 Agent for SAP 2.4 版包含针对 Workload Manager 评估指标 sap/validation/corosync 收集的 bug 修复。

2.3 版

Google Cloud 的 Agent for SAP 2.3 版包含针对 SAP 系统发现向 Cloud Logging 发送数据的 bug 修复。

版本 2.2

Google Cloud 的 Agent for SAP 2.2 版包含针对 SAP 系统发现的 bug 修复。

2.1 版

Google Cloud 的 Agent for SAP 2.1 版本包含以下功能和 bug 修复：

• SAP 系统发现：识别与 SAP 系统相关的所有 Google Cloud Platform 资源，并将此信息发送到 Cloud Logging。
• 支持包功能：有助于收集必要的信息（例如日志和错误字符串），以提高可支持性。
• Workload Manager 评估指标收集中的 bug 修复。

2.0 版

注意：Google Cloud 的 Agent for SAP 2.0 版是 SAP HANA 监控代理版本 2 的替代产品。

Google Cloud 的 Agent for SAP 2.0 版引入了以下功能：

• SAP HANA 监控指标收集：在 Linux 上，您可以配置 Google Cloud 的 Agent for SAP 来收集 SAP HANA 监控指标。这些指标可让您了解 SAP HANA 实例和底层基础架构的性能、可用性和健康状况。如需了解详情，请参阅 SAP HANA 监控指标。

如需详细了解 Google Cloud 的 Agent for SAP 2.0 版，请参阅 Google Cloud 的 Agent for SAP 规划指南。

1.6 版

Google Cloud 的 Agent for SAP 1.6 版包含以下 bug 修复：

• 修复了从所有适用的实例类型（ASCS 和 ERS）收集 Process Monitoring 指标 /sap/nw/enq/locks/usercountowner 的问题。
• 修复了访问在裸金属解决方案服务器上运行的代理实例的 cloud_properties 配置的问题。

1.5 版

Google Cloud 的 Agent for SAP 1.5 版包括以下问题修复：

• 修复了 Linux 上的代理实例，以始终覆盖 systemd 服务文件内容，这可确保代理功能在版本更新期间按预期工作。
• 修复了解析命令退出代码时的 Linux 命令行执行问题。此修复可防止代理在某些边缘情况下关停。

版本 1.4

Google Cloud 的 Agent for SAP 1.4 版包括以下问题修复和功能：

• 添加了一个新的 startdaemon 子命令，用于在守护程序模式下运行代理。
  • 此更改不会影响代理的正常运行。
• 防止在更新期间覆盖对代理配置文件的更改。
• 修复了向 Cloud Logging 发送时间值日志的问题。
• 修复了 Workload Manager 维护模式和 Process Monitoring 指标 sap/nw/abap/sessions 的收集问题。
• 代理可以收集的新指标：
  • /sap/nw/enq/locks/usercountowner：一个 Process Monitoring 指标，用于监控 SAP NetWeaver 系统中的排队锁定。

1.3 版

Google Cloud 的 Agent for SAP 1.3 版包括以下问题修复和功能：

• 修复了与 SAP HANA 相关的 Workload Manager 评估指标的收集问题。
• 现在，默认情况下，代理的日志会重定向到 Cloud Logging。您不再需要对此进行任何配置。
• Process Monitoring 指标中的问题修复，使用 REPLICATION_MODE 来确定 SAP HANA 节点是主节点还是辅助节点。这可以提高 HANA 辅助系统的指标准确率。

1.2 版

Google Cloud 的 Agent for SAP 1.2 版包括以下问题修复和功能：

• Process Monitoring 指标现在会考虑 enq_replicator 和 enq_server 服务的状态来确定 SAP NetWeaver 实例的可用性。
• 代理可以收集的新指标：
  • /sap/infra/migration：基础架构迁移指标，用于指示虚拟机实例是否正在进行实时迁移。
  • /sap/agent/health：显示 Cloud Monitoring 中代理运行状况的指标。
  • /sap/agent/cpu/utilization 和 /sap/agent/memory/utilization：这些 Cloud Monitoring 指标允许您监控代理使用的 CPU 和内存资源。

版本 1.1

Google Cloud 的 Agent for SAP 1.1 版修复了与 Workload Manager 评估相关的 bug，从 Linux 操作系统指标值中删除英文双引号。

版本 1.0

Google Cloud 的 SAP 代理 1.0 版引入了以下功能：

• SAP Host Agent 指标的集合：Google Cloud 的 SAP 代理会收集 SAP 要求的所有必要信息，并将其发送到 SAP Host Agent。如需了解详情，请参阅 SAP Host Agent 指标。

• Process Monitoring 指标收集：在 Linux 上，您可以配置 Google Cloud 的 SAP 代理，以收集 SAP 应用的 Process Monitoring 指标及其运行时状态。此信息可帮助您排查与 SAP 工作负载相关的问题。如需了解详情，请参阅 Process Monitoring 指标。

• Workload Manager 评估指标收集：在 Linux 上，您可以将 Google Cloud 的 Agent for SAP 配置为收集为 SAP 工作负载启用 Workload Manager 服务所需的 Workload Manager 评估指标。如需了解详情，请参阅 Workload Manager 评估指标。