IBM FileNet Workplace XT 使用 Apache log4j 產品管理其記載。在記載期間,應用程式活動的相關資訊會寫入到主控台或檔案之類的輸出位置。支援和開發人員會使用日誌項目中的資訊來分析應用程式活動,及診斷和解決問題。記載僅作為診斷用途,不提供安全或審核追蹤資訊。
log4j 產品是在安裝 Workplace XT 期間安裝的。依預設,安裝期間不啟用記載。
如果要啟用或停用記載
範例 log4j.properties 檔有一組預設選項,指定為 keyword=value 配對。如果要變更預設值,請以文字編輯器開啟 log4j.properties,視需要加以修改,並儲存該檔案。安裝之後,您可以隨時配置記載設定。 會自動辨識您對記載配置檔所做的變更;您不必重新啟動應用程式或應用程式伺服器。
下列主題提供您會在此檔案中看到的一些記載配置選項的相關資訊。如需記載選項的相關資訊,請參閱 Apache 網站 (http://apache.org) 的「記載專案」和 Apache 記載網站 (http://logging.apache.org/log4j/)。
日誌程式將啟用的記載要求寫入至附加程式。在 log4j.properties 檔中,第一個關鍵字說明 root 日誌程式。root 日誌程式是階層中的最高層日誌程式,並提供廣域預設值;任何未明確設定選項的子項日誌程式,都會從 root 日誌程式繼承其行為。
您可以配置附加程式來指定寫入日誌資料的位置,如此便會將格式化日誌項目傳送至指定的輸出目的地。目的地類型可以是檔案或主控台;輸出可以重新導向至 Windows® Event 日誌、轉遞至遠端 log4j 伺服器等等。(如需所有輸出目的地和格式化選項,請參閱 Apache log4j 文件)。單一日誌程式可以有多個附加程式。例如,您可以同時將輸出寫至主控台和檔案。增加目的地數目會影響效能。
在 Workplace XT 中,依預設會配置兩個附加程式。其中一個附加程式是以「IBM 共用基本事件 (CBE)」格式撰寫日誌資料,IBM Support Assistant 工具用它來處理日誌,另一個附加程式是以更易懂的格式撰寫。您可以變更後一個附加程式來減少輸出量,或將此附加程式完全關閉。
附註
您指定的記載層次決定收集的類型和資訊量。所收集的資訊量和系統的效能影響之間,存在直接相關性。
Workplace XT 應用程式日誌支援標準 INFO、WARN、ERROR 和 FATAL 層次,以及 ALL 和 OFF 層次。下表簡短說明標準層次;如需層次的相關資訊,請參閱 Apache log4j 文件。
層次 | 說明 |
---|---|
INFO |
要求參考訊息,以粗略層次說明應用程式的進度。 |
WARN |
要求可能有害狀況的記載。 |
ERROR |
要求從應用程式內擲出的記載異常狀況。 |
FATAL |
僅要求極重大錯誤事件的記載,其可能導致應用程式失敗。 |
您指定的層次決定收集的資訊量。所收集的資訊量和系統的效能影響之間,存在直接相關性。
配置附加程式時,您可以使用佈置關鍵字來指定寫入資料的格式。您選擇 PatternLayout 和 ConversionPattern。PatternLayout 指定日誌項目的特定型樣,而識別寫入附加程式之元素型樣的 ConversionPattern 則定義型樣。請考量以下範例:
log4j.appender.ErrorOutputFile=org.apache.log4j.RollingFileAppender log4j.appender.ErrorOutputFile.layout=org.apache.log4j.PatternLayout
log4j.appender.ErrorOutputFile.layout.ConversionPattern=%d [%t] - %-5p %m\r\n
產生下列格式化日誌項目;
2007-05-31 17:36:12:801 [cwrap] - Document/Checkin ConnectionWrapper.send send.before
如需格式化選項的相關資訊,請參閱 Apache log4j 文件。
附註 請勿變更「IBM 共用基本事件 (CBE)」日誌項目的佈置。這麼做會造成輸出無法由 IBM Support Assistant 工具讀取。
支援人員可檢查日誌檔的項目,來分析應用程式活動及診斷發生在應用程式中的問題。此外,使用 IBM Support Assistant (ISA) 工具可使分析階段自動化。ISA 工具取用 log4j 的記載輸出中的 CBE 項目。
您也可以使用像 Apache Chainsaw 之類的 GUI 型日誌檢視器,自己檢查非 CBE 日誌項目。