人力資源LogNet培訓(xùn)

1、Log44Nett培訓(xùn)文文檔目錄TOC o 1-7 h z u HYPERLINK l _Toc205613494 一.概述述 PAGEREF _Toc205613494 h 1 HYPERLINK l _Toc205613495 二.Loog4NNet系系統(tǒng) PAGEREF _Toc205613495 h 1 HYPERLINK l _Toc205613496 1程序結(jié)結(jié)構(gòu) PAGEREF _Toc205613496 h 1 HYPERLINK l _Toc205613497 ILogggerr PAGEREF _Toc205613497 h 1 HYPERLINK l _Toc205613

2、498 IIApppennderr PAGEREF _Toc205613498 h 2 HYPERLINK l _Toc205613499 IIILLayoout PAGEREF _Toc205613499 h 55 HYPERLINK l _Toc205613500 IVFiilteer PAGEREF _Toc205613500 h 6 HYPERLINK l _Toc205613501 2日志級(jí)級(jí)別 PAGEREF _Toc205613501 h 6 HYPERLINK l _Toc205613502 三.Loog4NNet的的使用方方法 PAGEREF _Toc205613502 h

3、7 HYPERLINK l _Toc205613503 1編寫配配置信息息 PAGEREF _Toc205613503 h 7 HYPERLINK l _Toc205613504 2配置初初始化 PAGEREF _Toc205613504 h 77 HYPERLINK l _Toc205613505 3獲得記記錄器 PAGEREF _Toc205613505 h 77 HYPERLINK l _Toc205613506 4使用記記錄器進(jìn)進(jìn)行記錄錄 PAGEREF _Toc205613506 h 7 HYPERLINK l _Toc205613507 四.擴(kuò)展展Logg4Neet PAGEREF

4、 _Toc205613507 h 8 HYPERLINK l _Toc205613508 1對(duì)FiileAAppeendeer和RolllinngLoogFiileAAppeendeer PAGEREF _Toc205613508 h 8 HYPERLINK l _Toc205613509 1對(duì)RoolliingLLogFFileeApppendder PAGEREF _Toc205613509 h 88 HYPERLINK l _Toc205613510 2對(duì)SmmtpAAppeendeer PAGEREF _Toc205613510 h 8 HYPERLINK l _Toc20561351

5、1 五.實(shí)例例演示 PAGEREF _Toc205613511 h 88概述Log44Nett是一開開源軟件件。本文檔檔對(duì)loog4nnet的的使用進(jìn)進(jìn)行描述述。Log44Nett系統(tǒng)程序結(jié)構(gòu)構(gòu)我們在使使用Log44Nett的時(shí)候候，主要要關(guān)注如如下幾個(gè)個(gè)部分：Loggger日志記錄錄器，我我們在程程序里使使用這個(gè)個(gè)管理器器來進(jìn)行行日志記記錄操作作。在一份程程序里可可以有多多個(gè)looggeer，每每個(gè)looggeer都可可以在配配置文件件控制，通通過程序序調(diào)用。比如在配配置文件件里配置置： 則在程序序里，我我們可以以這樣獲獲得這個(gè)個(gè)記錄器器：privvateestaaticc loog4nne

6、t.ILoog llog = llog44nett.LoogMaanagger.GettLogggerr(MMaillLogggerr);得到記錄錄器之后后，我們們可以通通過如下下方法記記錄日志志。log.Errror(messsagge, e)log.Errror(messsagge)log.Debbug(messsagge, e)log.Debbug(messsagge)log.Warrn(mmesssagee, ee)log.Warrn(mmesssagee)log.Fattal(messsagge, e)log.Fattal(messsagge)log.Inffo(mmesssagee

7、, ee)log.Inffo(mmesssagee)Appeendeer日志記錄錄設(shè)備，指我們希望把日志記錄到數(shù)據(jù)庫/文件，或者發(fā)郵件等，每種方式都有一個(gè)獨(dú)立的Appender實(shí)現(xiàn)。Appeendeer通常常都在配配置文件件里進(jìn)行行控制，對(duì)對(duì)于我們們來說，在程序里不顯式使用，它由logger調(diào)用。如在配置置文件里里定義： 當(dāng)我們進(jìn)進(jìn)行了這這樣的定定義之后后，只是是說明了了我們有有了這個(gè)個(gè)Apppendder，會(huì)會(huì)不會(huì)使使用這個(gè)個(gè)Apppendder，則則由looggeer配置置節(jié)控制制。要使用這這個(gè)Apppennderr，在lloogger里里設(shè)置： 則這個(gè)AAppeendeer會(huì)在在寫日志志

