IBM Rational DOORS 中的應用程式訊息記載

IBM® Rational® DOORS® 中,您可以使用應用程式訊息來控制診斷日誌,以進行疑難排解。

9.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"/>

意見