日誌層次設定

請利用這個主題來配置和管理日誌層次設定。

如果要檢視這個管理主控台頁面,請按一下疑難排解 > 日誌和追蹤 > server_name > 變更日誌詳細資料層次

您可以利用日誌層次來控制 Java 記載所處理的事件。當您變更日誌程式的層次時,這項變更會傳送到日誌程式的子項。

註: 這個主題參照一或多個應用程式伺服器日誌檔。 建議的另一種作法是,您可以在分散式系統和 IBM® i 系統上配置伺服器,來使用「高效能可延伸記載 (HPEL)」日誌和追蹤基礎架構,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 檔。 HPEL 也可以與原生 z/OS® 記載機能一起使用。如果使用 HPEL,您可以從伺服器設定檔 bin 目錄中,利用 LogViewer 指令行工具來存取您的所有日誌和追蹤資訊。 請參閱有關利用 HPEL 疑難排解應用程式的資訊,以取得更多使用 HPEL 的相關資訊。
停用潛在機密資料的記載和追蹤
應用程式伺服器有一份日誌程式清單,已知啟用之後,有可能將機密性資訊寫入日誌和追蹤中。 例如,在 FINEST 層次啟用特定 HTTP 相關日誌程式,有可能造成將 HTTP 要求中的機密性使用者指定資訊儲存在追蹤檔中。 如果您想要伺服器避免在已知將用於潛在機密性資訊的層次上啟用這些日誌程式,請勾選停用潛在機密資料的記載和追蹤勾選框。當伺服器啟動時,或在執行時期修改日誌詳細資料層次規格時,伺服器會比較日誌程式的清單及日誌詳細資料層次規格所指定的層次,與機密性日誌程式清單中的日誌程式和層次清單,且會依照需要來更新日誌詳細資料層次規格。
變更日誌詳細資料層次

請輸入日誌詳細資料層次,來指定您要追蹤的元件、套件或群組。日誌詳細資料層次字串必須符合這個主題所說明的特定文法。 您可以直接輸入日誌詳細資料層次字串,也可以利用圖形追蹤介面來產生它。

如果您選取配置標籤,並展開元件和群組,畫面上會顯示一份常用元件、套件和群組的靜態清單。這份清單不一定完整。

如果您選取執行時期標籤,並展開元件和群組,就會顯示元件、套件和群組的清單,且含有登錄在執行中應用程式伺服器和靜態清單中的所有元件。

日誌詳細資料層次規格的格式為:
<component> = <level>

其中 <component> 是指您要設定日誌詳細資料層次的元件,<level> 是指其中一個有效的日誌程式層次(off、fatal、severe、warning、audit、info、config、detail、fine、finer、finest、all)。 請以冒號 (:) 區隔多個日誌詳細資料層次規格。

避免困難 避免困難: [2013 年 6 月更新]追蹤規格所包含的子句是依照它們在字串中的出現順序來讀取。 因此,如果追蹤規格包含 *=info 子句的多個變體,所指定的最後一個值就是決定系統所記載之追蹤層次的值。 如果您指定 *=info 作為最後一個子句,就會在資訊層次進行追蹤,不論追蹤字串是否指定了其他子句,都是如此。 比方說,如果您指定下列追蹤字串:
*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all  
相當於只是指定:
*=all
因為最終子句會置換字串中前面所指定的所有子句。[2013 年 6 月更新]gotcha
元件會對應於 Java 套件和類別,或對應於 Java 套件的集合。 請利用星號 (*) 作為萬用字元,代表包括指定元件所含所有套件中所有類別的元件。 例如:
*
指定所有在應用程式伺服器執行的可追蹤的程式碼,其中包括產品系統程式碼和自訂程式碼。
com.ibm.ws.*
指定套件名稱開頭都是 com.ibm.ws 的所有類別。
com.ibm.ws.classloader.JarClassLoader
只指定 JarClassLoader 類別。

如果您是從群組和元件清單決定選項,則當您從管理主控台設定日誌詳細資料層次規格時,就會發生錯誤。 在某些情況下,在一份清單中所選的選項,會因為從另一份清單加入某個選項而遺失。 如果要暫時解決這個問題,請直接在「日誌詳細資料層次」輸入欄位中,輸入日誌詳細資料層次規格。

