若是你是一名優(yōu)良的應用系統(tǒng)開發(fā)人員，想必應該十分清晰在應用系統(tǒng)運行期間，打印日記有多么重要。它不單可以記錄應用系統(tǒng)運行情況及軌跡，還有助于提拔毛病排查及定位問題的效率，以至還能夠?qū)ζ渫Ｖ龟U發(fā)及監(jiān)控，洞察系統(tǒng)隱患，提早預警防備。

但并非說只要打印盡可能多的日記，就能輕松獲得那些才能。設想一下，若是你毫無所懼地打印了一堆毫無價值的日記，那請問日記又何以可以來為你供給價值呢。由此可見，那里的核心關鍵點其實不在于日記的幾，而在于日記打印能否標準且合理。

不標準合理的日記，不單無法闡揚感化產(chǎn)生價值，還會增加毛病定位難度、降低處理效率，以及額外增加日記存儲成本，消耗應用系統(tǒng)性能。在極端情況下，以至還會對應用系統(tǒng)形成致命性沖擊，引發(fā)應用系統(tǒng)癱瘓的可能。

講到那，我想你應該大白我想說的——應用系統(tǒng)日記打印確實十分重要，但日記打印標準將更為重要，它就像一把雙刃劍，只要合理運用才氣闡揚其特有的感化及價值。

但在組織中，若是你想讓你四周的人都能大白那個事理可其實不容易，它需要一個漫長的傳布過程，而在那個過程中，你不只需要對峙不竭地宣導來逐漸加強他們的認知，還應借助需要的治理手段及東西平臺停止輔助，只要利其所器，才氣善其所事。

利器一：標準先行

在你想啟動標準化日記打印前，建議先造定一份日記打印標準，它可能無法八面玲瓏，但沒有關系，它的目標僅是為了先突顯日記打印標準的重要性，而且讓那件工作可以正式進入正軌。

若是組織中大部門都是Java應用，那么標準內(nèi)容能夠次要圍繞Java應用來寫，固然無法籠蓋所有開發(fā)語言，但其核心原則仍是能夠借鑒的。別的，前期請務必不要將其復雜化，不然它將無法具備普適性，也無法被承受和傳布。

Java應用系統(tǒng)日記打印標準

1）Java日記框架

常用的Java日記框架可選擇Log4j/Logback/Log4j2等，但為了制止后續(xù)改換日記框架所帶來的額外革新成本，建議將接口層和實現(xiàn)層停止別離，將SLF4J做為接口層，將Log4j/Logback/Log4j2做為實現(xiàn)層，兩者通過橋接的體例停止集成。

2）Java日記標準

標準一：【強迫】級別只允許利用ERROR、WARN、INFO、DEBUG，定義如下：

標準二：【強迫】制止利用Logback/Log4j2等的API，應利用SLF4J的API。

標準三：【強迫】在接口/辦法的入口/出口處，打印懇求及響應參數(shù)日記。

標準四：【強迫】ERROR級別日記需打印倉庫，而非ERROR級別日記則不需要。

標準五：【強迫】制止在代碼輪回體中間接打印非DEBUG級此外日記。

標準六：【強迫】制止日記打印內(nèi)容中僅打印特殊字符或數(shù)字的情況。

標準七：【建議】日記內(nèi)容中應包羅關鍵特征類信息，例如：用戶標識或流水號。

標準八：【建議】應接納異步打印形式，且打印時建議封閉打印位置信息。

標準九：【建議】日記打印若呈現(xiàn)梗塞，建議至少丟棄INFO級別以上的日記。

標準十：【建議】每條日記在語義上可獨立被理解，削減上下文聯(lián)系關系理解。

*）Java日記字段

注：位置信息包羅類(class)/文件(file)/行號(line)/辦法(method)，若打印位置信息，則對性能有所影響。

以上僅是一些標準參考，你能夠按照組織中的現(xiàn)實情況來停止調(diào)整，但標準僅僅只是標準，有了它其實不代表你已達成目的，只能申明你已為日記打印標準化那件事，邁出了第一步。

利器二：辦事至上

當造定完應用系統(tǒng)日記打印標準后，請不要夢想有任何人會來自覺地遵守它，一是不知它的存在，二是他們無從下手，三是各人都挺“忙”的。我把它總結為六字實言，別離是“不知”、“不會”、“不想”。

我曾見過組織中的有些標準，出格是手藝標準，在造定完成后就會被長久地封存起來，沒有人曉得，也沒有人想曉得。所以，要落實好標準，你還得構想一套戰(zhàn)術才行。不然，那些無法落實的標準就和廢紙毫無兩樣。

在良多人眼里，可能會將標準視為是一種約束，而又錯誤地將約束理解為貶義詞，從而避而遠之。那種曲解的發(fā)作，其原因其實不出在他們自己，而更多的出在那些造定例范的人身上。

有些標準造定者不單沒有身在此中，以至也沒有去詮釋標準所能帶來的價值，而僅僅只是強行推行那份冷冰冰的標準，請問此時誰會愿意在不知其所以然的情況下，無緣無故地背上那繁重的“承擔”。

因而，你必需得為那份標準付與更多的“溫度”，而主動辦事可能會是一種比力好的“升溫”體例。但在動作前，切忌不要站在他們的對立面，并請做好放低姿勢的覺悟，你要讓對方深入的意識到你和他們是統(tǒng)一陣營的。

在發(fā)布標準后的初期，你能夠測驗考試挑選幾個日記打印情況最為蹩腳的應用系統(tǒng)，飾演為“VIP私家助理”來與對方進一步傳達標準內(nèi)容及感化，并為他們一一列舉出當前存在的日記打印問題，以及那些問題會對系統(tǒng)形成哪些影響。

