Rational DOORSRational DOORS Web Access 的日志文件

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

Rational DOORS 客户机的诊断日志

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

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

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

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

表 1. 日志记录级别
日志级别 日志详细信息
1 连接、断开连接和问题包
2 连接、断开连接和包类型
3 紧凑格式的连接、断开连接、包类型和包参数
4 详细格式的连接、断开连接、包类型和包参数
5 仅数据高速缓存操作
6 详细格式的连接、断开连接、数据高速缓存操作、包类型和包参数
要帮助识别未指定的错误,可能需要启动级别 6 的日志记录以捕获所有活动。启用数据库日志记录并重现行为后,请将生成的日志文件发送给支持人员并禁用日志记录,如帮助主题在 Rational DOORS 数据库服务器中启用事务日志中所述。
注: 要避免性能下降,请仅在有限的诊断周期内启用数据库日志记录。

Rational DOORS 的客户机日志记录

您可以启用日志记录来对数据库服务器的连接问题进行故障诊断。日志不包含可能具有内容敏感信息的模块或对象数据;它仅包含文件事务详细信息。从有问题的计算机打开 Rational DOORS 客户机,然后运行 DXL 命令以启用客户机日志记录并生成本地日志文件。重现行为之后,将生成的日志文件发送给支持人员并禁用日志记录,如客户机日志记录帮助主题在 Rational DOORS 客户机中启用事务日志所述。

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
要生成调试级别日志记录的详细信息,请参阅 ational DOORS Web Access 日志记录的相关链接。logs 目录中有多个日志文件。要诊断问题,请从以下文件开始:
  • festival.log 包含 Rational DOORS Web Access 服务器所编写的每条日志消息。
  • request.log 用于验证是否实际接收了请求。该日志对于对跨多个应用程序的进程进行诊断非常有用。
  • response.log 用于确认响应是否已返回到调用应用程序。该日志在确认已接收的请求是否已完成并返回结果时有用。
错误消息根据其产生的原因被写到不同日志。大多数错误都将写到 exception.log,但是也可以使用其他错误日志文件。 三个错误日志文件为:
  • 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 文件的记录。
有关如何设置日志文件的信息,请参阅以下主题:

视频图标 观看视频

CLM 播放列表
Jazz.net 频道
User Education 频道

学习图标 了解更多

CLM 学习圈
Agile 学习圈
学习圈

提问图标 提问

Jazz.net 论坛
developerWorks 论坛

支持图标 获取支持

支持门户网站
Deployment wiki
支持博客