Google Cloud 的 Agent for SAP 诊断信息

如果问题与Google Cloud的 Agent for SAP 3.8 版（最新版）有关，请尽快向 Cloud Customer Care 提供以下诊断信息：

• 问题的完整详细说明。
• 代理的支持包。
• 代理收集的最新数据。
• 代理的配置文件。
• 代理的日志文件。

问题的详细说明

提供问题的完整详细说明，包括代理的版本以及出现问题的日期和时间。

如需查看代理的版本，请完成以下步骤：

支持包

支持包是 Google Cloud的 Agent for SAP 信息集合，可帮助 Customer Care 为您提供问题排查支持。此功能适用于 Google Cloud的 Agent for SAP 2.1 版或更高版本。

从代理的 3.4 版开始，您可以使用 result-bucket 选项上传 supportbundle 命令的输出。为此，您需要确保代理使用的服务账号具有以下 IAM 权限：storage.objects.create。

支持服务套餐包含的内容

• 代理的日志和配置文件。

  从代理的 3.0 版开始，这包括与代理的 Backint 和磁盘快照功能相关的日志和配置文件。

• 给定主机名和 SID 的 SAP HANA 跟踪记录和拓扑文件。

• 适用于 SAP HANA 的 Cloud Storage Backint 代理的配置文件和日志。

• 对于 RHEL 上的高可用性 (HA) 集群，当您指定 pacemaker-diagnosis="true" 时，sosreport 的输出会保存在以下目录中：/tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP。如果 sosreport 命令执行失败，则 crm_report 的输出会保存在指定目录中。

• 对于 SUSE 上的高可用性集群，当您指定 pacemaker-diagnosis=true 时，hb_report 和 supportconfig 实用程序的输出会保存在以下目录中：/tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP。如果执行这些实用程序失败，则 hb_report 和 crm_report 的输出将保存在指定的目录中。

• /var/log/messages 文件，通过提供有关 Linux 系统操作的有用信息来提供帮助。

• 从代理的 3.8 版开始，默认包含 sapdiscovery.json 文件。该文件包含有关在计算实例上运行的 SAP 产品和相关组件的信息。此信息可让客户服务团队更好地了解您的 SAP 系统的角色和配置。

  如需让代理收集此信息，您需要满足以下要求：

  • 在代理的配置文件中指定 "log_to_cloud": true。
  • 向代理使用的服务账号授予 logging.logEntries.list IAM 权限。

• 从代理的 3.8 版开始，当您指定 metrics 选项时，该软件包会包含有关预定义 SAP 事件发生情况以及特定时间段的 Process Monitoring 指标和 SAP HANA 监控指标值变化的信息。

  • 如需让代理从 Cloud Logging 日志中收集有关预定义 SAP 事件发生情况的信息，您需要满足以下要求：
    • 在代理的配置文件中指定 "log_to_cloud": true。
    • 向代理使用的服务账号授予 logging.logEntries.list IAM 权限。
  • 如需让代理从 Cloud Monitoring 收集指标值变化的相关信息，您需要满足以下要求：
    • 在代理的配置文件中指定 "send_metrics_to_monitoring": true。
    • 向代理使用的服务账号授予以下 IAM 权限：monitoring.metricDescriptors.get、monitoring.metricDescriptors.list、monitoring.monitoredResourceDescriptors.get、monitoring.monitoredResourceDescriptors.list 和 monitoring.timeSeries.list。
  • 代理过滤 Cloud Logging 日志和 Cloud Monitoring 条目的时间段取决于以下选项的行为：
    • timestamp：您希望收集有关发生预定义 SAP 事件类型和指标值变化的信息的时间戳（采用 YYYY-MM-DD HH:MM:SS 格式）。默认值为您运行 supportbundle 命令的时间。
    • before-duration：timestamp 前的秒数，代理会在此期间搜索发生的预定义 SAP 事件和指标值的变化。默认值为 3,600 秒。
    • after-duration：timestamp 后的秒数，代理会在此期间搜索发生的预定义 SAP 事件和指标值的变化。默认值为 1,800 秒。

  • 系统会将收集的信息整理到文件夹中，其中包含发生的每个 SAP 事件类型和更改其值的每个指标的 JSON 文件。以下是输出示例：

    supportbundle/
    |--- process_metrics/
      |--- pm_sap_control_cpu_utilization.json
      |--- pm_sap_control_memory_utilization.json
    |--- hana_monitoring_metrics/
      |--- hm_sap_hanamonitoring_disk_readtime.json
      |--- hm_sap_hanamonitoring_disk_writetime.json
    |--- sap_events/
      |--- se_HA_Availability.json
      |--- se_HA_Replication.json

生成支持包

如需为在 Linux 上运行的代理实例生成支持包，请在计算实例上运行以下命令：

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

替换以下内容：

• SID：您的 SAP 系统 ID。
• INSTANCE_NUMBERS：要生成支持包的 SAP 实例编号。

  如需指定多个实例编号，请使用空格将其分隔开。例如：00 11 22指定两个或更多 SAP 实例编号时，该命令会为指定实例生成一个组合支持包。

• HOST_NAME：运行命令的主机的名称。
• BOOLEAN_VALUE：值 true 或 false，用于确定是否执行 Pacemaker 相关诊断；默认值为 false。
• BUCKET_NAME：您要将 supportbundle 命令的输出内容上传到的 Cloud Storage 存储桶的名称。
• TIMESTAMP：您要收集有关发生预定义 SAP 事件类型和指标值变化的信息的时间戳（采用 YYYY-MM-DD HH:MM:SS 格式）。默认值为您运行 supportbundle 命令的时间。
• BEFORE_DURATION：timestamp 选项的值前的秒数，代理会在此期间搜索发生的预定义 SAP 事件和指标值的变化。默认值为 3,600 秒。
• AFTER_DURATION：timestamp 选项的值后的秒数，代理会在此期间搜索发生的预定义 SAP 事件和指标值的变化。默认值为 1,800 秒。

代理收集的最新数据

提供代理收集的最新数据。将代理收集的最新数据保存到文件中，然后将文件附加到支持请求中。

如需查看代理收集的最新数据，请完成以下步骤：

配置文件

移除 SAP HANA 数据库用户名和密码等凭证后，请提供 Google Cloud的 Agent for SAP 的配置文件。

如需找到代理的配置文件，请转到以下路径：

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

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

日志文件

提供 Google Cloud的 Agent for SAP 的日志文件。

如需找到代理的日志文件，请转到以下路径：

/var/log/google-cloud-sap-agent.log

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log