8、的時(shí)候候調(diào)用。多個(gè)Apppennderr可以同同時(shí)被一一個(gè)looggeer使用用，即一一份日志志可以保保存到多多個(gè)設(shè)備備上。定義一個(gè)個(gè)apppendder，需需要指定定屬性及及參數(shù)，如如下介紹紹常用的的RolllinngLoogFiileAAppeendeer和SmttpApppennderr的定義義。Appeendeer屬性性：屬性名描述namee必選項(xiàng)，可可隨意起起名字，被被logggerr配置引引用typee必選項(xiàng)，必必須是AAppeendeer已定定義類型型，如llog44nett.Apppennderr.RoolliingFFileeApppendderRolllinggLoggFi

9、lleApppennderr(文件記記錄)參數(shù)：參數(shù)名描述filtter可以有00或多個(gè)個(gè)fillterr，具體體配置在在下面的的Fillterr項(xiàng)說明明。 layoout可以有00或者說說1個(gè)llayoout，當(dāng)沒有l(wèi)ayout時(shí)，沒有輸出。具體配置在下面的layout項(xiàng)說明paraamParaam有多多個(gè)可以以進(jìn)行配配置，常常用的：名稱描述File文件路徑，如果RollingStyle為Composite或Date，則這里設(shè)置為目錄，文件名在DatePattern里設(shè)置，其他則這里要有文件名。已經(jīng)擴(kuò)展支持虛擬目錄RollingStyle創(chuàng)建新文件的方式，可選為Size（按文件大?。?，Dat

10、e（按日期），Once（每啟動(dòng)一次創(chuàng)建一個(gè)文件），Composite（按日期及文件大?。J(rèn)為CompositeDatePattern當(dāng)RollingStyle為Composite或Date，這里設(shè)置文件名格式StaticLogFileNameTrue/false，默認(rèn)為true。為true時(shí)，RollingStyler的date值將無效。且為true時(shí)，需要在file里指定文件名，所有日志都會(huì)記錄在這個(gè)文件里。MaximumFileSize當(dāng)RollingStyle為Composite或Size，這里設(shè)置最大文件大?。梢訩B，MB，GB為單位，默認(rèn)為字節(jié)）CountDirection默認(rèn)

11、值為-1。當(dāng)文件超過MaximumFileSize的大小時(shí)，如果要?jiǎng)?chuàng)建新的文件來存儲(chǔ)日志，會(huì)根據(jù)CountDirection的值來重命名文件。大于-1的值時(shí)，file里指定的文件名會(huì)依次加上.0,.1,.2遞增。當(dāng)?shù)扔诨蛐∮?1時(shí)，創(chuàng)建依賴于MaxSizeRollBackups參數(shù)值，創(chuàng)建備份日志數(shù)。MaxSizeRollBackups備份日志數(shù)目，默認(rèn)為0。在CountDirection為負(fù)數(shù)時(shí)有效。Threshold起始日志級(jí)別，取值為下面文章討論的預(yù)定義日志級(jí)別。低于此級(jí)別的日志不會(huì)被記錄。AppendToFileTrue/false，默認(rèn)為true。當(dāng)文件存在時(shí)，是否在原文件上追加內(nèi)容

12、。例如： SmtppApppendder(郵件通通知)參參數(shù)：參數(shù)名描述filtter可以有00或多個(gè)個(gè)fillterr，具體體配置在在下面的的Fillterr項(xiàng)說明明。 layoout可以有00或者說說1個(gè)llayoout，當(dāng)當(dāng)沒有l(wèi)layoout時(shí)時(shí)，沒有有輸出。具體配配置在下下面的llayoout項(xiàng)項(xiàng)說明paraamParaam有多多個(gè)可以以進(jìn)行配配置，常常用的：名稱描述authentication默認(rèn)為none，可選basic和NtlmsmtpHostusernamepasswordfrom發(fā)送人郵件地址to接收人郵件地址subject郵件主題Priority郵件優(yōu)先級(jí)。默認(rèn)為Norm

13、al，可設(shè)置為HighbufferSize日志緩沖器大小，默認(rèn)值為512。當(dāng)設(shè)置為小于2的值時(shí)，等于沒有緩沖器。一旦日志數(shù)量達(dá)到緩沖器大小時(shí)，程序會(huì)把日志全部發(fā)出去。evaluator估算器，當(dāng)估算器里的條件成立時(shí)，會(huì)馬上把緩沖器里的日志發(fā)送出去。語法如下： Log4net只預(yù)定義了一個(gè)Level估算器，我們可以改變threshold的等級(jí)起始值。意思為：當(dāng)級(jí)別在debug或以上時(shí)，會(huì)立即把日志內(nèi)容發(fā)送郵件。lossyTrue/false，默認(rèn)為false。觸發(fā)事件是否會(huì)有可能丟失，取決于這個(gè)值。當(dāng)為true時(shí)，必須指定evaluator，以便有“可能丟失的觸發(fā)事件”。比如這個(gè)值為true時(shí)，

