前言
一直很喜歡 NLog 的簡(jiǎn)潔和擴(kuò)展性，所以準(zhǔn)備將 ASP.NET Core 提供的默認(rèn)日志提供程序替換成 NLog。
NLog 是一個(gè)跨平臺(tái)的 .Net 日志組件。
NLog 遵從 BSD license，即允許商業(yè)應(yīng)用且完全開(kāi)放源代碼。任何人都可以免費(fèi)使用并對(duì)其進(jìn)行測(cè)試，然后通過(guò)郵件列表反饋問(wèn)題以及建議。
下面話不多說(shuō)了，來(lái)一起看看詳細(xì)的介紹吧。
步驟 1
在項(xiàng)目的project.json中添加依賴NLog.Extensions.Logging：
|
1
2
3
|
"dependencies": { "NLog.Extensions.Logging": "1.0.0-*"} |
或者通過(guò)NuGet程序包管理器添加。
步驟 2
在ASP.NET Core的啟動(dòng)類Startup的Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)方法中添加：
|
1
2
3
4
5
|
// using NLog.Extensions.Logging;loggerFactory.AddNLog();//needed for non-NETSTANDARD platforms: configure nlog.config in your project rootenv.ConfigureNLog("nlog.config"); |
步驟 3
在項(xiàng)目目錄下添加nlog.config文件：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
<?xml version="1.0" encoding="utf-8" ?><nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" autoReload="true" throwConfigExceptions="true" internalLogLevel="Warn" internalLogToTrace="true" internalLogFile="AppData/Logs/NLogInternal.log"> <!-- - 日志文件被放置于 AppData/Logs 文件夾中，文件名為 {日志類目}.log 或 {日志類目}.err - 日志按天存檔，放置于 AppData/Logs/Archives/{日志類目} 文件夾中，文件名為 {日期}.log 或 {日期}.err --> <targets> <!-- 通過(guò) System.Diagnostics.Trace 輸出由 EF 6 產(chǎn)生的數(shù)據(jù)庫(kù)日志可以在 VS 輸出窗口看到 --> <target name="XXX.Entities.AppDbContext.DatabaseLog.Trace" xsi:type="Trace" layout="${message}" /> <!-- 在控制臺(tái)輸出由 EF 6 產(chǎn)生的數(shù)據(jù)庫(kù)日志 --> <target name="XXX.Entities.AppDbContext.DatabaseLog.Console" xsi:type="Console" layout="${message}" /> <!-- 在日志文件輸出由 EF 6 產(chǎn)生的數(shù)據(jù)庫(kù)日志 --> <target name="XXX.Entities.AppDbContext.DatabaseLog.File" xsi:type="File" layout="${message}" encoding="utf-8" archiveNumbering="Date" archiveEvery="Day" archiveDateFormat="yyyy-MM-dd" archiveFileName="AppData/Logs/Archives/XXX.Entities.AppDbContext.Database/{#}.log" fileName="AppData/Logs/XXX.Entities.AppDbContext.Database.log" /> <!-- 常規(guī)的 Trace 輸出，調(diào)試時(shí)可以在 VS 輸出窗口看到 --> <target name="TRACE" xsi:type="Trace" layout="[${longdate}] ${pad:padding=-5:inner=${level:uppercase=true}} ${logger}: ${newline}${message}${onexception:inner=${newline}${exception:format=ToString}}${newline}" /> <!-- 常規(guī)的控制臺(tái)輸出 --> <target name="CONSOLE" xsi:type="Console" layout="[${longdate}] ${pad:padding=-5:inner=${level:uppercase=true}} ${logger}: ${newline}${message}${onexception:inner=${newline}${exception:format=ToString}}${newline}" /> <!-- 常規(guī)的日志文件輸出 --> <target name="LOG_FILE" xsi:type="File" layout="[${longdate}] ${pad:padding=-5:inner=${level:uppercase=true}} ${logger}: ${newline}${message}${onexception:inner=${newline}${exception:format=ToString}}${newline}" encoding="utf-8" archiveNumbering="Date" archiveEvery="Day" archiveDateFormat="yyyy-MM-dd" archiveFileName="AppData/Logs/Archives/${filesystem-normalize:inner=${logger}}/{#}.log" fileName="AppData/Logs/${filesystem-normalize:inner=${logger}}.log" /> <!-- 約定以 err 為文件后綴的日志文件記錄了程序輸出的警告或者錯(cuò)誤。 --> <target name="ERROR_LOG_FILE" xsi:type="File" layout="[${longdate}] ${pad:padding=-5:inner=${level:uppercase=true}} ${logger}: ${newline}${message}${onexception:inner=${newline}${exception:format=ToString}}${newline}" encoding="utf-8" archiveNumbering="Date" archiveEvery="Day" archiveDateFormat="yyyy-MM-dd" archiveFileName="AppData/Logs/Archives/${filesystem-normalize:inner=${logger}}/{#}.err" fileName="AppData/Logs/${filesystem-normalize:inner=${logger}}.err" /> </targets> <rules> <!-- 記錄所有日志級(jí)別不低于 Warn 的日志到日志文件 --> <logger name="*" minlevel="Warn" writeTo="ERROR_LOG_FILE" /> <!-- 記錄 EF 生成的 SQL 語(yǔ)句 --> <logger name="XXX.Entities.AppDbContext.DatabaseLog" minlevel="Debug" writeTo="XXX.Entities.AppDbContext.DatabaseLog.Trace,XXX.Entities.AppDbContext.DatabaseLog.Console,XXX.Entities.AppDbContext.DatabaseLog.File" final="true" /> <!-- 除非調(diào)試需要，把 .NET Core 程序集的 Debug 輸出都屏蔽 --> <logger name="Microsoft.*" minLevel="Info" writeTo="CONSOLE,TRACE,LOG_FILE" final="true" /> <!-- 除非調(diào)試需要，把系統(tǒng)的 Debug 輸出都屏蔽 --> <logger name="System.*" minLevel="Info" writeTo="CONSOLE,TRACE,LOG_FILE" final="true" /> <!-- 記錄應(yīng)用程序的 Debug 輸出 --> <logger name="MyApplication.*" minlevel="Debug" writeTo="TRACE,CONSOLE,LOG_FILE" /> </rules></nlog> |
NLog 配置文件屬性解讀：
- autoReload 是否監(jiān)視配置文件的變化并自動(dòng)加載。
- throwConfigExceptions 是否在配置出錯(cuò)時(shí)拋出異常。
- internalLogLevel NLog 內(nèi)部日志級(jí)別。
- internalLogToTrace 是否將 NLog 內(nèi)部日志輸出到 Trace。
- internalLogFile NLog 內(nèi)部日志輸出到文件的路徑。
步驟 4
在project.json文件中的publishOptions.include節(jié)內(nèi)添加"nlog.config"：
|
1
2
3
4
5
6
7
8
9
10
11
|
"publishOptions": { "include": [ "wwwroot", "Views", "Areas/**/Views", "appsettings.json", "web.config", "nlog.config" ]} |
總結(jié)
以上就是這篇文章的全部?jī)?nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，如果有疑問(wèn)大家可以留言交流，謝謝大家對(duì)服務(wù)器之家的支持。
原文鏈接：https://blog.csdn.net/cheer_cheer/article/details/51946590
