.NET 6 NLog

1、安裝 NLog.Web.AspNetCore 包

2、新增Configs檔案夾，在Configs檔案夾下新增nlog.config檔案

nlog.config檔案內容如下

<?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">

    <targets>
        <!--此部分中的所有目標將自動異步-->
        <target name="InfoFile" xsi:type="AsyncWrapper">
            <!--專案日志保存檔案路徑說明fileName="${basedir}/保存目錄，以年月日的格式創建/${shortdate}/${記錄器名稱}-${單級記錄}-${shortdate}.txt"-->
            <target name="log_file" xsi:type="File"
                    fileName="${basedir}/Logs/${shortdate}/${shortdate}-InfoFile.txt"
                    layout="${longdate} | ${message} ${onexception:${exception:format=message} ${newline} ${stacktrace} ${newline}"
                    archiveFileName="${basedir}/archives/${logger}-${level}-${shortdate}-{#####}.txt"
                    archiveAboveSize="102400"
                    archiveNumbering="Sequence"
                    concurrentWrites="true"
                    keepFileOpen="false" />
        </target>

        <target name="WarnFile" xsi:type="AsyncWrapper">
            <!--專案日志保存檔案路徑說明fileName="${basedir}/保存目錄，以年月日的格式創建/${shortdate}/${記錄器名稱}-${單級記錄}-${shortdate}.txt"-->
            <target name="log_file" xsi:type="File"
                    fileName="${basedir}/Logs/${shortdate}/${shortdate}-WarnFile.txt"
                    layout="${longdate} | ${message} ${onexception:${exception:format=message} ${newline} ${stacktrace} ${newline}"
                    archiveFileName="${basedir}/archives/${logger}-${level}-${shortdate}-{#####}.txt"
                    archiveAboveSize="102400"
                    archiveNumbering="Sequence"
                    concurrentWrites="true"
                    keepFileOpen="false" />
        </target>
        
        <!--使用可自定義的著色將日志訊息寫入控制臺-->
        <target name="colorConsole" xsi:type="ColoredConsole" layout="[${date:format=HH\:mm\:ss}]:${message} ${exception:format=message}" />
    </targets>

    <!--規則配置,final - 最終規則匹配后不處理任何規則-->
    <rules>
        <logger name="Microsoft.*" minlevel="Info" writeTo="" final="true" />
        <logger name="*" minlevel="Info" writeTo="InfoFile" />
        <logger name="*" minlevel="Warn" writeTo="WarnFile" />
        <!--<logger name="*" minlevel="Warn" writeTo="colorConsole" /> 如果需要列印在控制臺則可以這樣配置-->
    </rules>

3、Program.cs 中 注入

// NLog：注冊Nlog組件
builder.Logging.AddNLog("Configs/nlog.config");

4、新增幫助類LoggerHelper

    /// <summary>
    /// nLog使用幫助類
    /// </summary>
    public class LoggerHelper
    {
        /// <summary>
        /// 實體化nLog，即為獲取組態檔相關資訊(獲取以當前正在初始化的類命名的記錄器)
        /// </summary>
        private readonly static NLog.Logger _logger = LogManager.GetCurrentClassLogger();

        private static LoggerHelper _obj;

        public static LoggerHelper _
        {
            get => _obj ?? (new LoggerHelper());
            set => _obj = value;
        }

        #region Debug，除錯
        public static void Debug(string msg)
        {
            _logger.Debug(msg);
        }

        public void Debug(string msg, Exception err)
        {
            _logger.Debug(err, msg);
        }
        #endregion

        #region Info，資訊
        public static void Info(string msg)
        {
            _logger.Info(msg);
        }

        public void Info(string msg, Exception err)
        {
            _logger.Info(err, msg);
        }
        #endregion

        #region Warn，警告
        public static void Warn(string msg)
        {
            _logger.Warn(msg);
        }

        public void Warn(string msg, Exception err)
        {
            _logger.Warn(err, msg);
        }
        #endregion

        #region Trace，追蹤
        public void Trace(string msg)
        {
            _logger.Trace(msg);
        }

        public void Trace(string msg, Exception err)
        {
            _logger.Trace(err, msg);
        }
        #endregion

        #region Error，錯誤
        public void Error(string msg)
        {
            _logger.Error(msg);
        }

        public void Error(string msg, Exception err)
        {
            _logger.Error(err, msg);
        }
        #endregion

        #region Fatal,致命錯誤
        public void Fatal(string msg)
        {
            _logger.Fatal(msg);
        }

        public void Fatal(string msg, Exception err)
        {
            _logger.Fatal(err, msg);
        }
        #endregion
    }

5、呼叫

在介面或者需要寫入日志的地方

LoggerHelper.Info("TEST111111111111111111111111111111111111111111111");
            LoggerHelper.Warn("TEST222222222222222222222222222222222222222222"); 

說明：本內容僅僅作為學習記錄，無任何商業目的，

標籤：.NET Core

上一篇：型別轉換

下一篇：ASP.NET Core - 選型系統之選型配置