本篇文章給大家分享的是有關(guān)怎么在Asp.Net Core中使用NLog記錄日志,小編覺得挺實(shí)用的,因此分享給大家學(xué)習(xí),希望大家閱讀完這篇文章后可以有所收獲,話不多說,跟著小編一起來看看吧。
需求
1.日志自動寫入到數(shù)據(jù)庫、寫入到文件
2.appsettings.json數(shù)據(jù)庫連接更改后,不需要去改NLog中的連接地址,啟動網(wǎng)站或項(xiàng)目時自動檢測變動然后去更改,以appsettings.json為準(zhǔn),保持同步。
3.寫入日志時,除了NLog自帶的字段,新增LogType自定義字段記錄日志類型,例如網(wǎng)站日志、中間件日志等
4.統(tǒng)一的寫日志方法,不用每次get一個logger對象(或依賴注入)來記日志
安裝包
在nuget中安裝NLog
和NLog.Web.AspNetCore
,這兩個是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)閉。除非糾錯,不可以設(shè)為Trace否則速度很慢,起碼Debug以上--> <extensions> <add assembly="NLog.Web.AspNetCore" /> </extensions> <targets> <!--通過數(shù)據(jù)庫記錄日志 配置 dbProvider請選擇mysql或是sqlserver,同時注意連接字符串,需要安裝對應(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里用日志記錄的時候,取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時,如果NLog.config文件有變動,會自動應(yīng)用新配置(但是會有延遲,過幾秒才會應(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)中是各種記錄方式的配置第一個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ù)庫時insert語句,可以看到我這里是寫入到TblLogrecords表,表結(jié)構(gòu)下文會展示出來 parameter子節(jié)點(diǎn)是insert語句的各個參數(shù): 有個name="@LogType"
參數(shù),layout="${event-properties:item=LogType}",表示@LogType參數(shù)的值從event-properties中的LogType中取,這個后文會寫到用法其余參數(shù)均是NLog自帶的內(nèi)容,aspnet-
開頭的是NLog.Web.AspNetCore包中提供的方法 layout render官方文檔 第二個target節(jié)點(diǎn),可以看到name是log_file,這里的name和下方logger中writeTo屬性對應(yīng) xsi:type="File",即寫入到文件 fileName屬性是文件名,這里是寫入到當(dāng)前目錄下的logs文件夾,并且按日期歸檔 layout屬性是寫入日志的格式 rules節(jié)點(diǎn)是各個日志記錄器logger的配置 第一個logger配置跳過所有Microsoft組件的日志記錄,final 標(biāo)記當(dāng)前規(guī)則為最后一個規(guī)則。其后的規(guī)則即時匹配也不會被運(yùn)行。第二個logger name="logdb",該日志記錄器名為logdb,是適配log_database規(guī)則,即寫入數(shù)據(jù)庫,如果要適配多條規(guī)則,用逗號隔開其余規(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))//不一致則修改 { //這里暫時沒有考慮dbProvider的變動 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
完成后如下圖所示:
啟動項(xiàng)目同步連接字符串
修改網(wǎ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)目啟動時需要做的事情 //code NLogUtil.WriteDBLog(NLog.LogLevel.Trace, LogType.Web, "網(wǎng)站啟動成功"); host.Run(); } catch (Exception ex) { //使用nlog寫到本地日志文件(萬一數(shù)據(jù)庫沒創(chuàng)建/連接成功) string errorMessage = "網(wǎ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; } }
修改完成后,如下圖所示:
啟動驗(yàn)證
啟動項(xiàng)目,可以正常記錄日志到數(shù)據(jù)庫和文件:
ASP.NET 是開源,跨平臺,高性能,輕量級的 Web 應(yīng)用構(gòu)建框架,常用于通過 HTML、CSS、JavaScript 以及服務(wù)器腳本來構(gòu)建網(wǎng)頁和網(wǎng)站。
以上就是怎么在Asp.Net Core中使用NLog記錄日志,小編相信有部分知識點(diǎn)可能是我們?nèi)粘9ぷ鲿姷交蛴玫降摹OM隳芡ㄟ^這篇文章學(xué)到更多知識。更多詳情敬請關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。
名稱欄目:怎么在Asp.NetCore中使用NLog記錄日志-創(chuàng)新互聯(lián)
標(biāo)題網(wǎng)址:http://www.rwnh.cn/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)請盡快告知,我們將會在第一時間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容