收集 SAP 支持的诊断信息

为了帮助 SAP 支持分析系统的任何问题，您可以收集一系列 诊断信息。

为了帮助 SAP 支持分析和诊断系统问题，您可以收集 将诊断信息范围从您的系统导入到一个 zip 文件中，您可以下载该文件 并附加到支持消息。

可以从 SAP HANA 主控室触发诊断信息的收集， SAP HANA Studio 或命令行。有关详细信息，请参阅以下主题 信息：

• 在 SAP HANA Cockpit 中收集和下载诊断信息

• 在 SAP HANA Studio 中收集和下载诊断信息

• 从命令行收集诊断信息

除了以下有关 fullSystemInfoDump 脚本的主题外，还有一个 所有可用于运行和触发的选项都提供了详细的 SAP 说明 运行时转储：常见问题解答：SAP HANA 运行时转储。

从命令行收集诊断信息

fullSystemInfoDump.py 脚本允许您收集信息 即使 SQL 无法访问它，也可以从您的系统访问。然后，您可以添加此信息 例如，支持消息。该脚本是 SAP HANA 服务器安装的一部分 并且可以直接从命令行执行。

先决条件

您将以操作系统用户 adm 身份登录。<sid>

上下文

fullSystemInfoDump.py 脚本是服务器安装的一部分，并且 可以从命令行运行。它位于目录 $DIR_INSTANCE/exe/python_support 中。

注意

在多容器系统中，只有系统管理员可以收集诊断信息 来自命令行的信息，因为租户数据库管理员没有 操作系统访问。租户数据库管理员必须使用 SAP HANA 驾驶舱或工作室从他们的数据库中收集诊断信息。

程序

使用以下命令从其位置启动脚本：

python fullSystemInfoDump.py

您可以使用多个命令行选项修改命令。要查看可用的 选项，指定选项 --help - 见下文 桌子。

如果 SQL 可以访问系统（并且您尚未指定选项 --nosql），则脚本将开始收集诊断 信息。如果 SQL 无法访问系统，则脚本将启动 收集支持信息，但不从系统导出数据 视图。

选择	描述
--版本	显示脚本版本号
--帮助	显示帮助
--nosql	排除系统视图的集合 注意 如果你是 连接到系统数据库，只有来自 系统数据库的系统视图将是 收集。来自租户系统视图的信息 不会收集数据库 不管这个选项。
--文件 <filename>	压缩其源目录中的指定文件 注意 此选项仅压缩文件;它没有 触发任何其他的收集 信息。
--日 <no. of days>	从指定数量的过去收集信息 日 默认值为 7。 注意 您不能使用 此选项包含选项 --fromDate 和 --toDate。
--from日期 <YYYY-MM-DD>	从指定开始收集信息 日期
--toDate <YYYY-MM-DD>	收集指定日期之前的信息
--rtedump	将收集的信息限制为 RTE 转储文件 或文件 您可以配置创建和收集 RTE 使用其余选项进一步转储文件。
--索引服务器 <comma-separated list of index servers>	指定从中转储文件的索引服务器 将被收集 默认情况下，将创建转储文件，并 为所有索引服务器收集
--间隔 <interval in minutes>	指定 RTE 转储文件的时间间隔 收集 可能的值为 1、5、10、15 和 30。 默认值为 1。
--集 <no. of RTE dump file sets>	指定要 的 RTE 转储文件集数 收集。 可能的值为 1、2、3、4 和 5。
--房客 <tenant database name>	指定要使用的租户数据库信息 收集自 必须指定数据库名称。 自 从系统数据库中收集信息，指定 .SYSTEMDB

结果

该脚本创建一个包含收集的信息的 zip 文件，并将其保存到 目录 DIR_GLOBAL/sapcontrol/snapshots。DIR_GLOBAL通常指向 /usr/sap/<sid>/SYS/global。

zip 文件的名称结构如下：fullsysteminfodump_<SID>_<DBNAME>_<HOST>_<timestamp>.zip

文件名中的时间戳为 UTC。主机和 SID 取自 sapprofile.ini 文件。

当脚本 运行。

SQL 中的系统信息转储文件

可以从 SQL 命令获取运行时环境 （RTE） 转储文件 线。

