JDK日志分級作為核心API最佳實踐淺析

作者：小海 2009-07-07 16:13:39

JDK日志分級作為核心API最佳實踐是什么情況呢？對于不同的信息根據其重要性分級的情況如何呢？本文將就JDK日志分級向你介紹。

JDK日志(Log)是什么?字典對其的解釋是"對某種機器工作情況或某項任務進展情況的記載"。對于應用系統來說，JDK日志就應該記錄應用系統的運行狀況了。

是否需要記錄JDK日志?這個問題無需回答，這是毋庸置疑的--當然要記了。

剩下的問題就是應該如何記錄日志才能確保日志具有高可用性和低耗性了。日志信息過于簡化，乃至于沒有日志，則用戶無法找到解決問題所需的信息，進而妨礙問題的解決;然而日志信息過于詳細不僅會降低系統的性能而且會使真正有用的信息淹沒在文字的海洋中。

為此JDK給出了建議的JDK日志分級標準。將不同的信息根據其重要性分級。與此同時可以根據實際需要在JRE中設置需要記錄的日志級別--級別高于此值的日志才被記錄。依照JDK提供的標準(java.util.logging.Level)將日志劃分為OFF、SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST、ALL等從高到低九個級別。他們都分別對應著唯一的整數值，即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的泛化(擴展)，開發人員可以在JDK提供的標準基礎之上定義自己的日志分級標準。

在這九個級別中OFF、SEVERE、WARNING、INFO、CONFIG、ALL比較容易理解。

OFF級別主要用于JRE日志輸出控制，表示不輸出任何信息。

◆SEVERE(嚴重)級別描述組織程序正常運行的重大事件。這些事件的表述必須能夠讓最終用戶和系統管理員清晰地了解到底發生了什么事情。

◆WARNING(警告)級別描述了最終用戶或系統管理員維護時比較感興趣的事件，或指示系統存在潛在問題的事件。這些事件都需要特別提醒最終用戶或系統管理員注意。

◆INFO(信息)級別主要用于描述輸出到控制臺或其替代品的，具有相當程度重大意義的事件。譬如系統的心跳信息，以及其他系統希望告知最終用戶或系統管理員的信息等。

◆CONFIG(配置)級別主要用于描述可以輔助調試解決問題的靜態配置信息。譬如CPU類型、操作系統類型、內存容量、系統語言等等。

ALL級別也是主要用于JRE日志輸出控制，表示輸出所有日志信息。

FINE、FINER、FINEST等三個級別被用于描述不同程度的跟蹤信息。這三個級別被sun分別翻譯為"良好"，"較好"和"最好"，但是筆者認為翻譯為"略細"，"較細"，"最細"更合適。這三個級別比較容易使人難于區分。到底什么樣的信息應該以哪個級別輸出呢?

一般說來，FINE級別用于輸出開發人員廣泛關注的信息。包括小的可恢復的故障，潛在的性能問題、數據源連接不足、服務超時等。

FINER級別描述比FINE級別更詳細的信息。包括進入/返回方法調用，拋出了一個異常等信息。

FINEST級別描述更詳細的調試信息。包括開發人員在方法內為了調試方便而輸出的調試信息，即某些日志分級系統中定義的DEBUG級別信息。

將方法調用/返回信息作為一個單獨的級別處理是一個明智的選擇。在解決系統運行問題時，通常根據方法調用/返回過程就能大致確定問題所在。