一、為什麼使用log4net

日誌的重要性就闡述了，為什麼使用log4net，這裡說一下，因為使用人群廣泛，效能又相差無幾，那當然是用的人越多越好了，流量才是王道。

下面開始一步一步的通過程式碼和圖片的形式來使用log4net

第一步要建立一個配置檔案，起名字叫Log4net.config

程式碼如下

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <configSections>
        <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"
 
/>
    </configSections>

    <system.web>
        <compilation debug="true" targetFramework="4.5.2" />
        <httpRuntime targetFramework="4.5.2" />
    </system.web>
    <log4net>
        <!--錯誤日誌：：：記錄錯誤日誌-->
        <!--按日期分割日誌檔案 一天一個-->
        <!--
 
 appender 定義日誌輸出方式   將日誌以回滾檔案的形式寫到檔案中。-->
        <appender name="ErrorAppender" type="log4net.Appender.RollingFileAppender">
            <!--儲存路徑：log、logError檔案-->
            <file value="log/error/error_" />
            <!-- 如果想在本專案中新增路徑，那就直接去掉C:\\  只設置log\\LogError   專案啟動中預設建立檔案 
 
-->
            <appendToFile value="true"/>
            <!--按照何種方式產生多個日誌檔案(日期[Date],檔案大小[Size],混合[Composite])-->
            <rollingStyle value="Date"/>
            <!--這是按日期產生資料夾-->
            <datePattern value="yyyy-MM-dd'.log'"/>
            <!--是否只寫到一個檔案中-->
            <staticLogFileName value="false"/>
            <!--保留的log檔案數量 超過此數量後 自動刪除之前的   好像只有在 按Size分割時有效 設定值value="－1"為不限檔案數-->
            <param name="MaxSizeRollBackups" value="100"/>
            <!--每個檔案的大小。只在混合方式與檔案大小方式下使用。超出大小後在所有檔名後自動增加正整數重新命名，數字最大的最早寫入。可用的單位:KB|MB|GB。不要使用小數,否則會一直寫入當前日誌-->
            <maximumFileSize value="50MB" />
            <!-- layout 控制Appender的輸出格式，也可以是xml  一個Appender只能是一個layout-->
            <layout type="log4net.Layout.PatternLayout">
                <!--每條日誌末尾的文字說明-->
                <!--輸出格式 模板-->
                <!-- <param name="ConversionPattern"  value="記錄時間：%date 執行緒ID:[%thread] 日誌級別：%-5level 記錄類：%logger   
        操作者ID：%property{Operator} 操作型別：%property{Action}%n  當前機器名:%property%n當前機器名及登入使用者：%username %n  
        記錄位置：%location%n 訊息描述：%property{Message}%n   異常：%exception%n 訊息：%message%newline%n%n" />-->

                <!--樣例：2008-03-26 13:42:32,111 [10] INFO  Log4NetDemo.MainClass [(null)] - info-->
                <!--<conversionPattern value="%newline %n記錄時間：%date %n執行緒ID:[%thread] %n日誌級別： %-5level %n錯誤描述：%message%newline %n"/>-->
                <conversionPattern value="%n＝＝＝＝＝＝＝＝＝＝
                                  %n【日誌級別】%-5level
                                  %n【記錄時間】%date
                                  %n【執行時間】[%r]毫秒
                                  %n【錯誤位置】%logger 屬性[%property{NDC}]
                                  %n【錯誤描述】%message
                                  %n【錯誤詳情】%newline"/>
            </layout>
            <filter type="log4net.Filter.LevelRangeFilter,log4net">
                <levelMin value="ERROR" />
                <levelMax value="FATAL" />
            </filter>
        </appender>

        <!--DEBUG：：：記錄DEBUG日誌-->
        <!--按日期分割日誌檔案 一天一個-->
        <!-- appender 定義日誌輸出方式   將日誌以回滾檔案的形式寫到檔案中。-->
        <appender name="DebugAppender" type="log4net.Appender.RollingFileAppender">
            <!--儲存路徑：下面路徑專案啟動的時候自動建立log、logError檔案-->
            <file value="log/debug/debug_" />
            <!-- 如果想在本專案中新增路徑，那就直接去掉C:\\  只設置log\\LogError   專案啟動中預設建立檔案 -->
            <appendToFile value="true"/>
            <!--按照何種方式產生多個日誌檔案(日期[Date],檔案大小[Size],混合[Composite])-->
            <rollingStyle value="Date"/>
            <!--這是按日期產生資料夾-->
            <datePattern value="yyyy-MM-dd'.log'"/>
            <!--是否只寫到一個檔案中-->
            <staticLogFileName value="false"/>
            <!--保留的log檔案數量 超過此數量後 自動刪除之前的   好像只有在 按Size分割時有效 設定值value="－1"為不限檔案數-->
            <param name="MaxSizeRollBackups" value="100"/>
            <!--每個檔案的大小。只在混合方式與檔案大小方式下使用。超出大小後在所有檔名後自動增加正整數重新命名，數字最大的最早寫入。可用的單位:KB|MB|GB。不要使用小數,否則會一直寫入當前日誌-->
            <maximumFileSize value="50MB" />
            <!-- layout 控制Appender的輸出格式，也可以是xml  一個Appender只能是一個layout-->
            <layout type="log4net.Layout.PatternLayout">
                <!--每條日誌末尾的文字說明-->
                <!--輸出格式 模板-->
                <!-- <param name="ConversionPattern"  value="記錄時間：%date 執行緒ID:[%thread] 日誌級別：%-5level 記錄類：%logger   
        操作者ID：%property{Operator} 操作型別：%property{Action}%n  當前機器名:%property%n當前機器名及登入使用者：%username %n  
        記錄位置：%location%n 訊息描述：%property{Message}%n   異常：%exception%n 訊息：%message%newline%n%n" />-->

                <!--樣例：2008-03-26 13:42:32,111 [10] INFO  Log4NetDemo.MainClass [(null)] - info-->
                <!--<conversionPattern value="%newline %n記錄時間：%date %n執行緒ID:[%thread] %n日誌級別： %-5level %n錯誤描述：%message%newline %n"/>-->
                <conversionPattern value="%n＝＝＝＝＝＝＝＝＝＝
                                  %n【日誌級別】%-2level
                                  %n【記錄時間】%date
                                  %n【執行時間】[%r]毫秒
                                  %n【debug位置】%logger 屬性[%property{NDC}]
                                  %n【debug描述】%message"/>
            </layout>
            <filter type="log4net.Filter.LevelRangeFilter,log4net">
                <levelMin value="DEBUG" />
                <levelMax value="WARN" />
            </filter>
        </appender>
        <!--Set root logger level to DEBUG and its only appender to A1-->
        <root>
            <!--控制級別，由低到高: ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF-->
            <level value="ALL" />
            <appender-ref ref="DebugAppender" />
            <appender-ref ref="ErrorAppender" />
        </root>
    </log4net>
