Asp.Net Core 進階（二） —— 集成Log4net

　　Asp.Net Core 支持適用於各類內置日誌記錄API，同時也支持其餘第三方日誌記錄。在咱們新建項目後，在Program 文件入口調用了CreateDefaultBuilder，該操做默認將添加如下日誌記錄提供程序：ConsoleLogger、DebugLogger、EventSourceLogger。

　　在工做中筆者使用的最多的日誌記錄組件是log4net，接下來咱們就來看一下在Asp.Net Core中怎麼集成 log4net。

　　首先咱們須要添加 log4net 組件，經過Nuget安裝 log4net 和 Microsoft.Extensions.Logging.Log4Net.AspNetCore。

　　接着咱們引入配置文件log4net.config，放在項目config文件夾下

<?xml version="1.0" encoding="utf-8"?>
<log4net>
  <!-- Define some output appenders -->
  <appender name="rollingAppender" type="log4net.Appender.RollingFileAppender">
    <file value="log\log.txt" />

    <!--追加日誌內容-->
    <appendToFile value="true" />

    <!--防止多線程時不能寫Log,官方說線程非安全-->
    <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />

    <!--能夠爲:Once|Size|Date|Composite-->
    <!--Composite爲Size和Date的組合-->
    <rollingStyle value="Composite" />

    <!--當備份文件時,爲文件名加的後綴-->
    <datePattern value="yyyyMMdd.TXT" />

    <!--日誌最大個數,都是最新的-->
    <!--rollingStyle節點爲Size時,只能有value個日誌-->
    <!--rollingStyle節點爲Composite時,天天有value個日誌-->
    <maxSizeRollBackups value="20" />

    <!--可用的單位:KB|MB|GB-->
    <maximumFileSize value="3MB" />

    <!--置爲true,當前最新日誌文件名永遠爲file節中的名字-->
    <staticLogFileName value="true" />

    <!--輸出級別在INFO和ERROR之間的日誌-->
    <filter type="log4net.Filter.LevelRangeFilter">
      <param name="LevelMin" value="ALL" />
      <param name="LevelMax" value="FATAL" />
    </filter>

    <!--必須結合起來用,第一個只過濾出WARN,第二個拒絕其它其它日誌輸出-->
    <!--
        <filter type="log4net.Filter.LevelMatchFilter">
            <param name="LevelToMatch" value="WARN" />
        </filter>
        <filter type="log4net.Filter.DenyAllFilter" />-->

    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date [%thread] %-5level %logger - %message%newline"/>
    </layout>
  </appender>


  <!-- levels: OFF > FATAL > ERROR > WARN > INFO > DEBUG  > ALL -->
  <root>
    <priority value="ALL"/>
    <level value="ALL"/>
    <appender-ref ref="rollingAppender" />
  </root>
</log4net>

　　而後在Program文件中進行配置日誌，若是不須要使用ConsoleLogger,DebugLogger或EventSourceLogger，能夠使用ClearProviders方法清空默認的日誌記錄組件，AddFilter是過濾掉系統自帶的System，Microsoft開頭的日誌，LogLevel。具體作法參考如下代碼

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
    .ConfigureLogging((context, loggingBuilder) =>
    {
        //loggingBuilder.ClearProviders();
        loggingBuilder.AddFilter("System", LogLevel.Warning);
        loggingBuilder.AddFilter("Microsoft", LogLevel.Warning);//過濾掉系統自帶的System，Microsoft開頭的，級別在Warning如下的日誌
        loggingBuilder.AddLog4Net("config/log4net.config"); //會讀取appsettings.json的Logging:LogLevel:Default級別
    })
    .UseStartup<Startup>();

　　配置完log4net後，能夠使用 ILoggerFactory 或者 ILogger<T> 來記錄日誌，具體作法以下，其中的ILoggerFactory能夠替換成ILogger<Starup>。

public void Configure(IApplicationBuilder app, IHostingEnvironment env,ILoggerFactory logFactory)
{
    //ILogger logger = logFactory.CreateLogger(typeof(Log4NetLogger));
    ILogger logger = logFactory.CreateLogger<Startup>();
    logger.LogError("this is the first error");
    logger.LogInformation("this is the first info");
    logger.LogDebug("this is the first debug");
    logger.LogWarning("this is the first warning");
    logger.LogInformation(System.Diagnostics.Process.GetCurrentProcess().ProcessName);
}

　　上述是在Startup文件中調用日誌，一樣的在Controller中也能夠調用日誌進行記錄。

private readonly IStudentRepository _studentRepository;

private readonly ILogger<HomeController> _logger;

//構造函數注入
public HomeController(IStudentRepository studentRepository,ILogger<HomeController> logger)
{
    _studentRepository = studentRepository;
    _logger = logger;
}

　　若是要在Program中建立日誌，則須要從DI容器中獲取ILogger實列

public static void Main(string[] args)
{
　　var host = CreateWebHostBuilder(args).Build();

　　var logger = host.Services.GetRequiredService<ILogger<Program>>();
　　logger.LogInformation("Seeded the database.");

　　host.Run();}