您可以設定日誌檔大小的限制、設定自動清理舊檔案、選擇輸出日誌檔的格式、變更記載層次,以及變更這些日誌配置而不需重新啟動伺服器。 這個配置檔會以每 60 秒的間隔加以監視,對這個檔案所做的任何變更都會在這個時間內反映。
Rational DOORS 伺服器會繼續支援舊的記載樣式,您可以使用指令行切換選項 -logfile (-l) 來啟用此樣式(請參閱 Rational DOORS 資料庫伺服器的指令行切換選項。
要記載在日誌檔中的資訊是由 XML 型的配置檔所控制; 依預設,範例檔 'logging-config.xml' 位於 DOORS 根路徑(亦即,C:\Program Files\IBM\Rational\DOORS\9.4 下)。 配置檔路徑應該在 DOORS_Server 下的登錄項目中提供,或是使用指令行選項‘-x’或‘-logxconfig’後面跟著配置檔路徑來提供。
範例 logging-config XML 檔必須加以配置,以包括要在其中產生日誌檔的有效資料夾位置路徑。
例如:
<param name="file" value="${LOG_FOLDER_LOCATION}/IBM/DOORS/log/SystemError.log" /> 可以變更為 <param name="file" value="C:/My Server Log/IBM/DOORS/log/SystemError.log" />
logging-config.xml 檔基本上包含兩個區段:
第一個區段包含附加項目的清單, 其提供日誌檔路徑、記載層次、檔案大小上限、備份索引上限以及每一日誌檔的格式等設定。
記載模式有 5 種:FATAL < ERROR < WARN < INFO < DEBUG(對每一種記載層次所記載的資訊,會包含相同或較低優先順序之記載資訊的所有資訊。
第二個區段提供了整體記載模式的設定, 以及要對記載啟用之附加項目的設定。
若要停用記載,請將優先順序層次設為 "off" 值。
下表說明 logging-config.xml 檔中使用的參數:
區段名稱 | 參數名稱 | 說明 | 值 |
---|---|---|---|
附加項目區段參數 | |||
appender name | 這是附加項目的名稱,之後會用來說明將啟用的所有附加項目。 | 任何值。例如:SystemOutAppender | |
file | 日誌檔會以指定的檔名建立,並建立在這個參數值所指的位置下。 | 系統中可存取的位置。 | |
append | true:附加到 file 參數所指的檔案中。false:改寫 file 參數所指的檔案 | true/false | |
Threshold | 這個參數會設定記載模式。 | off、fatal、error、warn、info、debug | |
如果 threshold 設為 fatal,日誌檔中只會記載嚴重資訊。 | |||
如果 threshold 設為 error,日誌檔中只會記載嚴重和錯誤資訊 | |||
如果 threshold 設為 warn,日誌檔中只會記載嚴重、錯誤和警告資訊 | |||
如果 threshold 設為 info,日誌檔中會記載嚴重、錯誤警告和參考資訊 | |||
如果 threshold 設為 debug,則會記載所有資訊,亦即,嚴重、錯誤、警告、參考和除錯資訊 | |||
如果 threshold 設為 off,則會停用記載 | |||
MaxFileSize | 這個參數會設定日誌檔的大小上限,且當日誌檔到達此限制之後,其會以附加遞增號碼的檔名來建立新的日誌檔 | 具有單位的任何值。例如:1000KB | |
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 | 這會設定整體記載的記載模式層次。 若要停用記載,請將這個參數值設為 "off" | off、fatal、error、warn、info、debug | |
appender-ref | 參照值包含在上述附加項目區段中所定義的附加項目名稱。根據上述定義的所有附加項目哪些需要啟用記載,您需要提供這些附加項目名稱 | <appender-ref ref="DOORSConsoleAppender"/> | |
若要啟用多個附加項目,請建立多個 <appender-ref> 標籤的實例。 | <appender-ref ref="SystemOutAppender"/> |