</configuration>

引用Nuget包 log4net 然後建立日誌處理類，在Api層中增加一個資料夾Log 建立兩個類 ILoggerHelper和 LoggerHelper

程式碼如下

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace WebApi.Core.Api.Log
{
    public interface ILoggerHelper
    {
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Debug(object source, string message);
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="ps">ps</param>
        void Debug(object source, string message, params object[] ps);
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Debug(Type source, string message);
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Info(object source, object message);
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Info(Type source, object message);
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Warn(object source, object message);
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Warn(Type source, object message);
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Error(object source, object message);
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Error(Type source, object message);
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Fatal(object source, object message);
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        void Fatal(Type source, object message);

        /* Log a message object and exception */

        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Debug(object source, object message, Exception exception);
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Debug(Type source, object message, Exception exception);
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Info(object source, object message, Exception exception);
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Info(Type source, object message, Exception exception);
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Warn(object source, object message, Exception exception);
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Warn(Type source, object message, Exception exception);
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Error(object source, object message, Exception exception);
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Error(Type source, object message, Exception exception);
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Fatal(object source, object message, Exception exception);
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        void Fatal(Type source, object message, Exception exception);
    }
}

這裡面會有一個報錯，往下繼續看，沒關係下面會新增的

using log4net;
using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace WebApi.Core.Api.Log
{
    public class LoggerHelper:ILoggerHelper
    {
        private readonly ConcurrentDictionary<Type, ILog> Loggers = new ConcurrentDictionary<Type, ILog>();

        /// <summary>
        /// 獲取記錄器
        /// </summary>
        /// <param name="source">soruce</param>
        /// <returns></returns>
        private ILog GetLogger(Type source)
        {
            if (Loggers.ContainsKey(source))
            {
                return Loggers[source];
            }
            else
            {
                ILog logger = LogManager.GetLogger(Startup.repository.Name, source);
                Loggers.TryAdd(source, logger);
                return logger;
            }
        }

        /* Log a message object */
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Debug(object source, string message)
        {
            Debug(source.GetType(), message);
        }
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="ps">ps</param>
        public void Debug(object source, string message, params object[] ps)
        {
            Debug(source.GetType(), string.Format(message, ps));
        }
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Debug(Type source, string message)
        {
            ILog logger = GetLogger(source);
            if (logger.IsDebugEnabled)
            {
                logger.Debug(message);
            }
        }
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Info(object source, object message)
        {
            Info(source.GetType(), message);
        }
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Info(Type source, object message)
        {
            ILog logger = GetLogger(source);
            if (logger.IsInfoEnabled)
            {
                logger.Info(message);
            }
        }
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Warn(object source, object message)
        {
            Warn(source.GetType(), message);
        }
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Warn(Type source, object message)
        {
            ILog logger = GetLogger(source);
            if (logger.IsWarnEnabled)
            {
                logger.Warn(message);
            }
        }
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Error(object source, object message)
        {
            Error(source.GetType(), message);
        }
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Error(Type source, object message)
        {
            ILog logger = GetLogger(source);
            if (logger.IsErrorEnabled)
            {
                logger.Error(message);
            }
        }
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Fatal(object source, object message)
        {
            Fatal(source.GetType(), message);
        }
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        public void Fatal(Type source, object message)
        {
            ILog logger = GetLogger(source);
            if (logger.IsFatalEnabled)
            {
                logger.Fatal(message);
            }
        }
        /* Log a message object and exception */

        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Debug(object source, object message, Exception exception)
        {
            Debug(source.GetType(), message, exception);
        }
        /// <summary>
        /// 除錯資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Debug(Type source, object message, Exception exception)
        {
            GetLogger(source).Debug(message, exception);
        }
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Info(object source, object message, Exception exception)
        {
            Info(source.GetType(), message, exception);
        }
        /// <summary>
        /// 關鍵資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Info(Type source, object message, Exception exception)
        {
            GetLogger(source).Info(message, exception);
        }
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Warn(object source, object message, Exception exception)
        {
            Warn(source.GetType(), message, exception);
        }
        /// <summary>
        /// 警告資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Warn(Type source, object message, Exception exception)
        {
            GetLogger(source).Warn(message, exception);
        }
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Error(object source, object message, Exception exception)
        {
            Error(source.GetType(), message, exception);
        }
        /// <summary>
        /// 錯誤資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Error(Type source, object message, Exception exception)
        {
            GetLogger(source).Error(message, exception);
        }
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Fatal(object source, object message, Exception exception)
        {
            Fatal(source.GetType(), message, exception);
        }
        /// <summary>
        /// 失敗資訊
        /// </summary>
        /// <param name="source">source</param>
        /// <param name="message">message</param>
        /// <param name="exception">ex</param>
        public void Fatal(Type source, object message, Exception exception)
        {
            GetLogger(source).Fatal(message, exception);
        }
    }
}

