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

意見