除了已经描述的方法外，您还可以 使用 SQL 获取运行时转储文件。您可以使用 ALTER SYSTEM CREATE RUNTIMEDUMP 命令创建完整或选择性转储文件 系统活动。SAP HANA SQL 参考中提供了语法的完整详细信息 指导;在这里，用法和可选配置步骤进行了一些解释 示例来说明基本功能。RESOURCE_ADMIN特权是 运行此命令是必需的。您可以在 监控视图M_JOB_PROGRESS。

基本语法允许您指定主机和输出文件名。默认情况下，将写入转储文件的所有部分：



ALTER SYSTEM CREATE RUNTIMEDUMP AT LOCATION 'myhost:30003' INTO FILE 'my_rte_dump.trc'

如果未指定文件名，则使用以下默认文件名结构：



<servicename>_<hostname>.<port>.rtedump.<YYYYMMDD-HHMMSS>.<pid>.trc

例如：



indexserver_myhost0001.30203.rtedump.20180627-104305.012220.trc

还可以命名要包含的运行时转储文件的特定部分;例如，以下命令仅打印STACK_SHORT部分：



ALTER SYSTEM CREATE RUNTIMEDUMP AT LOCATION 'myhost:30003' SECTIONS ('STACK_SHORT') INTO FILE 'my_rte_dump.trc'

或者，您可以省略 SECTIONS 参数并基于预定义运行命令 配置文件，用于选择要包含的转储文件的各个部分。配置文件定义为 global.ini文件中的配置文件值。以下命令，用于 示例，将编写一个运行时转储，其中包含配置文件定义的所有部分 myRTEPro文件：



ALTER SYSTEM CREATE RUNTIMEDUMP PROFILE 'myRTEProfile' INTO FILE 'my_rte_dump.trc'

配置文件 myRTEProfile 可能将以下内容定义为默认部分，这些部分将打印 除 STACK_FULL 和 MEMMAP 之外的所有部分。



!STACK_FULL,!MEMMAP,*

配置文件在 global.ini 文件的 [runtimedump] 部分中定义，其名称位于 格式如下：<profileName>_sections;的值 参数是要包含在运行时转储中的节名称的逗号分隔列表 如果未在 SQL 语句中指定 SECTIONS 参数，则输出。您可以使用 字符串末尾的星号作为通配符和感叹号 在节名称前做标记以明确排除节，否则 selected，如以下示例所示：

• Default_sections = ！STACK_FULL，！MEMMAP，*

• my_sections = *

对此配置参数所做的更改立即生效，重新启动将立即生效 没有必要。

收集的诊断信息

Python 支持脚本 fullSystemInfoDump.py 脚本收集 来自您的系统用于诊断目的的信息范围。它可以从 SAP HANA 主控室、SAP HANA Studio 或直接从命令行。

注意

除非指定了选项 --rtedump，否则将收集以下所有文件类型，在这种情况下，仅创建运行时环境 （RTE） 转储文件 并收集。

日志文件

有关已收集内容的所有信息都显示为控制台输出，并写入 名为 log.txt 的文件，存储在 zip 文件中。

跟踪文件

以下每个跟踪文件都放入与跟踪文件同名的文件中。为 存储原因，仅收集过去 7 天的跟踪文件。 不会收集较旧的跟踪文件。可以使用选项 --days 或选项 --fromDate 和 --toDate 来更改此行为。

故障转储文件和运行时转储文件始终以未删节的方式收集。

• $DIR_INSTANCE/<SAPLOCALHOST>/trace/compileserver_alert_<SAPLOCALHOST>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/compileserver_<SAPLOCALHOST>.<...>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/daemon_<SAPLOCALHOST>.<...>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/indexserver_alert_<SAPLOCALHOST>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/indexserver_<SAPLOCALHOST>.<...>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/nameserver_alert_<SAPLOCALHOST>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/nameserver_history.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/nameserver_<SAPLOCALHOST>.<...>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/preprocessor_alert_<SAPLOCALHOST>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/preprocessor_<SAPLOCALHOST>.<...>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/statisticsserver_alert_<SAPLOCALHOST>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/statisticsserver_<SAPLOCALHOST>.<...>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/xsengine_alert_<SAPLOCALHOST>.trc
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/xsengine_<SAPLOCALHOST>.<...>.trc

配置文件

所有配置文件均未删节收集，并存储在具有相同内容的文件中 名称作为.ini文件：

• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/attributes.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/compileserver.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/daemon.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/executor.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/extensions.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/filter.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/global.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/indexserver.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/inifiles.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/localclient.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/mimetypemapping.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/nameserver.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/preprocessor.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/scriptserver.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/statisticsserver.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/validmimetypes.ini
• $DIR_INSTANCE/<SAPLOCALHOST>/exe/config/xsengine.ini

