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 事件日誌、轉遞至遠端 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 Support Assistant (ISA) 工具可使分析階段自動化。ISA 工具取用 log4j 的記載輸出中的 CBE 項目。
您也可以使用像 Apache Chainsaw 之類的 GUI 型日誌檢視器,自己檢查非 CBE 日誌項目。