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