本文是Util應用框架日志記錄的第二篇,介紹寫入日志文件的配置方法.

概述

將日志寫入文本文件,不方便查看和管理,但在開發階段可以作為臨時查看日志的手段.

日志配置

• 引用Nuget包

  Nuget包名: Util.Logging.Serilog

• AddSerilog

  使用 AddSerilog 擴展方法啟用 Serilog 日志操作.

  • 默認配置不帶參數.

    var builder = WebApplication.CreateBuilder( args );
    builder.AsBuild().AddSerilog();
    

  • 如果要清除默認設置的日志提供程序,傳入 true.

    Asp.Net Core 默認日志提供程序會把消息輸出到控制臺,你可以清除它們.

    builder.AsBuild().AddSerilog( true );
    

  • 設置應用程序名稱.

    對于微服務應用,記錄產生日志的應用名稱,能方便排查問題.

    builder.AsBuild().AddSerilog( "權限服務" );
    

  • 你也可以使用委托設置參數.

    • 清除默認設置的日志提供程序

    builder.AsBuild().AddSerilog( t => t.IsClearProviders = true );
    

• 添加 appsettings 配置節

  在 appsettings.json 配置文件添加 Serilog 配置節.

  {
    "Logging": {
      "LogLevel": {
        "Default": "Trace"
      }
    },
    "Serilog": {
      "WriteTo": [
        {
          "Name": "File",
          "Args": {
            "path": "c:\\log\\log.txt",
            "outputTemplate": "{LogLevel}: {TraceId}  >>  [{SourceContext}] [{Timestamp:yyyy-MM-dd HH:mm:ss.fff}] {Duration}{NewLine}{Message}{NewLine}{Exception}{NewLine}"
          }
        }
      ]
    }
  }
  

  WriteTo 指定日志接收器為 File.

  path 指定了日志文件的路徑,這里輸出到 c:\log\log.txt.

  outputTemplate 指定輸出消息的格式:

  • {LogLevel} 顯示日志級別.
  • {TraceId} 顯示跟蹤號.
  • {SourceContext} 顯示日志類別.
  • {Timestamp:yyyy-MM-dd HH:mm:ss.fff} 顯示時間并指定時間格式.
  • {Duration} 顯示請求的執行時間.
  • {Message} 顯示日志消息正文.
  • {Exception} 顯示異常消息.

  還有很多其它配置項,可以參考 Serilog 文檔.

查看日志文件

配置完成后,可以啟動你的項目,查看日志文件 c:\log\log.txt.

可以看到由 Asp.Net Core 寫入的系統日志.