数据库系统日志文件

以下备份文件是未删节收集的：

• $DIR_INSTANCE/<SAPLOCALHOST>/trace/backup.log
• $DIR_INSTANCE/<SAPLOCALHOST>/trace/backint.log

.

RTE 转储文件

对于每个索引服务器，一个 RTE 转储文件，其中包含有关线程、堆栈上下文、 依此类推创建并存储在文件 indexserver_<SAPLOCALHOST>_<PORT>_runtimedump.trc 中。 这些文件以未删节的方式存储。

故障转储信息

服务的故障转储文件是以未删节的方式收集的。

性能跟踪文件

后缀为 *.tpt 的性能跟踪文件将以未删节的方式收集。

Kerberos文件

收集以下 Kerberos 文件：

• /etc/krb5.conf
• /etc/krb5.keytab

系统视图

如果未排除系统视图的集合（指定了选项 --nosql）， 以下系统视图的所有行（下面提到的例外情况除外）都是 导出到带有表名称的 CSV 文件中。

注意

如果连接到多容器系统的系统数据库，则仅 将从系统数据库的系统视图中收集信息。 无论使用此选项，都不会从租户数据库的系统视图中收集信息。

• SYS.M_CE_CALCSCENARIOS WHERE SCENARIO_NAME LIKE '%_SYS_PLE%'
• SYS.M_CONNECTIONS with CONNECTION_ID > 0
• SYS.M_DATABASE_HISTORY
• SYS.M_DEV_ALL_LICENSES
• SYS.M_DEV_PLE_SESSIONS_
• SYS.M_DEV_PLE_RUNTIME_OBJECTS_
• 系统。M_EPM_SESSIONS
• 系统。M_INIFILE_CONTENTS
• 系统。M_LANDSCAPE_HOST_CONFIGURATION
• 系统。M_RECORD_LOCKS
• 系统。M_SERVICE_STATISTICS
• 系统。M_SERVICE_THREADS
• 系统。M_SYSTEM_OVERVIEW
• 系统。M_TABLE_LOCATIONS
• 系统。M_TABLE_LOCKS
• 系统。M_TABLE_TRANSACTIONS
• _SYS_EPM。版本
• _SYS_EPM。TEMPORARY_CONTAINERS
• _SYS_EPM。SAVED_CONTAINERS
• _SYS_STATISTICS。STATISTICS_ALERT_INFORMATION
• _SYS_STATISTICS。STATISTICS_ALERT_LAST_CHECK_INFORMATION
  注意

  只有 导出前 2,000 行。

• _SYS_STATISTICS。STATISTICS_ALERTS
  注意

  只有前 2,000 名 导出行。

• _SYS_STATISTICS。STATISTICS_INTERVAL_INFORMATION
• _SYS_STATISTICS。STATISTICS_LASTVALUES
• _SYS_STATISTICS。STATISTICS_STATE
• _SYS_STATISTICS。STATISTICS_VERSION

将导出架构_SYS_STATISTICS中所有剩余表的前 2,000 行 按第 SNAPSHOT_ID 列排序。

如果 SQL 连接不可用，则收集的其他信息

所有可用的拓扑信息都将导出到名为 topology.txt 的文件中。它包含有关主机的信息 树状结构中的拓扑结构。键使用括号进行分组，而 相应的值由符号 ==> 引用。例如：

[]
  ['host']
    ['host', 'ld8521']
      ['host', 'ld8521', 'role']
        ==> worker
      ['host', 'ld8521', 'group']
        ==> default
      ['host', 'ld8521', 'nameserver']
        ['host', 'ld8521', 'nameserver', '30501']
          ['host', 'ld8521', 'nameserver', '30501', 'activated_at']
            ==> 2011-08-09 16:44:02.684
          ['host', 'ld8521', 'nameserver', '30501', 'active']
            ==> no
          ['host', 'ld8521', 'nameserver', '30501', 'info']
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'cpu_manufacturer']
              ==> GenuineIntel
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'topology_mem_type']
              ==> shared
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'sap_retrieval_path_devid']
              ==> 29
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'build_time']
              ==> 2011-07-26 17:15:05
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'net_realhostname']
              ==> -
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'build_branch']
              ==> orange_COR
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'mem_swap']
              ==> 34359730176
            ['host', 'ld8521', 'nameserver', '30501', 'info', 'mem_phys']