深入浅出 Serilog：全面掌握 .NET 日志记录

在现代应用程序中，日志记录是至关重要的一部分，它帮助开发人员追踪和调试应用程序的问题。Serilog 是一个功能强大且灵活的 .NET 日志记录库，它不仅支持结构化日志，还能轻松集成到各种日志管理平台中。本教程将介绍如何在 .NET 应用程序中使用 Serilog 进行日志记录。

一、Serilog 概述

Serilog 是一个为 .NET 应用程序设计的第三方日志库，具有以下特点：

• 结构化日志： Serilog 可以记录结构化日志，这意味着日志数据可以以结构化的方式存储和查询，便于分析。
• 可扩展性： Serilog 提供了大量的 sinks，允许将日志输出到不同的目标，如控制台、文件、数据库、Elasticsearch 等。
• 简单易用： Serilog 的 API 设计简洁，易于集成和配置。

二、安装 Serilog

要在 .NET 应用程序中使用 Serilog，可以通过 NuGet 安装 Serilog 及其相关包。打开 NuGet 包管理器控制台并运行以下命令：

Install-Package Serilog
Install-Package Serilog.Extensions.Logging
Install-Package Serilog.Sinks.Console

上述命令将安装 Serilog 核心库、与 Microsoft.Extensions.Logging 的集成库，以及一个控制台输出的 sink。

三、配置 Serilog

在 .NET 应用程序中配置 Serilog 通常是在 Program.cs 文件中进行的。以下是一个基本配置示例：

using Serilog;

public class Program
{
    public static void Main(string[] args)
    {
        // 配置 Serilog
        Log.Logger = new LoggerConfiguration()
            .MinimumLevel.Debug() // 设置最小日志级别为 Debug
            .WriteTo.Console() // 输出日志到控制台
            .WriteTo.File("logs/log.txt", rollingInterval: RollingInterval.Day) // 日志输出到文件，按天分割
            .CreateLogger();

        try
        {
            Log.Information("应用程序启动");
            CreateHostBuilder(args).Build().Run();
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "应用程序启动失败");
            throw;
        }
        finally
        {
            Log.CloseAndFlush();
        }
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .UseSerilog() // 将 Serilog 配置为日志记录提供程序
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

在上述代码中，我们通过 LoggerConfiguration 类配置了 Serilog，将日志输出到控制台和文件，并设置了最小日志级别为 Debug。最后通过 UseSerilog() 将 Serilog 配置为应用程序的日志提供程序。

四、使用 Serilog 记录日志

一旦 Serilog 被配置好，就可以在代码的任何地方使用它来记录日志。以下是一些常见的日志记录方法：

Log.Information("这是一个信息日志");
Log.Warning("这是一个警告日志");
Log.Error("这是一个错误日志");
Log.Debug("这是一个调试日志");
Log.Fatal("这是一个致命错误日志");

这些方法分别对应不同的日志级别。Serilog 还支持记录带有结构化数据的日志：

Log.Information("用户 {UserId} 登录成功", userId);

这种结构化日志可以使日志数据更具可读性和可查询性，特别是在使用 ELK（Elasticsearch、Logstash、Kibana）等日志管理平台时，结构化数据非常有用。

五、Serilog Sinks

Serilog 的强大之处在于它支持多种 sinks，可以将日志输出到不同的目标。除了控制台和文件，Serilog 还支持以下常用的 sinks：

Serilog.Sinks.Seq： 将日志输出到 Seq 日志服务器。
Serilog.Sinks.Elasticsearch： 将日志输出到 Elasticsearch。
Serilog.Sinks.MongoDB： 将日志存储到 MongoDB。
要使用这些 sinks，只需安装相应的 NuGet 包并在 LoggerConfiguration 中进行配置。例如，将日志输出到 Elasticsearch：

Install-Package Serilog.Sinks.Elasticsearch

然后在配置中添加：

.WriteTo.Elasticsearch(new ElasticsearchSinkOptions(new Uri("http://localhost:9200"))
{
    AutoRegisterTemplate = true,
    IndexFormat = "logstash-{0:yyyy.MM.dd}"
})

六、总结

Serilog 是一个非常灵活且功能强大的日志库，适合各种规模的 .NET 应用程序使用。通过简单的配置，您可以轻松地将日志输出到控制台、文件或其他日志管理系统中。无论是开发阶段的调试，还是生产环境中的问题排查，Serilog 都是一个不可或缺的工具。