配置 Rational DOORS 資料庫伺服器日誌檔

在 Rational® DOORS® 9.5 中, 您可以更完善地控制伺服器端的日誌檔。

您可以設定日誌檔大小的限制、設定自動清理舊檔案、選擇輸出日誌檔的格式、變更記載層次, 以及變更這些日誌配置,而不需重新啟動伺服器。這個配置檔會以每 60 秒的間隔加以監視, 對這個檔案所做的任何變更都會在這個時間內反映。

Rational DOORS 伺服器會繼續支援舊記載樣式, 您可以使用指令行切換選項 -logfile (-l) 來啟用此樣式 (請參閱 Rational DOORS 資料庫伺服器的指令行切換選項)。

要記載在日誌檔中的資訊是由 XML 型的配置檔所控制; 依預設,範例檔 'logging-config.xml' 位於 DOORS 根路徑 (亦即,C:\Program Files\IBM\Rational\DOORS\9.5 下)。 配置檔路徑應該在 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 檔

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

意見