IBM Rational DOORS 中的应用程序消息记录

IBM® Rational® DOORS® 中,您可以使用应用程序消息来控制用于故障诊断的诊断日志。

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

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

Rational DOORS 数据库服务器仍然支持更早样式的日志记录,这可以通过使用 -logfile 命令行开关来启用。有关更多信息,请参阅数据库服务器的命令行开关

传递到日志文件的信息由基于 XML 的配置文件来控制。提供了两个配置文件:

缺省情况下,这些文件位于 Rational DOORS 根路径中;例如,C:\Program Files\IBM\Rational\DOORS\9.version

.xml 配置文件

用于控制应用程序消息记录的参数位于配置文件的两个节中:
  • 追加器参数提供每个日志文件的日志文件路径、日志级别、最大文件大小、最大备份索引和格式的设置。
  • 记录器参数提供总体日志记录方式的设置以及可为日志记录启用的一组追加器。
表 1. 追加器参数
名称 描述
appender name 此参数的值是追加器的名称,用于说明启用了哪些追加器。 任何内容;例如,SystemOutAppender
file 此参数值指定所创建的日志文件的名称和位置。 系统上的可访问位置;例如,C:\IBM\DOORS\log\SystemError.log
append 如果此参数设置为 true,那么信息将追加到 file 参数中提及的文件。如果此参数设置为 false,那么将覆盖 file 参数中提及的文件。 true 或 false
Threshold 该参数设置日志方式。 off、fatal、error、warn、info 或 debug
如果 threshold 设置为 fatal,那么将仅在日志文件中记录严重信息。 fatal
如果 threshold 设置为 error,那么将在日志文件中记录严重和错误信息。 error
如果 threshold 设置为 warn,那么将在日志文件中记录严重、错误和警告信息。 warn
如果 threshold 设置为 info,那么将在日志文件中记录严重、错误、警告和参考消息。 info
如果 threshold 设置为 debug,那么将在日志文件中记录所有信息。 debug
如果 threshold 设置为 off,那么将禁用日志记录。 off
MaxFileSize 此参数设置日志文件的最大大小。在日志文件达到最大大小后,将创建另一个日志文件。新文件的名称将包含递增数字。 带单位的任何内容;例如,1000 KB
MaxBackupIndex 此参数设置为记录器创建的最大文件数。达到最大数量后,将从最老的文件开始覆盖文件。 任何整数
Conversion Pattern 此参数指定信息在日志文件中的记录格式。可以包含日期和时间、日志方式以及所记录信息的摘要。可根据需要来更改顺序。 该值以日期开头:%d{dd MMM yyyy HH:mm:ss:SSS} [%p] %m%n
该值以日志方式开头:[%p] %m%n %d{dd MMM yyyy HH:mm:ss:SSS}
表 2. 记录器参数
参数名称 描述
priority 此参数设置总体日志记录的日志记录方式级别。缺省设置等于“all”。要禁用日志记录,请将此参数的值设置为“off”。 all、debug、error、fatal、info、off 或 warn
appender-ref ref 的值包含追加器部分中定义的追加器的名称。必须提供追加器名称,具体取决于必须为日志记录启用哪些追加器。 <appender-ref ref="DOORSConsoleAppender"/>
要启用多个追加器,请创建多个 <appender-ref> 标记实例。 <appender-ref ref="SystemOutAppender"/>

反馈