在startup.cs 檔案中新增Loger日誌倉庫變數

/// <summary>
        /// log4net 倉儲庫
        /// </summary>
        public static ILoggerRepository repository { get; set; }

ConfigureServices 方法中注入ILoggerHelper和日誌啟動

//log注入ILoggerHelper
            services.AddSingleton<ILoggerHelper, LoggerHelper>();

            //log4net
            repository = LogManager.CreateRepository("WebApi.Core.Api");//專案名稱
            XmlConfigurator.Configure(repository, new FileInfo("log4net.config"));//指定配置檔案，

還是很簡單的，接下來我們測試一下

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Newtonsoft.Json.Linq;
using WebApi.Core.Api.Log;
using WebApi.Core.IService;
using WebApi.Core.Service;

namespace WebApi.Core.Api.Controllers
{
    /// <summary>
    /// 測試倉儲模式控制元件
    /// </summary>
    public class TestRepositoryController : BaseController
    {
        //宣告一個常量
        private readonly ITestService testService;
        //宣告一個日誌常量
        private readonly ILoggerHelper _logger;
        //建構函式注入 service
        public TestRepositoryController(ITestService testS,ILoggerHelper loggerHelper)
        {
            testService = testS;
            _logger = loggerHelper;
        }

        /// <summary>
        /// 測試倉儲模式，求和表示層
        /// </summary>
        /// <param name="i"></param>
        /// <param name="j"></param>
        /// <returns></returns>
        [HttpPost]
        public int SumService(int i, int j)
        {
            return testService.SumService(i,j);
        }
        /// <summary>
        /// 測試日誌
        /// </summary>
        /// <returns></returns>
        [HttpGet]
        public IActionResult LogTest()
        {
            _logger.Error(typeof(TestRepositoryController),"這是錯誤日誌",new Exception("123"));
            _logger.Debug(typeof(TestRepositoryController),"這個是bug日誌");
            return Ok();
        }
    }
}

