Serilog

一、简介

       Serilog，Microsoft .NET 的结构化日志记录库，Checkout.com .NET 首选日志记录库。支持各种日志记录目的地（接收器）包从标准控制台和基于文件的接收器到日志服务，如Datadog。

二、包

       常用的Nuget安装包如下：

1. Serilog ：主包
2. Serilog.AspNetCore ： Core环境下使用包   
3. Serilog.Formatting.Compact ：用于日志输出到控制台
4. Serilog.Sinks.MySQL ：用于日志输出到Mysql数据库
5. Serilog.Sinks.MSSqlServer ：用于日志输出到SqlSer数据库
6. Serilog.Sinks.RollingFile：用于日志输出到文件  
7. Serilog.Sinks.Async ：异步

三、使用

        示例环境：.NET 6 ，MySql

        3.1、Program.cs配置                

//Serilog 配置
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Override("Microsoft", LogEventLevel.Warning) // 排除Microsoft的日志
    .Enrich.FromLogContext() // 注册日志上下文
    .WriteTo.Console(new CompactJsonFormatter()) // 输出到控制台
    .WriteTo.MySQL(connectionString: builder.Configuration.GetConnectionString("DbConnectionString"), tableName: "Logs") // 输出到数据库
    .WriteTo.Logger(configure => configure // 输出到文件
                .MinimumLevel.Debug()
                .WriteTo.File(  //单个日志文件，总日志，所有日志存到这里面
                    $"logs\\log.txt",
                    rollingInterval: RollingInterval.Day,
                    outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}")
                .WriteTo.RollingFile( //每天生成一个新的日志，按天来存日志
                    "logs\\{Date}-log.txt", //定输出到滚动日志文件中，每天会创建一个新的日志，按天来存日志
                    retainedFileCountLimit: 7,
                    outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}"
                ))
    .CreateLogger();

//向主机注册Serilog
builder.Host.UseSerilog();

       3.2、控制器使用

[ApiController]
[Route("[controller]")]
public class TestController : ControllerBase
{
    #region DI

    private readonly ILogger<TestController> _logger;

    public TestController(ILogger<TestController> logger)
    {
        _logger = logger;
    }

    #endregion

    #region Func

    [HttpGet]
    public object Get()
    {
        // 记录日志
        _logger.LogInformation($"测试测试");
        _logger.LogDebug("测试Debug信息");
        _logger.LogError("测试Error信息");
        _logger.LogWarning("测试Warning信息");
        _logger.LogCritical("测试Critical信息");
        return "";
    } 

    #endregion
}

      3.3、appsettings.json配置，如果使用数据库记录日志的话。

"ConnectionStrings": {
  "DbConnectionString": "Data Source=48.114.198.199;Database=efcore;AllowLoadLocalInfile=true;User ID=root;Password=root;allowPublicKeyRetrieval=true;pooling=true;CharSet=utf8;port=3306;sslmode=none;"
}

     3.4、数据库结果

            logs表会自动创建

   3.5、文件结果    

             logs文件夹下会有两个日志文件，一个是总日志文件，一个是按天创建记录的滚动日志文件