核心API最佳實踐——JDK日志分級

2019-11-18 11:54:46

字體：大中小

來源：轉載

供稿：網友

　　日志（Log）是什么？字典對其的解釋是"對某種機器工作情況或某項任務進展情況的記載"。對于應用系統來說，日志就應該記錄應用系統的運行狀況了。
　　
　　是否需要記錄日志？這個問題無需回答，這是毋庸置疑的--當然要記了。
　　
　　剩下的問題就是應該如何記錄日志才能確保日志具有高可用性和低耗性了。日志信息過于簡化，乃至于沒有日志，則用戶無法找到解決問題所需的信息，進而妨礙問題的解決；然而日志信息過于具體不僅會降低系統的性能而且會使真正有用的信息沉沒在文字的海洋中。
　　
　　為此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級別信息。
　　
　　將方法調用/返回信息作為一個單獨的級別處理是一個明智的選擇。在解決系統運行問題時，通常根據方法調用/返回過程就能大致確定問題所在。
　　
　　此日志分級標準被廣泛地應用于中小型系統中。更具體的信息可以參考JDKAPI文檔的java.util.logging部分。

上一篇：J2SE5.0用Executor靈活處理事件下發

下一篇：Java EJB容器的存取和實現