那種體例不單可以制止僅用文字傳達所產(chǎn)生的理解誤差，及時有效地為對方解答各類疑問，使他們可以更深一步天文解標準內(nèi)容及感化，還可以讓標準造定者更進一步地領會對方的顧忌及困難，并從同理心視角動身，為對方供給更好的建議及處理思緒。

就如許*個、10個、1*個應用系統(tǒng)......在精神有限的前提下逐漸擴大輻射范疇，事實證明，那種主動辦事+循序漸進的體例對提拔標準的承受度將會有所幫忙。不外在過程中你仍然需要不竭回看標準的合理性及適用性，并對標準做出及時且有效的調(diào)整。

利器三：度量為王

當標準逐步被更多的人承受后，你的任務并沒有完成，而實正的考驗才剛剛起頭。一是承受其實不代表整改，二是若何驗證整改有效性，三是整改能否可持續(xù)性。若是那些問題都不在你的考慮范疇內(nèi)，那你可能會前功盡棄。

若想要處理以上那些問題，借助度量或許會是一個不錯的選擇。辦理巨匠德魯克曾說過：“沒有度量，就沒有辦理”，它同樣適用于標準的落實工做，你能夠按照日記打印標準來造定一些度量目標，并配套研發(fā)響應的度量東西平臺。

通過度量東西平臺“可視化”和“自助化”的兩種特征，閃開發(fā)人員可以及時發(fā)現(xiàn)日記打印標準的問題，還可以讓他們自主驗證日記打印標準整改后的效果，從而讓他們感觸感染到一種“看得見”+“摸得著”的平安感。

此中，度量目標的設想將會尤其重要，往往一個不合理的目標，會讓整個工作朝著料想中的反標的目的開展。所以，在初期其實不建議你設想過多的度量目標，并建議從度量難度、影響水平、達成難度、可解釋性四個方面停止綜合性評估，以確定較為合理的目標。

如下是其時初期選擇的8個目標。

注：以上僅列出目標，目標要求建議你可按照現(xiàn)實情況停止動態(tài)調(diào)整，但過高的目標要求會變得毫無意義。

可能會有人提出，關于規(guī)模較大且日記條數(shù)較多的應用系統(tǒng)，能否可放寬目標要求，那聽上去仿佛蠻有事理的，但我卻其實不那么認為。規(guī)模越大意味著所承載的職責和才能也就越大，一旦發(fā)作毛病影響面也就越大，所以反倒更應該到達目標要求。

那些目標固然有必然的指點性，但似乎其實不能滿足開發(fā)人員的“胃口”，因為那些目標仍然無法間接表露問題根源，也無法讓他們可快速定位及明白優(yōu)化標的目的。因而，你還得付與目標必然的闡發(fā)才能。

例如：訂單系統(tǒng)單日ERROR級別日記888條（占日記總量0.0*%），（TOP1）*0%在com.OrderService的第88行。（TOP2）10%在com.PayService的第188行。

就如許，你能夠逐漸完美目標系統(tǒng)及配套的闡發(fā)才能，但請在設想每一個目標時，遵照先輩行系統(tǒng)現(xiàn)狀摸排，再停止小范疇試點運行，最初停止持續(xù)不雅測并調(diào)優(yōu)，從而確保每一個目標的設想都具備必然的合理性和可解釋性。

如下列出了一些目標，僅供參考。

除此之外，你還能夠?qū)⒉顒e應用系統(tǒng)的目標停止橫向比照，并接納排行榜的形式在科技內(nèi)部停止公開，它將會產(chǎn)生一種改動行為的驅(qū)動力，能夠有效激發(fā)“想要贏”和“不想失敗”的心理活動，那就比如某些產(chǎn)物也會接納排行榜的體例來鼓勵用戶一樣。

通過設想目標系統(tǒng)+研發(fā)度量平臺+公開排行榜單那三個手段的組合，在必然水平上能夠驅(qū)動開發(fā)人員持續(xù)性整改日記打印的問題。但萬事無絕對，那些始末無動于衷的人仍然會存在，不外請不要強行要求對方，究竟結果有時候存期近合理。

寫在最初

日記打印標準當然重要，但也請不要過火逃捧，它的核心價值仍是在于可以幫忙開發(fā)人員更好地記錄應用系統(tǒng)的“案發(fā)現(xiàn)場”，并可為應用系統(tǒng)供給可持續(xù)改良的“線索”。但請服膺，日記打印標準雖不是全能的，但沒有日記打印標準卻是千萬不克不及的。

做者丨陳俊

來源丨公家號：手藝奇奧物語（ID：gh_cfee2fb*4*bc）

021yin.com

更多出色內(nèi)容

11月1*日下戰(zhàn)書14:00，dbaplus社群聯(lián)袂中國銀行，圍繞“中國銀行運維轉(zhuǎn)型與敏捷開發(fā)摸索理論”那一主題開展線上曲播分享，針對運維監(jiān)控、混沌工程、DevOps等內(nèi)容停止深度切磋，為金融業(yè)的數(shù)字化轉(zhuǎn)型供給更多新思緒。

021yin.com/*t8OC

關于我們

dbaplus社群是圍繞Database、BigData、AIOps的企業(yè)級專業(yè)社群。資深大咖、手藝干貨，每天精品原創(chuàng)文章推送，每周線上手藝分享，每月線下手藝沙龍，每季度GdevopsDAMS行業(yè)大會。

存眷公家號【dbaplus社群】，獲取更多原創(chuàng)手藝文章和精選東西下載