V9.4 引入了基于 Apache log4cxx 日志记录服务的应用程序消息记录。您可以限制日志文件大小,设置旧文件的自动清除,选择输出日志文件的格式,以及更改日志级别和日志配置而无需重新启动服务器。配置文件将每 60 秒受到一次监视以检测更改。
存在五种日志方式,此处按日志记录级别从最低到最高列出:“调试”、“参考”、“警告”、“错误”和“致命”。每种级别都将记录该级别和所有更高级别的信息。例如,“警告”级别将包含“警告”、“错误”和“严重”方式的信息。
Rational DOORS 数据库服务器仍然支持更早样式的日志记录,这可以通过使用 -logfile 命令行开关来启用。有关更多信息,请参阅数据库服务器的命令行开关。
缺省情况下,这些文件位于 Rational DOORS 根路径中;例如,C:\Program Files\IBM\Rational\DOORS\9.version。
名称 | 描述 | 值 |
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} |
参数名称 | 描述 | 值 |
priority | 此参数设置总体日志记录的日志记录方式级别。缺省设置等于“all”。要禁用日志记录,请将此参数的值设置为“off”。 | all、debug、error、fatal、info、off 或 warn |
appender-ref | ref 的值包含追加器部分中定义的追加器的名称。必须提供追加器名称,具体取决于必须为日志记录启用哪些追加器。 | <appender-ref ref="DOORSConsoleAppender"/> |
要启用多个追加器,请创建多个 <appender-ref> 标记实例。 | <appender-ref ref="SystemOutAppender"/> |