使用 Google Cloud 的 Agent for SAP 监控 SAP HANA

本规划指南仅重点介绍 Google Cloud 的 Agent for SAP 的 SAP HANA 监控指标收集功能。如需了解代理及其所有功能，请参阅 Google Cloud 的 Agent for SAP 规划指南。

在 Linux 上，Google Cloud 的 Agent for SAP 可帮助您监控 SAP HANA 实例和底层基础架构。您在 Compute Engine 实例或裸金属解决方案服务器上安装该代理后，通过启用 SAP HANA 监控指标收集可以实现此目的。

启用 SAP HANA 监控指标收集后，代理会查询 SAP HANA 实例并将收集的指标发送到 Cloud Monitoring。 您可以使用 Monitoring 中的信息中心直观呈现收集的指标。您还可以在 Monitoring 中基于指标阈值设置提醒。如需了解如何创建信息中心和提醒，请参阅 Cloud Monitoring 文档。

如需了解如何配置 Google Cloud 的 SAP 代理以收集 SAP HANA 监控指标，请参阅配置 SAP HANA 监控指标收集。

Monitoring 将 Google Cloud 的 Agent for SAP 收集并发送到 Monitoring 的 SAP HANA 监控指标归类为收费指标并按注入量计费。

查询的采样间隔（决定了代理查询 SAP HANA 实例以获取指标的频率）会影响发送到 Monitoring 的指标数量。SAP HANA 监控指标是缓慢变化的指标，启用后，默认情况下每 5 分钟收集一次。

如需详细了解 Monitoring 价格，请参阅 Google Cloud Observability 价格。

如需详细了解查询采样间隔，请参阅查询的采样间隔。

费用估算示例

如需查看使用 Google Cloud 的 Agent for SAP 收集 SAP HANA 监控指标的费用估算示例，请参阅按提取的字节数对指标计费的价格示例。

关于查询

为了收集 SAP HANA 监控指标，Google Cloud 的 Agent for SAP 会在 SAP HANA 实例上运行 SQL 查询。这些查询的语法由 SAP 在 SAP HANA SQL 和系统视图参考文档中定义。

Google Cloud 的 Agent for SAP 支持以下类型的查询：

• 默认查询
• 自定义查询

默认查询

默认查询是收集最常用的 SAP HANA 指标的内置查询。

默认查询的频率由代理配置文件中 hana_monitoring_configuration 部分开头处的全局 sample_interval_sec 参数决定。 默认情况下，此值设置为 300 秒（5 分钟）。您可以修改此全局默认值。与自定义查询不同，您无法为单个默认查询设置采样间隔。

虽然您无法修改默认查询，但您可以停用任何不需要的默认查询。如需了解如何停用默认查询，请参阅停用 SQL 查询。

如需详细了解默认查询、它们收集的指标及其使用的基本 SQL 语句，请参阅默认查询参考文档。

自定义查询

为了帮助您更深入地了解 SAP HANA 实例，Google Cloud 的 Agent for SAP 允许您定义和运行自定义查询。

您可以在 queries 部分定义自定义查询，该部分在代理配置文件的 hana_monitoring_configuration 部分下指定。

对于每个自定义查询，您可以指定一个 sample_interval_sec 参数来替换默认的 sample_interval_sec 参数。如需了解详情，请参阅查询的采样间隔。

本文档中提供的自定义查询示例可帮助您编写自己的查询。如需详细了解如何创建自定义查询，请参阅定义自定义查询。

查询的采样间隔

若要使用 Google Cloud 的 Agent for SAP 收集 SAP HANA 监控指标，您可以为所有查询定义全局 sample interval_sec，并为每个自定义查询定义一个单独的采样间隔。采样间隔决定了代理查询 SAP HANA 实例以获取指标的频率。

所有查询的默认采样间隔均为 300 秒（5 分钟）。您可以在代理配置文件的 hana_monitoring_configuration 部分开头处的 sample_interval_sec 参数上指定不同的值，从而调整默认采样间隔。

