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