本篇文章給大家分享的是有關(guān)怎么在Asp.Net Core中使用NLog記錄日志,小編覺得挺實(shí)用的,因此分享給大家學(xué)習(xí),希望大家閱讀完這篇文章后可以有所收獲,話不多說,跟著小編一起來看看吧。

需求
1.日志自動(dòng)寫入到數(shù)據(jù)庫、寫入到文件
2.appsettings.json數(shù)據(jù)庫連接更改后,不需要去改NLog中的連接地址,啟動(dòng)網(wǎng)站或項(xiàng)目時(shí)自動(dòng)檢測變動(dòng)然后去更改,以appsettings.json為準(zhǔn),保持同步。
3.寫入日志時(shí),除了NLog自帶的字段,新增LogType自定義字段記錄日志類型,例如網(wǎng)站日志、中間件日志等
4.統(tǒng)一的寫日志方法,不用每次get一個(gè)logger對象(或依賴注入)來記日志
安裝包
在nuget中安裝NLog和NLog.Web.AspNetCore ,這兩個(gè)是NLog相關(guān)的包。
還需要安裝NLog寫入數(shù)據(jù)庫的數(shù)據(jù)庫適配器,我這里寫入到MySQL數(shù)據(jù)庫,所以安裝MySql.Data
如果是寫入到SQL server數(shù)據(jù)庫,需要安裝Microsoft.Data.SqlClient