請選取一個元件或群組,來設定日誌詳細資料層次。下表所列的是 WebSphere® Application Server 第 6 版及更新版本的應用程式伺服器的有效層次。
避免困難 避免困難: 記載層次值有區分大小寫,且開頭是小寫字母。gotcha
表 1. 有效的記載層次. 下表所列的是 WebSphere Application Server 第 6 版及更新版本的應用程式伺服器的有效層次。
第 6 版及更新版本的記載層次 內容/重要性
關閉 記載功能已被關閉。
fatal 作業無法繼續進行,且元件、應用程式和伺服器也無法運作。
severe 作業無法繼續進行,但是元件、應用程式和伺服器仍可以運作。 這個層次也會指出即將發生之無法復原的錯誤。
warning 可能發生的錯誤,或是即將發生的錯誤。 這個層次也會指出逐漸發生的失敗(例如,可能發生的資源洩漏)。
audit 影響伺服器狀態或資源的重要事件
info 概述整體作業進度的一般資訊
config 配置變更或狀態
detail 詳述子作業進度的一般資訊
fine 追蹤資訊 - 一般追蹤 + 方法進入、結束、回覆值
finer 追蹤資訊 - 詳細追蹤
finest 追蹤資訊 - 較詳細的追蹤,包括除錯問題所需的所有詳細資料
all 所有的事件都會記載下來。假設您有建立自訂層次,設為「全部」不但會 包括所有自訂層次,而且還可提供比最細微還詳細的追蹤細節。
當您在 6.0 版(或以上)啟用記載層次時,也會啟用所有嚴重性較高的層次。比方說,如果您在 6.x 版應用程式伺服器中,將記載層次設定為警告,系統會處理警告嚴重錯誤重大嚴重錯誤事件。

[基本模式記載] 追蹤資訊(「細微」、「較細微」及「最細微」層次的事件)只能寫入追蹤日誌中。 因此,如果未啟用診斷追蹤,即使將日誌詳細資料層次設為「細微」、「較細微」或「最細微」 也不會對資料記載產生任何影響。

相關性
指定您要啟用的相關性設定。選取啟用日誌和追蹤相關性勾選框,可啟用應用程式伺服器的相關性。清除啟用日誌和追蹤相關性勾選框,可停用應用程式伺服器的相關性。請視情況選取在日誌和追蹤記錄中併入要求 ID在日誌和追蹤記錄及相關性日誌記錄中併入要求 ID,或在日誌和追蹤記錄中併入要求 ID、建立相關性日誌記錄,以及擷取資料 Snapshot
最佳作法 最佳作法: 當您希望看到所有執行緒和應用程式伺服器程序中,哪些日誌和追蹤項目與同一個要求相關時,可讓 XCT 在日誌和追蹤檔中併入要求 ID。 要求 ID 只會在使用 HPEL 日誌和追蹤模式時記錄,而且可以使用 logViewer 指令加以查看或用於過濾。bprac
最佳作法 最佳作法: 當您希望記錄要求如何在執行緒和程序之間分支,以及查看每一個要求的額外資訊時,可讓 XCT 建立相關性日誌記錄。 讓 XCT 建立相關性日誌記錄可能會大幅影響系統效能,因此最適合測試和開發環境使用。bprac
最佳作法 最佳作法: 當您希望將整個要求和回應主體儲存在檔案系統時,可讓 XCT 擷取資料 Snapshot。 讓 XCT 擷取資料 Snapshot 可能會大幅影響系統效能,因此最適合測試和開發環境使用。 XCT 會針對 SIBus 所處理的訊息要求和回應,擷取資料 Snapshot。bprac
避免困難 避免困難: 資料 Snapshot 會擷取並寫入到 $SERVER_LOG_ROOT/snapdata 目錄。 應用程式伺服器不會自動清除這個目錄的檔案。 當資料 Snapshot 擷取功能被啟用時,您必須定期刪除這個目錄的檔案。 資料 Snapshot 會儲存整個要求與回應內容,其中可能包含機密性資訊在內。 這個選項可能不適用於正式作業環境。gotcha
同時儲存配置的執行時期變更
指定執行中伺服器的動態狀態變更,以及伺服器配置的變更,都在下次重新啟動時生效。 如果未選取這個勾選框,伺服器就不會將設定複製到伺服器配置中。


檔名: utrb_loglevel.html