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();
}