通过在自定义查询定义中指定 sample_interval_sec 参数，您可以替换单个自定义查询的默认采样间隔。

安装架构

您可以在 Compute Engine 实例或裸金属解决方案服务器上安装 Google Cloud 的 Agent for SAP。

您可以在与 SAP HANA 实例相同的主机上或其他主机上安装 Google Cloud 的 Agent for SAP。

该代理还可以监控在本地主机或其他云平台的主机上运行的 SAP HANA 实例，前提是这些主机可以使用适当配置的服务账号访问 Google Cloud API。

从中央 Compute Engine 实例进行远程收集

下图展示了安装架构，其中代理安装在与运行 SAP HANA 实例的 Compute Engine 实例或裸金属解决方案服务器不同的 Compute Engine 实例上。

Compute Engine 实例和裸金属解决方案服务器上的本地收集

如果防火墙规则限制对环境的访问，您可以在同一 Compute Engine 实例或裸金属解决方案服务器上安装具有 SAP HANA 实例的代理。

下图展示了安装架构，其中代理单独安装在 Compute Engine 实例和裸金属解决方案服务器上。

混合收集架构

您可以在托管 SAP HANA 实例的 Compute Engine 实例上安装代理，并将代理也配置为监控裸金属解决方案服务器上运行的 SAP HANA 实例。

如果要监控多个 Google Cloud 项目中的 SAP HANA 实例，则需要在包含要监视的 SAP HANA 实例的每个 Google Cloud 项目中至少安装一个 Google Cloud 的 Agent for SAP 实例。

代理的高可用性配置

如果要监控高可用性集群中的 SAP HANA 实例，则您必须在非该集群节点的主机上安装 Google Cloud 的 Agent for SAP，以便代理不受故障切换事件的影响。

在代理的配置文件中，我们建议您根据浮动 IP 地址配置监控。使用此配置时，代理只会从当前活跃的节点中收集指标。

SSL/TLS 支持

如果 SAP HANA 实例使用传输层安全协议 (TLS) 或安全套接字层 (SSL) 协议来保护 SAP HANA 数据库与使用 SAP HANA SQL 接口的客户端之间的通信，您必须在 Google Cloud 的 Agent for SAP 中启用 TLS/SSL 支持。为此，您必须在 Google Cloud Agent 的 SAP 配置文件中为所有此类 SAP HANA 实例指定以下参数：

• 指定参数 enable_ssl 并将其值设置为 true。
• 指定参数 host_name_in_certificate，并将 TLS/SSL 证书中指定的主机名设置为其值。
• 指定参数 tls_root_ca_file，并将 TLS/SSL 证书的存储路径设置为其值。

如果 SAP HANA 还配置为验证证书，您可以将代理配置为支持证书验证，并指定密钥库和信任库的路径和密码。

如需了解与 SSL 相关的代理配置参数，请参阅配置参数。

定义自定义查询

借助 Google Cloud 的 SAP for Agent，您可以定义和运行自定义查询。

自定义查询包括以下详细信息：

• 描述查询的参数以及参数值。
• 用于从 SAP HANA 实例中提取数据的 SQL 语句。
• SQL 语句返回的一个或多个指标。

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

如需了解 SAP HANA 提供用于查询的系统视图的完整列表，请参阅 SAP HANA SQL 和系统视图参考。

请注意，创建自定义查询时，Monitoring 最适合用于摘要或汇总数据，而并非用于存储高基数数据点。使用 SUM、AVG、COUNT、MIN 或 MAX 等 SQL 聚合函数来限制返回的记录数。

由于 Google Cloud 的 Agent for SAP 将查询中的列视为有序列表，因此您需要在定义自定义查询时遵循以下准则：

• SQL 语句必须使用查询定义中包含的所有列。
• SQL 语句中的列顺序必须与查询定义中的列顺序相匹配。
• 您已通过在查询块中指定 enabled: true 来启用自定义查询，如自定义查询示例中所述。

