JDK日志分級作為核心API最佳實踐淺析
JDK日志(Log)是什么?字典對其的解釋是"對某種機器工作情況或某項任務(wù)進展情況的記載"。對于應(yīng)用系統(tǒng)來說,JDK日志就應(yīng)該記錄應(yīng)用系統(tǒng)的運行狀況了。
是否需要記錄JDK日志?這個問題無需回答,這是毋庸置疑的--當然要記了。
剩下的問題就是應(yīng)該如何記錄日志才能確保日志具有高可用性和低耗性了。日志信息過于簡化,乃至于沒有日志,則用戶無法找到解決問題所需的信息,進而妨礙問題的解決;然而日志信息過于詳細不僅會降低系統(tǒng)的性能而且會使真正有用的信息淹沒在文字的海洋中。
為此JDK給出了建議的JDK日志分級標準。將不同的信息根據(jù)其重要性分級。與此同時可以根據(jù)實際需要在JRE中設(shè)置需要記錄的日志級別--級別高于此值的日志才被記錄。依照JDK提供的標準(java.util.logging.Level)將日志劃分為OFF、SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST、ALL等從高到低九個級別。他們都分別對應(yīng)著唯一的整數(shù)值,即OFF=Integer.MAX_VALUE、SEVERE=1000、WARNING=900、INFO=800、CONFIG=700、FINE=500、FINER=400、FINEST=300、ALL=Integer.MIN_VALUE。通過對java.util.logging.Level的泛化(擴展),開發(fā)人員可以在JDK提供的標準基礎(chǔ)之上定義自己的日志分級標準。
在這九個級別中OFF、SEVERE、WARNING、INFO、CONFIG、ALL比較容易理解。
OFF級別主要用于JRE日志輸出控制,表示不輸出任何信息。
◆SEVERE(嚴重)級別描述組織程序正常運行的重大事件。這些事件的表述必須能夠讓最終用戶和系統(tǒng)管理員清晰地了解到底發(fā)生了什么事情。
◆WARNING(警告)級別描述了最終用戶或系統(tǒng)管理員維護時比較感興趣的事件,或指示系統(tǒng)存在潛在問題的事件。這些事件都需要特別提醒最終用戶或系統(tǒng)管理員注意。
◆INFO(信息)級別主要用于描述輸出到控制臺或其替代品的,具有相當程度重大意義的事件。譬如系統(tǒng)的心跳信息,以及其他系統(tǒng)希望告知最終用戶或系統(tǒng)管理員的信息等。
◆CONFIG(配置)級別主要用于描述可以輔助調(diào)試解決問題的靜態(tài)配置信息。譬如CPU類型、操作系統(tǒng)類型、內(nèi)存容量、系統(tǒng)語言等等。
ALL級別也是主要用于JRE日志輸出控制,表示輸出所有日志信息。
FINE、FINER、FINEST等三個級別被用于描述不同程度的跟蹤信息。這三個級別被sun分別翻譯為"良好","較好"和"最好",但是筆者認為翻譯為"略細","較細","最細"更合適。這三個級別比較容易使人難于區(qū)分。到底什么樣的信息應(yīng)該以哪個級別輸出呢?
一般說來,F(xiàn)INE級別用于輸出開發(fā)人員廣泛關(guān)注的信息。包括小的可恢復(fù)的故障,潛在的性能問題、數(shù)據(jù)源連接不足、服務(wù)超時等。
FINER級別描述比FINE級別更詳細的信息。包括進入/返回方法調(diào)用,拋出了一個異常等信息。
FINEST級別描述更詳細的調(diào)試信息。包括開發(fā)人員在方法內(nèi)為了調(diào)試方便而輸出的調(diào)試信息,即某些日志分級系統(tǒng)中定義的DEBUG級別信息。
將方法調(diào)用/返回信息作為一個單獨的級別處理是一個明智的選擇。在解決系統(tǒng)運行問題時,通常根據(jù)方法調(diào)用/返回過程就能大致確定問題所在。
此JDK日志分級標準被廣泛地應(yīng)用于中小型系統(tǒng)中。更詳細的信息可以參考JDKAPI文檔的java.util.logging部分。那么這個介紹你是否對JDK日志分級有所了解了呢?
【編輯推薦】