F5除錯一下，請求成功日誌也準確的記錄了。

我們在新建一個全域性異常過濾器，來看看日誌的記錄，在api層新建一個資料夾 Filter建立GlobalExceptionFilter.cs

程式碼如下

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using Microsoft.Extensions.Hosting;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using WebApi.Core.Api.Log;

namespace WebApi.Core.Api.Filter
{
    public class GlobalExceptionFilter: IExceptionFilter
    {
        private readonly IHostEnvironment _env;
        private readonly ILoggerHelper _loggerHelper;

        public GlobalExceptionFilter(IHostEnvironment env, ILoggerHelper loggerHelper)
        {
            _env = env;
            _loggerHelper = loggerHelper;
        }

        public void OnException(ExceptionContext context)
        {
            var json = new JsonErrorResponse();
            json.Message = context.Exception.Message;//錯誤資訊
            if (_env.IsDevelopment())
            {
                json.DevelopmentMessage = context.Exception.StackTrace;//堆疊資訊
            }
            context.Result = new InternalServerErrorObjectResult(json);

            //採用log4net 進行錯誤日誌記錄
            _loggerHelper.Error(json.Message, "出現未知異常", context.Exception);

        }

        public class InternalServerErrorObjectResult : ObjectResult
        {
            public InternalServerErrorObjectResult(object value) : base(value)
            {
                StatusCode = StatusCodes.Status500InternalServerError;
            }
        }
        //返回錯誤資訊
        public class JsonErrorResponse
        {
            /// <summary>
            /// 生產環境的訊息
            /// </summary>
            public string Message { get; set; }
            /// <summary>
            /// 開發環境的訊息
            /// </summary>
            public string DevelopmentMessage { get; set; }
        }
    }
}

我們在ConfigureServices 方法中 注入全域性異常過濾器

我們來測試一下，在之前的Action中加丟擲異常

F5除錯一下，異常是丟擲了，我們看一下日誌檔案裡面 有沒有記錄到

可以看到日誌已經被記錄了，這樣系統丟擲的所有異常就可以都被記錄下來

簡單講一下log4net 的結構吧，四種主要的元件，Logger（記錄器）、Repository（庫）、Appender（附著器）、Layout（佈局）

Logger： 是應用程式需要互動的主要元件，用來產生日誌訊息的，繼承自 ILog介面，

還有一個LogManager來管理Logger物件，有一個GetLogger（）靜態方法來檢索Logger物件，如果不存在則會建立一個Logger物件

通常會用（class）的型別（type）為引數來呼叫，以方便跟蹤我們正在進行日誌記錄的類。可以使用typeif（classname）方法獲得

Repository：logger 倉庫，主要用於日誌物件組織結構的維護，使用框架的話不需要知道，如果是擴充套件的話可以自行查詢一下。

Appender：定義輸出的介質，一個Appender物件預設的將所有的日誌事件傳遞到輸出流，Appender Filters 可以按照不同的標準過濾日誌事件

Layout：該元件用於向用戶展示最後經過格式化的輸出資訊，輸出的資訊可以有多種格式，就是依賴採用的Layout元件型別。一般跟Appender一起出現，

一個Appender 只能對應一個Layout物件。

日誌級別（Level）：由高到低 OFF > FATAL > ERROR > WARN > INFO > DEBUG > ALL