Google Cloud 的 Agent for SAP 的新变化

本文档列出了 Google Cloud的 Agent for 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.8 版（最新版）。如需详细了解Google Cloud的 Agent for SAP，请参阅Google Cloud的 Agent for SAP 规划指南。

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

3.8 版

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

• 监控增强功能：

  • 为了改进对 Linux 系统进程的内存用量的监控，我们引入了 Process Monitoring 指标的“计算资源”类别。

  • 为了改进对 SAP HANA 的内存用量的监控，我们引入了以下指标：

    • sap/hana/log/utilisationkb：此 Process Monitoring 指标指定 SAP HANA 日志卷正在使用的磁盘可用空间 (KB)。
    • sap/hanamonitoring/fast_restart_enabled：此 SAP HANA 监控指标指定是否已启用 SAP HANA 快速重启选项。
    • sap/hanamonitoring/logshipping_max_retention_size：此 SAP HANA 监控指标提供有关 logshipping_max_retention_size SAP HANA 参数的信息。

  如需了解详情，请参阅 Process Monitoring 指标和 SAP HANA 监控指标中的指标说明。

• 可支持性增强功能：为了帮助您和 Cloud Customer Care 更好地排查 SAP 工作负载的问题，supportbundle 命令的输出包含以下方面的信息：

  • 在计算实例上运行的 SAP 产品和相关组件。这些信息可让 Customer Care 更好地了解 SAP 系统的角色和配置。
  • 预定义 SAP 事件发生情况以及 Process Monitoring 和 SAP HANA 监控指标值的变化。

  如需了解详情，请参阅支持软件包。

3.7 版

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

• 支持为 SAP HANA 横向扩容系统执行基于磁盘快照的备份和恢复：您可以使用代理的磁盘快照功能来备份和恢复不使用主机自动故障切换解决方案的 SAP HANA 横向扩容系统。如需了解详情，请参阅使用磁盘快照为 SAP HANA 执行备份和恢复。
• SAP HANA 监控增强功能：
  • 对于多租户 SAP HANA 系统，您可以设置租户特有的监控。对于采用主动/主动（启用读取）配置部署的 SAP HANA 高可用性系统，您可以设置节点特有的监控。如需了解详情，请参阅多租户和高可用性系统的监控。
  • 我们引入了与备份相关的其他指标。如需了解详情，请参阅 SAP HANA 监控指标中属于 sap/hanamonitoring/backups/logs/、sap/hanamonitoring/backups/data/ 和 sap/hanamonitoring/backups/catalog/ 系列的指标的说明。

• 针对 Pacemaker 配置的 Workload Manager 评估的增强功能：代理会在 sap/validation/pacemaker 指标系列中收集更多 Workload Manager 评估指标。这些指标可让您对 Pacemaker 管理的高可用性集群的配置执行更多评估。

  如需了解引入的评估，请参阅适用于 SAP 的 Workload Manager 最佳实践中属于“SAP 高可用性”类别的最佳实践。

• 验证代理功能的 Google Cloud 设置：通过运行代理的 status 命令，您可以验证 Google Cloud中的设置是否已完成，可以使用代理功能。此命令会指示代理是否已根据需要配置，是否已向服务账号授予所需的 IAM 权限，以及是否已向主机 Compute Engine 实例授予访问 Cloud API 所需的范围。

  如需了解详情，请参阅代理文档中的配置指南。例如，如需了解如何验证 Process Monitoring 指标收集的 Google Cloud设置，请参阅验证 Process Monitoring 指标收集的设置。

• 支持在信息中心上将 SAP 事件显示为注解：您可以通过在 Cloud Monitoring 信息中心和预定义的可观测性信息中心内将特定 SAP 系统事件显示为注解来设置对这些事件的监控。如需了解详情，请参阅在 Cloud Monitoring 信息中心上显示 SAP 事件。

• Backint 相关增强功能：代理 3.7 版引入了以下配置参数，用于基于 Backint 的 SAP HANA 备份和恢复：parallel_recovery_streams、object_retention_time 和 object_retention_mode。这些参数可让您指定对象级保留政策，而不是存储桶级保留政策。如需了解这些参数，请参阅配置参数中这些参数的说明。

• 自动轮询代理配置：手动修改代理的配置文件后，您无需再重启代理即可使更改生效。系统会在接下来的 30 秒内自动选择更改。

3.6 版

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

• （预览版）支持条带化磁盘为 SAP HANA 执行基于快照的备份和恢复：您可以使用代理的磁盘快照功能来备份和恢复 SAP HANA 纵向扩容数据库，其中 /hana/data 卷托管在多个磁盘上。

  如需使用此增强功能，您需要与 Customer Care 联系。如需了解详情，请参阅使用磁盘快照为 SAP HANA 执行备份和恢复。

• SAP HANA 监控指标更新：

  • 引入了指标 sap/hanamonitoring/backups/snapshot。该指标显示上次基于磁盘快照的完整数据备份的状态。它包含 backup_id 和 entry_type_name 标签。
  • 修复了指标 sap/hanamonitoring/backups/data。它显示的是基于 Backint 的备份的 ID。此问题已修复，可显示上次基于 Backint 的完整备份的状态。此外，从 3.6 版开始，此指标包含 backup_id 和 entry_type_name 标签。

  如需了解详情，请参阅 SAP HANA 监控指标中这些指标的说明。

• Backint 配置参数 custom_time 支持值 UTCNow+NUMBERd，可让您为上传到 Cloud Storage 的备份的 Custom_Time 元数据设置未来日期。如需了解详情，请参阅配置参数中的 custom_time 参数。

• 增强了代理的 configureinstance 命令，以提高在 Compute Engine 裸金属实例上运行的 SAP HANA 横向扩容系统的性能。

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

3.0 版

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 平台资源，并将此信息发送到 Cloud Logging。
• 支持包功能：有助于收集必要的信息（例如日志和错误字符串），以提高可支持性。
• Workload Manager 评估指标收集中的 bug 修复。

2.0 版

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 版包含以下 bug 修复：

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

版本 1.4

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

• 添加了一个新的 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 版包含以下 bug 修复和功能：

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

1.2 版

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

• Process Monitoring 指标现在会考虑 enq_replicator 和 enq_server 服务的状态来确定 SAP NetWeaver 实例的可用性。
• 代理可以收集的新指标：
  • /sap/infra/migration：基础设施迁移指标，用于指示 Compute Engine 实例是否正在进行实时迁移。
  • /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的 Agent for SAP 1.0 版引入了以下功能：

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

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

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