Rational DOORSRational DOORS Web Access 的日志文件

您可以使用日志文件对在 IBM® Rational® DOORS® 数据库服务器、客户机和互操作服务器中以及在 Rational DOORS Web Access 服务器和消息代理中发生的问题进行故障诊断。
以下日志记录工具可用于诊断意外的行为(具体取决于配置):
  • 客户机的诊断日志
  • 数据库服务器事务日志记录
  • 客户机事务日志记录
  • Rational DOORS Web Access 服务器、互操作服务器和消息代理日志记录
  • 应用程序消息记录和数据收集实用程序

Rational DOORS 客户机的诊断日志

客户机具有内置日志记录机制,用于记录由于会话期间内部错误而发生的任何异常事件。要查看此诊断日志,请单击帮助 > 显示诊断日志。如有必要,可以从输出窗口复制信息并将其另存为本地文本文件。

要记录更详细的日志,还可以在客户机和数据库服务器上启用额外的基于事务的日志记录。有关更多信息,请参阅随后的部分。

Rational DOORS 的数据库服务器日志记录

数据库服务器提供能够以不同详细级别来记录活动的日志记录功能。缺省情况下,不会启用此日志记录功能,因为它可加大事务的处理器使用并减慢完成所请求功能的速度,或者降低总体性能。输出日志中的详细信息基于所设置的日志级别值。这些值的范围是从级别 1(最简短)到级别 6(最详细)。开启服务器日志记录之前,请与 IBM 软件支持人员商讨以确定用于解决问题的必要级别。

表 1. 日志记录级别
日志级别 日志详细信息
1 连接、断开连接和问题包
2 连接、断开连接和包类型
3 紧凑格式的连接、断开连接、包类型和包参数
4 详细格式的连接、断开连接、包类型和包参数
5 仅数据高速缓存操作
6 详细格式的连接、断开连接、数据高速缓存操作、包类型和包参数
要帮助识别未指定的操作,可能需要启动级别 6 的日志记录以捕获所有活动。启用数据库日志记录并重现行为后,请将生成的日志文件发送给 IBM 软件支持人员并禁用日志记录,如服务器日志记录帮助主题中所述。在 Rational DOORS 数据库服务器中启用事务日志记录
注: 请仅在有限的诊断周期内启用数据库日志记录。要关闭日志记录而不关闭服务器,请通过使用 dbadmin 命令 -serverlogging 将日志级别值设置为 0;例如,dbadmin -d 36677@IBMEDSERV -serverlogging 0

Rational DOORS 的客户机日志记录

您可以启用日志记录功能来对数据库服务器的连接问题进行故障诊断。从有问题的计算机打开 Rational DOORS 客户机,然后运行 DXL 命令以启用客户机日志记录并生成本地日志文件。重现行为时,将生成的日志文件发送给 IBM 软件支持人员并禁用日志记录,如客户机日志记录帮助主题中所述。在 Rational Rational DOORS 客户机中启用事务日志记录
注: 日志不包含可能作为内容敏感信息的模块或对象数据;它仅包含文件事务详细信息。如果启用了 DXL 安全性,那么您必须是拥有编辑和运行 DXL 的许可权的用户。../../com.ibm.doors.configuring.doc/topics/t_setupdxlsecurity.html#t_setupdxlsecurity

Rational DOORS 互操作服务器以及 Rational DOORS Web Access 服务器和消息代理的日志记录

缺省情况下,Rational DOORS Web Access 组件提供“参考”级别的日志记录。在“参考”级别,日志记录将包含以高级别描述应用程序进度的参考消息。要诊断安装问题,可以让组件以调试方式运行。 在“调试”级别,日志记录将包含对于调试应用程序有用的更详细参考事件。

Rational DOORS 互操作服务器以及 Rational DOORS Web Access 服务器和消息代理在以下目录中提供“参考”级别日志记录:
  • DWA_INSTALL_DIR\broker\data\activemq.log
  • DWA_INSTALL_DIR\server\festival\logs

    如果您需要更详细的信息来诊断问题,请启用“调试”级别日志记录。要设置增强的日志记录,请参阅 Rational DOORS Web Access 的相关链接。logs 目录中有多个日志文件。

    要诊断问题,请从以下文件开始:
    • festival.log 包含 Rational DOORS Web Access 服务器所编写的每条日志消息。
    • request.log 用于验证是否实际接收了请求。 这在处理跨多个应用程序的进程时有用。
    • response.log 用于确认响应是否已返回到调用应用程序。这在确认已接收的请求是否已完成并返回结果时有用。
    错误消息将写到不同日志,具体取决于其产生原因。 大多数错误都将写到 exception.log,但是也可以使用其他错误日志文件。 存在 3 个错误日志文件:
    • exception.log
    • error_view.log
    • error_misc.log

应用程序消息记录和数据收集器实用程序

V9.4 引入了基于 Apache log4cxx 日志记录服务的应用程序消息记录。您可以限制日志文件大小,设置旧文件的自动清除,选择输出日志文件的格式,以及更改日志级别和日志配置而不重新启动服务器。配置文件将每 60 秒受到一次监视以检测更改。

存在五种级别的日志记录,从最低到最高列为:“调试”、“参考”、“警告”、“错误”和“严重”。每种级别都将记录该级别和所有更高级别的信息。例如,“警告”级别将包含“警告”、“错误”和“严重”方式的信息。

Rational DOORS 的较低版本需要在初始故障诊断阶段中以手动迭代的方式收集环境和资源信息以及诊断日志。随着 V9.4 中应用程序消息传递的引入,可以运行命令行数据收集工具来收集根据应用程序消息传递配置指令所生成的日志。此数据收集工具还会创建 3 个文本文件:
  • readme.txt 清晰描述问题发生时的用法。
  • problemDetails.txt 是可在其中手动输入问题详细信息的模板文件。
  • collectedInformation.txt 是对自动收集的关于操作系统的信息、Rational DOORS 产品信息、受支持的动态链接库文件 (.DLL) 以及 config.ini 文件的记录。
有关如何设置日志文件的信息,请参阅以下主题:

反馈