Rational DOORS 中的應用程式訊息日誌

IBM® Rational® DOORS® 中,您可以使用應用程式訊息來控制用於疑難排解的診斷日誌。
9.4 版推出了應用程式訊息日誌,這是以 Apache log4cxx 記載服務為基礎。您可以執行下列作業,且不需重新啟動伺服器: 每隔 60 秒會監視一次配置檔來偵測變更。

有五種記載模式,從最低到最高分別是:除錯、參考、警告、錯誤及嚴重。每一個層次記載該層次及所有較高層次的相關資訊。例如,「警告」層次包含來自「警告」、「錯誤」及「嚴重」模式的資訊。

Rational DOORS 資料庫伺服器仍然支援舊版的記載樣式,您可以使用 -logfile 指令行切換參數來啟用該樣式。如需相關資訊,請參閱資料庫伺服器的指令行切換參數

傳遞至日誌檔的資訊是由一個 XML 型配置檔所控制。我們提供兩個配置檔:
依預設,那些檔案位於 Rational DOORS 用戶端與伺服器安裝架構的根路徑。

.xml 檔配置檔

控制應用程式訊息記載的參數位於配置檔的兩個區段中:
  • 附加項目參數提供每一個日誌檔的日誌檔路徑、記載層次、檔案大小上限、備份索引上限及格式的設定。
  • 日誌程式參數提供整體記載模式以及一組可啟用來記載之附加項目的設定。
表 1. 附加項目參數
名稱 說明
appender name 這個參數是附加項目的名稱,用來說明已啟用的附加項目。 任何值;例如,SystemOutAppender
file 這個參數值指定建立的日誌檔的名稱和位置。 系統上可存取的位置;例如,C:\IBM\DOORS\log\SystemError.log
append 如果這個參數設為 true,則資訊會附加至 file 參數中指定的檔案。如果這個參數設為 false,則會改寫 file 參數中提及的檔案。 true 或 false
Threshold 這個參數設定記載模式。 關閉、嚴重、錯誤、警告、參考資訊或除錯
如果 threshold 設為嚴重,則日誌檔中只會記載嚴重資訊。 嚴重
如果 threshold 設為錯誤,則日誌檔中會記載嚴重和錯誤資訊。 錯誤
如果 threshold 設為警告,則日誌檔中會記載嚴重、錯誤及警告資訊。 警告
如果 threshold 設為參考資訊,則日誌檔中會記載嚴重、錯誤、警告及參考訊息。 參考資訊
如果 threshold 設為除錯,則日誌檔中會記載所有資訊。 除錯
如果 threshold 設為關閉,則會停用記載。 關閉
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" 所有、除錯、錯誤、嚴重、參考資訊、關閉或警告
appender-ref ref 的值包含您在附加項目區段中定義的附加項目名稱。視必須啟用來記載的附加項目而定,您必須提供附加項目名稱。 <appender-ref ref="DOORSConsoleAppender"/>
如果要啟用多個附加項目,請建立多個 <appender-ref> 標籤實例。 <appender-ref ref="SystemOutAppender"/>

視訊圖示 觀看視訊

CLM 播放清單
Jazz.net 頻道
User Education 頻道

學習圖示 進一步瞭解

CLM 學習圈
敏捷學習圈
學習圈

詢問圖示 詢問問題

Jazz.net 討論區
developerWorks 討論區

支援圖示 取得支援

支援中心入口網站
Deployment Wiki
支援中心部落格