NLog.config 配置文件內(nèi)容
網(wǎng)站根目錄下新建NLog.config配置文件,記得右擊該文件“屬性”,復(fù)制到輸出目錄:“始終復(fù)制”
NLog.config文件內(nèi)容:
<?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"
throwExceptions="false"
internalLogLevel="Off"
internalLogFile="NlogRecords.log">
<!--Nlog內(nèi)部日志記錄為Off關(guān)閉。除非糾錯(cuò),不可以設(shè)為Trace否則速度很慢,起碼Debug以上-->
<extensions>
<add assembly="NLog.Web.AspNetCore" />
</extensions>
<targets>
<!--通過數(shù)據(jù)庫記錄日志 配置
dbProvider請選擇mysql或是sqlserver,同時(shí)注意連接字符串,需要安裝對應(yīng)的sql數(shù)據(jù)提供程序
MYSQL:
dbProvider="MySql.Data.MySqlClient.MySqlConnection, MySql.Data"
connectionString="server=localhost;database=BaseMIS;user=root;password=123456"
MSSQL:
dbProvider="Microsoft.Data.SqlClient"
connectionString="Server=127.0.0.1;Database=BaseMIS;User ID=sa;Password=123456"
-->
<target name="log_database" xsi:type="Database" dbProvider="MySql.Data.MySqlClient.MySqlConnection, MySql.Data"
connectionString="server=192.168.137.10;database=TestNLog;user=root;password=mysql@local">
<commandText>
INSERT INTO TblLogrecords
(LogDate,LogLevel,LogType,Logger,Message,MachineName,MachineIp,NetRequestMethod
,NetRequestUrl,NetUserIsauthenticated,NetUserAuthtype,NetUserIdentity,Exception)
VALUES
(@LogDate,@LogLevel,@LogType,@Logger,@Message,@MachineName,@MachineIp,@NetRequestMethod
,@NetRequestUrl,@NetUserIsauthenticated,@NetUserAuthtype,@NetUserIdentity,@Exception);
</commandText>
<parameter name="@LogDate" layout="${date}" />
<parameter name="@LogLevel" layout="${level}" />
<parameter name="@LogType" layout="${event-properties:item=LogType}" />
<parameter name="@Logger" layout="${logger}" />
<parameter name="@Message" layout="${message}" />
<parameter name="@MachineName" layout="${machinename}" />
<parameter name="@MachineIp" layout="${aspnet-request-ip}" />
<parameter name="@NetRequestMethod" layout="${aspnet-request-method}" />
<parameter name="@NetRequestUrl" layout="${aspnet-request-url}" />
<parameter name="@NetUserIsauthenticated" layout="${aspnet-user-isauthenticated}" />
<parameter name="@NetUserAuthtype" layout="${aspnet-user-authtype}" />
<parameter name="@NetUserIdentity" layout="${aspnet-user-identity}" />
<parameter name="@Exception" layout="${exception:tostring}" />
</target>
<target name="log_file" xsi:type="File" fileName="${basedir}/logs/${shortdate}.log"
layout="${longdate} | ${level:uppercase=false} | ${message} ${onexception:${exception:format=tostring} ${newline} ${stacktrace} ${newline}" />
</targets>
<rules>
<!--跳過所有級別的Microsoft組件的日志記錄-->
<logger name="Microsoft.*" final="true" />
<!-- BlackHole without writeTo -->
<!--只通過數(shù)據(jù)庫記錄日志,如果給了name名字,cs里用日志記錄的時(shí)候,取logger需要把name當(dāng)做參數(shù)-->
<logger name="logdb" writeTo="log_database" />
<logger name="logfile" writeTo="log_file" />
</rules>
</nlog>配置文件解讀 nlog根節(jié)點(diǎn): autoReload屬性,true時(shí),如果NLog.config文件有變動(dòng),會(huì)自動(dòng)應(yīng)用新配置(但是會(huì)有延遲,過幾秒才會(huì)應(yīng)用起來) internalLogLevel屬性,設(shè)定后,輸出的是NLog內(nèi)部自己的日志記錄,如果遇到NLog異常/配置文件沒配好,可以把Off改為Trace或Debug來查看NlogRecords.log里的內(nèi)容 internalLogFile屬性,可以設(shè)定路徑,例如默認(rèn)的c:\temp\nlog-internal.log 新增了extensions節(jié)點(diǎn),因?yàn)橐昧?code>NLog.Web.AspNetCore包 targets節(jié)點(diǎn)中是各種記錄方式的配置第一個(gè)target節(jié)點(diǎn),可以看到name是log_database,這里的name和下方logger中writeTo屬性對應(yīng) xsi:type="Database",就是寫入數(shù)據(jù)庫了 dbProvider屬性是數(shù)據(jù)庫適配器,MySQL是MySql.Data.MySqlClient.MySqlConnection, MySql.Data,SQL server是Microsoft.Data.SqlClient,其他數(shù)據(jù)庫適配器可在官方文檔內(nèi)查看 connectionString即連接字符串了 commandText子節(jié)點(diǎn)是插入數(shù)據(jù)庫時(shí)insert語句,可以看到我這里是寫入到TblLogrecords表,表結(jié)構(gòu)下文會(huì)展示出來 parameter子節(jié)點(diǎn)是insert語句的各個(gè)參數(shù): 有個(gè)name="@LogType"參數(shù),layout="${event-properties:item=LogType}",表示@LogType參數(shù)的值從event-properties中的LogType中取,這個(gè)后文會(huì)寫到用法其余參數(shù)均是NLog自帶的內(nèi)容,aspnet-開頭的是NLog.Web.AspNetCore包中提供的方法 layout render官方文檔 第二個(gè)target節(jié)點(diǎn),可以看到name是log_file,這里的name和下方logger中writeTo屬性對應(yīng) xsi:type="File",即寫入到文件 fileName屬性是文件名,這里是寫入到當(dāng)前目錄下的logs文件夾,并且按日期歸檔 layout屬性是寫入日志的格式 rules節(jié)點(diǎn)是各個(gè)日志記錄器logger的配置 第一個(gè)logger配置跳過所有Microsoft組件的日志記錄,final 標(biāo)記當(dāng)前規(guī)則為最后一個(gè)規(guī)則。其后的規(guī)則即時(shí)匹配也不會(huì)被運(yùn)行。第二個(gè)logger name="logdb",該日志記錄器名為logdb,是適配log_database規(guī)則,即寫入數(shù)據(jù)庫,如果要適配多條規(guī)則,用逗號(hào)隔開其余規(guī)則可以參考https://www.jb51.net/article/173004.htm 數(shù)據(jù)庫配置數(shù)據(jù)表結(jié)構(gòu)
這里數(shù)據(jù)庫為TestNLog:
CREATE DATABASE IF NOT EXISTS `TestNLog`; USE `TestNLog`; -- Dumping structure for table TestNLog.TblLogrecords CREATE TABLE IF NOT EXISTS `TblLogrecords` ( `Id` int(11) NOT NULL AUTO_INCREMENT, `LogDate` datetime(6) NOT NULL, `LogLevel` varchar(50) NOT NULL, `LogType` varchar(50) DEFAULT NULL, `Logger` varchar(256) NOT NULL, `Message` longtext, `MachineName` varchar(50) DEFAULT NULL, `MachineIp` varchar(50) DEFAULT NULL, `NetRequestMethod` varchar(10) DEFAULT NULL, `NetRequestUrl` varchar(500) DEFAULT NULL, `NetUserIsauthenticated` varchar(10) DEFAULT NULL, `NetUserAuthtype` varchar(50) DEFAULT NULL, `NetUserIdentity` varchar(50) DEFAULT NULL, `Exception` longtext, PRIMARY KEY (`Id`) ) ENGINE=InnoDB AUTO_INCREMENT=96 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
網(wǎng)站配置連接
appsettings.json中增加ConectionStrings節(jié)點(diǎn):
"ConectionStrings": {
"MySqlConnection": "server=192.168.137.10;database=TestNLog;user=root;password=mysql@local"
}統(tǒng)一日志記錄方法
網(wǎng)站下新建CommonUtils文件夾,添加NLogUtil.cs文件(包含LogType定義):
using NLog;
using NLog.Config;
using System;
using System.ComponentModel;
using System.Linq;
using System.Xml.Linq;
namespace NLogUsage.CommonUtils
{
public enum LogType
{
[Description("網(wǎng)站")]
Web,
[Description("數(shù)據(jù)庫")]
DataBase,
[Description("Api接口")]
ApiRequest,
[Description("中間件")]
Middleware
}
public static class NLogUtil
{
public static Logger dbLogger = LogManager.GetLogger("logdb");
public static Logger fileLogger = LogManager.GetLogger("logfile");
/// <summary>
/// 寫日志到數(shù)據(jù)庫
/// </summary>
/// <param name="logLevel">日志等級</param>
/// <param name="logType">日志類型</param>
/// <param name="message">信息</param>
/// <param name="exception">異常</param>
public static void WriteDBLog(LogLevel logLevel, LogType logType, string message, Exception exception = null)
{
LogEventInfo theEvent = new LogEventInfo(logLevel, dbLogger.Name, message);
theEvent.Properties["LogType"] = logType.ToString();
theEvent.Exception = exception;
dbLogger.Log(theEvent);
}
/// <summary>
/// 寫日志到文件
/// </summary>
/// <param name="logLevel">日志等級</param>
/// <param name="logType">日志類型</param>
/// <param name="message">信息</param>
/// <param name="exception">異常</param>
public static void WriteFileLog(LogLevel logLevel, LogType logType, string message, Exception exception = null)
{
LogEventInfo theEvent = new LogEventInfo(logLevel, fileLogger.Name, message);
theEvent.Properties["LogType"] = logType.ToString();
theEvent.Exception = exception;
fileLogger.Log(theEvent);
}
/// <summary>
/// 確保NLog配置文件sql連接字符串正確
/// </summary>
/// <param name="nlogPath"></param>
/// <param name="sqlConnectionStr"></param>
public static void EnsureNlogConfig(string nlogPath, string sqlConnectionStr)
{
XDocument xd = XDocument.Load(nlogPath);
if (xd.Root.Elements().FirstOrDefault(a => a.Name.LocalName == "targets")
is XElement targetsNode && targetsNode != null &&
targetsNode.Elements().FirstOrDefault(a => a.Name.LocalName == "target" && a.Attribute("name").Value == "log_database")
is XElement targetNode && targetNode != null)
{
if (!targetNode.Attribute("connectionString").Value.Equals(sqlConnectionStr))//不一致則修改
{
//這里暫時(shí)沒有考慮dbProvider的變動(dòng)
targetNode.Attribute("connectionString").Value = sqlConnectionStr;
xd.Save(nlogPath);
//編輯后重新載入配置文件(不依靠NLog自己的autoReload,有延遲)
LogManager.Configuration = new XmlLoggingConfiguration(nlogPath);
}
}
}
}
}配置NLog依賴注入
網(wǎng)站Program.cs文件中,在CreateHostBuilder方法中添加以下內(nèi)容:
//using NLog.Web;
.ConfigureLogging(logging => {
logging.ClearProviders();
logging.SetMinimumLevel(Microsoft.Extensions.Logging.LogLevel.Trace);
}).UseNLog(); // NLog: 依賴注入Nlog完成后如下圖所示:

