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

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

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

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

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

利器一：標(biāo)準(zhǔn)先行

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

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

Java應(yīng)用系統(tǒng)日記打印標(biāo)準(zhǔn)

1）Java日記框架

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

2）Java日記標(biāo)準(zhǔn)

標(biāo)準(zhǔn)一：【強(qiáng)迫】級別只允許利用ERROR、WARN、INFO、DEBUG，定義如下：

標(biāo)準(zhǔn)二：【強(qiáng)迫】制止利用Logback/Log4j2等的API，應(yīng)利用SLF4J的API。

標(biāo)準(zhǔn)三：【強(qiáng)迫】在接口/辦法的入口/出口處，打印懇求及響應(yīng)參數(shù)日記。

標(biāo)準(zhǔn)四：【強(qiáng)迫】ERROR級別日記需打印倉庫，而非ERROR級別日記則不需要。

標(biāo)準(zhǔn)五：【強(qiáng)迫】制止在代碼輪回體中間接打印非DEBUG級此外日記。

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

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

標(biāo)準(zhǔn)八：【建議】應(yīng)接納異步打印形式，且打印時建議封閉打印位置信息。

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

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

*）Java日記字段

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

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

利器二：辦事至上

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

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

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

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

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

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

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

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

利器三：度量為王

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

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

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

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

如下是其時初期選擇的8個目標(biāo)。

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

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

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

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

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

如下列出了一些目標(biāo)，僅供參考。

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

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

寫在最初

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

做者丨陳俊

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

021yin.com

更多出色內(nèi)容

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

021yin.com/*t8OC

關(guān)于我們

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

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