14、當(dāng)緩沖到達(dá)，同時(shí)有符合evaluator的觸發(fā)條件時(shí)，會(huì)把觸發(fā)事件丟棄。例如： Layoout日志布局局設(shè)計(jì)器器，指我我們希望望輸出哪哪些數(shù)據(jù)據(jù)，這些些數(shù)據(jù)又又以什么么樣的格格式輸出出。Layoout通通常都在在配置文文件里進(jìn)進(jìn)行控制制，對(duì)于于我們來來說，在在程序里里不顯式式使用，它它由Apppennderr調(diào)用。并且在在Apppendder配配置節(jié)里里進(jìn)行定定義。 每個(gè)apppennderr對(duì)應(yīng)一一個(gè)laayouut。常常用的llayoout：PattternnLayyoutt屬性：屬性名描述typee必選項(xiàng)，必必須是已已定義類類型，如如logg4neet.LLayoout.Pattterr

15、nLaayouut 參數(shù)：屬性名描述Footter日志的底底部文字字，自定定義的字字符串Headder日志的頭頭部文字字，自定定義的字字符串ConvverssionnPattterrn轉(zhuǎn)換格式式。所有有數(shù)據(jù)都都在這里里輸出。轉(zhuǎn)換格式式由三部部分組成成：自定定義字符符串+%修飾符符+數(shù)據(jù)據(jù)變量+自定義義字符串串?dāng)?shù)據(jù)變量量：Conversion Pattern NameEffectAppdomain(a)Used to output the friendly name of the AppDomain where the logging event was generated. Date(d)%d

16、ateHH:mm:ss,fff or %datedd MMM yyyy HH:mm:ss,fff. exception異常Level(p)當(dāng)前級(jí)別Logger(c)當(dāng)前l(fā)ogger名稱Message(m)記錄的信息Newline(n)新行Timestamp(r)應(yīng)用程序工作時(shí)間Thread(t)線程名稱或線程號(hào)碼. utcdate%utcdateHH:mm:ss,fff or %utcdatedd MMM yyyy HH:mm:ss,fff. %The sequence % outputs a single percent sign. 修飾符：Format modifiercomment%20

17、logger小于20字符時(shí)左填充%-20logger小于20字符時(shí)右填充. %.30logger大于30時(shí)截取%20.30logger小于20字符時(shí)左填充. 大于30時(shí)截取%-20.30logger小于20字符時(shí)右填充. 大于30時(shí)截取Filtter日志過濾濾器。除除了級(jí)別別限制之外外，我們們還可以以添加過過濾器，以以指示該該日志是是否需要要記錄。Filtter通通常都在在配置文文件里進(jìn)進(jìn)行控制制，對(duì)于于我們來來說，在在程序里里不顯式式使用，它它由Apppennderr調(diào)用。 一個(gè)apppennderr可以有有多個(gè)ffiltter，按按在配置置文件里里出現(xiàn)的的次序進(jìn)行行檢查。常用的的有：Lev

18、eelRaangeeFillterrStriingMMatcchFiilteer日志級(jí)別別日志的級(jí)級(jí)別可以以在多個(gè)個(gè)地方定定義，apppendder參參數(shù)里的的Thrreshholdd屬性定定義的lleveel，logggerr的leevell，rooot節(jié)節(jié)點(diǎn)里的的levvel，如果這三個(gè)地方均沒有定義，則默認(rèn)”Debug”級(jí)別。當(dāng)這幾個(gè)地方有兩個(gè)以上定義了level，則按下表的優(yōu)先級(jí)，取最高優(yōu)先級(jí)的level。此外，級(jí)別還受appender里定義的filter里的level范圍限制。各個(gè)級(jí)別別的優(yōu)先先級(jí)如下下：級(jí)別代碼碼級(jí)別描述述優(yōu)先級(jí)OFF關(guān)閉最高FATAAL嚴(yán)重ERROOR錯(cuò)誤INFO

19、O信息DEBUUG調(diào)試ALL全部最低Log44Nett的使用用方法編寫配置置信息Log44nett的行為為控制大大多都可可以在配配置文件件里完成成，因此此，編寫寫配置信信息是使使用Loog4nnet的的必要步步驟，同同時(shí)也是是最大的的難點(diǎn)。配置文件件可以在在webb.coonfiig里，也也可以放放在獨(dú)立立的文件件中。配置初始始化可在gllobaal程序序啟動(dòng)事事件里進(jìn)進(jìn)行初始始化。voidd Apppliicattionn_Sttartt(obbjecct ssendder, EvventtArggs ee) Systtem.IO.FilleInnfo filleInnfo = nnew Sysstemm.IOO.FiileIInfoo(Seerveer.MMapPPathh(/SysstemmConnfigg/loog4nnetCConffig.xmll);/loog4nnet.Connfigg.XmmlCoonfiigurratoor.CConffiguure(filleInnfo); logg4neet.CConffig.XmllConnfigguraatorr.CoonfiigurreAnndWaatchh(fiileIInfoo);獲得記錄錄器p