啟動(dòng)項(xiàng)目同步連接字符串
修改網(wǎng)站啟動(dòng)Program.cs中的邏輯:
//using NLogUsage.CommonUtils;
//using Microsoft.Extensions.DependencyInjection;
public static void Main(string[] args)
{
//CreateHostBuilder(args).Build().Run();
var host = CreateHostBuilder(args).Build();
try
{
using (IServiceScope scope = host.Services.CreateScope())
{
IConfiguration configuration = scope.ServiceProvider.GetRequiredService<IConfiguration>();
//獲取到appsettings.json中的連接字符串
string sqlString = configuration.GetSection("ConectionStrings:MySqlConnection").Value;
//確保NLog.config中連接字符串與appsettings.json中同步
NLogUtil.EnsureNlogConfig("NLog.config", sqlString);
}
//throw new Exception("測試異常");//for test
//其他項(xiàng)目啟動(dòng)時(shí)需要做的事情
//code
NLogUtil.WriteDBLog(NLog.LogLevel.Trace, LogType.Web, "網(wǎng)站啟動(dòng)成功");
host.Run();
}
catch (Exception ex)
{
//使用nlog寫到本地日志文件(萬一數(shù)據(jù)庫沒創(chuàng)建/連接成功)
string errorMessage = "網(wǎng)站啟動(dòng)初始化數(shù)據(jù)異常";
NLogUtil.WriteFileLog(NLog.LogLevel.Error, LogType.Web, errorMessage, new Exception(errorMessage, ex));
NLogUtil.WriteDBLog(NLog.LogLevel.Error, LogType.Web, errorMessage, new Exception(errorMessage, ex));
throw;
}
}修改完成后,如下圖所示:

啟動(dòng)驗(yàn)證
啟動(dòng)項(xiàng)目,可以正常記錄日志到數(shù)據(jù)庫和文件:

ASP.NET 是開源,跨平臺(tái),高性能,輕量級的 Web 應(yīng)用構(gòu)建框架,常用于通過 HTML、CSS、JavaScript 以及服務(wù)器腳本來構(gòu)建網(wǎng)頁和網(wǎng)站。
以上就是怎么在Asp.Net Core中使用NLog記錄日志,小編相信有部分知識(shí)點(diǎn)可能是我們?nèi)粘9ぷ鲿?huì)見到或用到的。希望你能通過這篇文章學(xué)到更多知識(shí)。更多詳情敬請關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。
名稱欄目:怎么在Asp.NetCore中使用NLog記錄日志-創(chuàng)新互聯(lián)
標(biāo)題網(wǎng)址:http://www.chinadenli.net/article28/pcdcp.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供小程序開發(fā)、網(wǎng)站制作、App開發(fā)、網(wǎng)站改版、網(wǎng)頁設(shè)計(jì)公司、軟件開發(fā)
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容