配置 Rational DOORS 数据库服务器日志记录文件

在 Rational® DOORS® 9.5 中,您可以更好地控制服务器端日志记录文件。

您可以设置对日志文件大小的限制,设置旧文件的自动清除,选择输出日志文件的格式,更改日志级别,以及在不重新启动服务器的情况下更改这些日志配置。将按 60 秒的时间间隔监视该日志文件,对该文件的任何更改将在此时间内反映。

Rational DOORS 服务器继续支持旧样式的日志记录,可通过使用命令行开关 -logfile (-l) 启用旧样式(请参阅 Rational DOORS 数据库服务器的命令行开关)。

要在日志文件中记录的信息由基于 XML 的配置文件进行控制,缺省情况下,样本文件“logging-config.xml”位于 DOORS 根路径下(即 C:\Program Files\IBM\Rational\DOORS\9.5),配置文件路径应在 DOORS_Server 下的注册表项 logxconfig 中提供,或通过使用命令行选项“-x”或“-logxconfig”并后跟配置文件路径来提供。

必须将样本 logging-config xml 文件配置为包含某个有效文件夹位置路径,以在其中生成日志文件。

例如:

<param name="file" value="${LOG_FOLDER_LOCATION}/IBM/DOORS/log/SystemError.log" /> 可更改为 <param name="file" value="C:/My Server Log/IBM/DOORS/log/SystemError.log" />

更新 logging-config.xml 文件

logging-config.xml 文件基本上包含两节:

第一节包含了附加项的列表,其中提供了关于每个日志文件的日志文件路径、日志级别、最大文件大小、最大备份索引和格式的设置。

有 5 种日志方式:FATAL < ERROR < WARN < INFO < DEBUG(针对每个日志级别记录的信息将是具有相同或更低记录信息优先级的所有信息)。

第二节为记录器,提供了整体的日志记录方式的设置以及为日志记录启用的附加项集合。

要禁用日志记录,请将优先级级别设置为值“off”。

下表描述了 logging-config.xml 文件中使用的参数:

节名称 参数名称 描述
附加项节参数      
  appender name 这是将在稍后用于描述启用了哪个全附加项的附加项名称。 任何值。例如:SystemOutAppender
  file 日志文件是以指定文件名并在该参数值中提到的位置上创建的。 系统中的可访问位置。
  append true:附加到 file 参数中提到的文件后面。false:覆盖 file 参数中提到的文件 true/false
  Threshold 该参数设置日志方式。 off、fatal、error、warn、info、debug
    如果 threshold 设置为 fatal,那么将仅在日志文件中记录致命信息。  
    如果 threshold 设置为 error,那么将仅在日志文件中记录致命和错误信息  
    如果 threshold 设置为 warn,那么将仅在日志文件中记录致命、错误和警告信息  
    如果 threshold 设置为 info,那么将仅在日志文件中记录致命、错误、警告和参考信息  
    如果 threshold 设置为 debug,那么将记录所有信息,例如致命、错误、警告、参考和调试信息  
    如果 threshold 设置为 off,那么将禁用日志记录  
  MaxFileSize 该参数设置日志文件的最大大小,在日志文件达到此限制后,将创建新日志文件,其文件名后追加增量数字。 带有单位的任何值。例如:1000KB
  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 这将设置总体日志记录的日志记录方式级别。要禁用日志记录,请将该参数值设置为“off” off、fatal、error、warn、info、debug
  appender-ref ref 的值包含在上面的附加项节中定义的附加项的名称。根据需要为日志记录启用上面定义的全附加项类型,您需要提供这些附加项的名称 <appender-ref ref="DOORSConsoleAppender"/>
    要启用多个附加项,请创建 <appender-ref> 标记的多个实例。 <appender-ref ref="SystemOutAppender"/>

反馈