例如，您可以查看名为 custom_memory_utilization 的示例自定义查询的查询定义。其查询定义中包含按此顺序排列的 mem_used 和 resident_mem_used 列。此列顺序与为参数 sql 指定的 SQL 语句中的列顺序匹配。

如需查看更多自定义查询示例，请参阅自定义查询示例。

自定义查询示例

以下示例展示了两个自定义查询。示例查询仅可用作自定义查询的模型。

{
  "name": "custom_memory_utilization",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(TOTAL_MEMORY_USED_SIZE), 0) AS mem_used, IFNULL(SUM(PHYSICAL_MEMORY_SIZE), 0) AS resident_mem_used FROM M_SERVICE_MEMORY;",
  "columns": [
    {
      "name": "mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    },
    {
      "name": "resident_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}
{
  "name": "custom_total_memory_usage",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(MEMORY_SIZE_IN_TOTAL), 0) AS table_mem_used FROM M_CS_TABLES;",
  "columns": [
    {
      "name": "table_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}

自定义查询的错误处理

在将查询提交到 SAP HANA 实例之前，Google Cloud 的 Agent for SAP 不会验证自定义查询中的 SQL。

如果自定义查询失败并出现 SQL 异常，或者查询中的配置列与 SAP HANA 返回的结果不匹配，则代理会向日志中写入错误。在这两种情况下，代理都会继续运行自定义查询并将错误消息写入日志，直到连续两次失败，然后代理停止运行该查询。要继续运行此类自定义查询，您需要重启代理。

如需了解自定义查询所需的 SQL 语法，请参阅 SAP HANA SQL 和系统视图参考文档。

SAP HANA 监控指标

下表介绍了 Google Cloud 的 Agent for SAP 可以收集的内置或默认 SAP HANA 监控指标。此表中的指标字符串必须以 workload.googleapis.com/ 为前缀。下表中的条目省略了此前缀。

在 Monitoring 中查看指标

Google Cloud 提供了自定义信息中心，可帮助您直观呈现 Google Cloud 的 Agent for SAP 收集的 SAP HANA 监控指标。请参阅 GitHub 上 GoogleCloudPlatform/monitoring-dashboard-samples 代码库中的 dashboards/google-cloud-agent-for-sap 目录。

如需了解这些信息中心（包括安装说明），请参阅查看收集的指标。

如需了解如何在 Monitoring 中查找指标数据以及如何配置提醒通知，请参阅 Monitoring 中的指标。

默认查询参考

Google Cloud 的 Agent for SAP 的内置默认查询会从 SAP HANA 返回以下信息。

如果您不需要特定内置查询或默认查询提供的指标，则可以将其停用。如需了解相关说明，请参阅相应指南：

• 如需了解 Compute Engine 实例，请参阅停用查询。
• 如需了解裸金属解决方案服务器，请参阅停用查询。

column_queries

内置查询 column_queries 可从 SAP HANA M_CS_ALL_COLUMNS 系统视图中按列返回内存用量信息。

该查询会将以下指标发送到 Monitoring：

component_queries

内置查询 component_queries 可从 SAP HANA 按逻辑组件返回服务特定的内存用量。该查询使用 SAP HANA M_SERVICE_COMPONENT_MEMORY 系统视图。

该查询会将以下指标发送到 Monitoring：

connection_query

内置查询 connection_query 使用 SAP HANA M_CONNECTIONS 系统视图，从 SAP HANA 中返回正在运行的连接数和空闲连接数。

该查询会将以下指标发送到 Monitoring：

cpu_queries

内置查询 cpu_queries 使用 SAP HANA M_HOST_RESOURCE_UTILIZATION 系统视图，从 SAP HANA 中返回 CPU 使用情况信息。

该查询会将以下指标发送到 Monitoring：

alert_query

内置查询 alert_query 使用 _SYS_STATISTICS 架构的 SAP HANA STATISTICS_CURRENT_ALERTS 视图，从 SAP HANA Statistics Server 中返回当前提醒的数量和分级。

该查询会将以下指标发送到 Monitoring：

host_queries

内置查询 host_queries 会从 SAP HANA 按主机返回内存用量。该查询使用 SAP HANA M_HOST_RESOURCE_UTILIZATION 系统视图。

该查询会将以下指标发送到 Monitoring：

replication_query

内置查询 replication_query 会从运行高可用性集群的 SAP HANA 返回复制延迟信息。该查询使用 SAP HANA 系统视图 M_SERVICE_REPLICATION。如果您的 SAP HANA 部署仅运行单个节点，则此查询不会返回任何指标。

该查询会将以下指标发送到 Monitoring：

rowstore_query

内置查询 rowstore_query 使用 SAP HANA M_RS_TABLES 系统视图，从 SAP HANA 中返回行存储的大小。

该查询会将以下指标发送到 Monitoring：

schema_type_queries

内置查询 schema_type_queries 使用 SAP HANA M_CS_TABLES 系统视图，从 SAP HANA 中返回内存用量和记录计数信息。

该查询会将以下指标发送到 Monitoring：

schema_queries

内置查询 schema_queries 使用 SAP HANA M_CS_TABLES 系统视图，从 SAP HANA 中返回架构使用情况信息。

该查询会将以下指标发送到 Monitoring：

service_queries

内置查询 service_queries 会从 SAP HANA 中返回服务所用内存的相关信息。该查询使用 SAP HANA M_SERVICE_MEMORY 系统视图。

该查询会将以下指标发送到 Monitoring：

transaction_query

内置查询 transaction_query 使用 SAP HANA M_WORKLOAD 系统视图，从 SAP HANA 中返回事务总数（更新、提交和回滚）。

该查询会将以下指标发送到 Monitoring：

blocked_transaction_query

内置查询 blocked_transaction_query 使用 SAP HANA M_DATABASES、M_SERVICES 和 M_BLOCKED_TRANSACTIONS 系统视图，从 SAP HANA 中返回被阻止的事务总数。

此查询从代理版本 3.5 开始受支持。

该查询会将以下指标发送到 Monitoring：

data_backup_state_query

内置查询 data_backup_state_query 使用 SAP HANA M_BACKUP_CATALOG 系统视图，返回 SAP HANA 中最近一次完整数据备份的状态。

此查询从代理版本 3.5 开始受支持。

该查询会将以下指标发送到 Monitoring：

log_backup_state_query

内置查询 log_backup_state_query 使用 SAP HANA M_BACKUP_CATALOG 系统视图，从 SAP HANA 中返回被屏蔽的事务总数。

此查询从代理版本 3.5 开始受支持。

该查询会将以下指标发送到 Monitoring：

memory_unloads_query

内置查询 memory_unloads_query 会返回 SAP HANA 中因内存不足而发生的表卸载总数。它使用 SAP HANA M_CS_UNLOADS 系统视图。

此查询从代理版本 3.5 开始受支持。

该查询会将以下指标发送到 Monitoring：

avg_write_time_queries

内置查询 avg_write_time_queries 使用 SAP HANA M_VOLUMES 和 M_VOLUME_IO_DETAILED_STATISTICS 系统视图，返回 SAP HANA 中数据和日志卷的平均写入时间。

此查询从代理版本 3.5 开始受支持。

该查询会将以下指标发送到 Monitoring：

avg_read_time_queries

内置查询 avg_read_time_queries 使用 SAP HANA M_VOLUMES 和 M_VOLUME_IO_DETAILED_STATISTICS 系统视图，从 SAP HANA 中返回数据量平均读取时间。

此查询从代理版本 3.5 开始受支持。

该查询会将以下指标发送到 Monitoring：

data_snapshot_state_queries

内置查询 data_snapshot_state_queries 使用 SAP HANA M_BACKUP_CATALOG 系统视图，返回 SAP HANA 中最近一次基于磁盘快照的完整数据备份的状态。

此查询从代理版本 3.6 开始受支持。

此查询会将以下指标发送到 Monitoring：