.NET 8中Serilog ReadFrom配置失效问题排查

问题场景 #

在.NET 8项目中，Serilog日志配置有两种实现方式：

1. 硬编码可正常运行版本

private static void SetLogging(WebApplicationBuilder builder)
{
    Log.Logger = new LoggerConfiguration()
        .Enrich.FromLogContext()
        .MinimumLevel.Override("Microsoft.EntityFrameworkCore.Migrations", LogEventLevel.Warning)
        .MinimumLevel.Override("Microsoft.EntityFrameworkCore.Database.Command", LogEventLevel.Warning)
        .WriteTo.Console()
        .WriteTo.LokiHttp(() => new LokiSinkConfiguration
        {
            LokiUrl = "http://localhost:3100",
            LogLabelProvider = new DefaultLogLabelProvider(
                new List<LokiLabel>
                {
                    new ("assemblyName", "WebApi")
                }),
            OutputTemplate = "[{Level:u3}] {Message:lj}{NewLine}{Exception}"
        })
        .CreateLogger();
}

该版本可正常将日志输出至控制台和Grafana Loki。

2. appsettings.json配置无法运行版本
   配置代码：

private static void SetLogging(WebApplicationBuilder builder)
{
    var logger = new LoggerConfiguration()
        .ReadFrom.Configuration(builder.Configuration)
        .Enrich.FromLogContext()
        .CreateLogger();

    builder.Logging.ClearProviders();
    builder.Logging.AddSerilog(logger);
}

对应的appsettings.json配置：

{
    "Serilog": {
      "Using": ["Serilog.Sinks.Console", "Serilog.Sinks.Loki"],
      "MinimumLevel": {
        "Default": "Information",
        "Override": {
          "Microsoft.EntityFrameworkCore.Migrations": "Warning",
          "Microsoft.EntityFrameworkCore.Database.Command": "Warning"
        }
      },
      "WriteTo": [
        {
          "Name": "Console"
        },
        {
          "Name": "LokiHttp",
          "Args": {
            "serverUrl": "http://localhost:3100",
            "labels": [
              {
                "key": "Identity",
                "value": "WebApi"
              }
            ],
            "outputTemplate": "[{Level:u3}] {Message:lj}{NewLine}{Exception}",
            "restrictedToMinimumLevel": "Information"
          }
        }
      ],
      "Enrich": ["FromLogContext"]
    }
}

该版本无法将日志输出至控制台和Grafana Loki。

项目使用的NuGet包：

<ItemGroup>
  <PackageReference Include="Serilog" Version="4.3.0" />
  <PackageReference Include="Serilog.Extensions.Logging" Version="8.0.0" />
  <PackageReference Include="Serilog.Settings.Configuration" Version="8.0.4" />
  <PackageReference Include="Serilog.Sinks.Async" Version="2.1.0" />
  <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
  <PackageReference Include="Serilog.Sinks.Loki" Version="4.0.0-beta3" />
</ItemGroup>

问题原因 #

1. Loki Sink配置参数不匹配 #

你使用的Serilog.Sinks.Loki 4.0.0-beta3是测试版本，配置参数和旧版本有重大变更：

• 硬编码中使用的是LokiUrl属性，但配置文件里写的是旧参数名serverUrl，Serilog配置绑定无法识别该参数，导致Loki连接失败。
• 标签配置方式变更：beta3版本不再支持直接通过labels数组配置标签，而是需要通过logLabelProvider指定标签提供器的类型和参数。

2. 静态日志实例未初始化 #

第二种配置方式中，仅创建了Logger实例并添加到DI容器，但未设置Serilog的静态Log.Logger实例。部分框架组件或第三方库依赖这个静态实例输出日志，导致日志无法正常触发。

修复方案 #

步骤1：修正appsettings.json中的Loki配置 #

将LokiHttp的参数调整为beta3版本支持的格式：

{
    "Serilog": {
      "Using": ["Serilog.Sinks.Console", "Serilog.Sinks.Loki"],
      "MinimumLevel": {
        "Default": "Information",
        "Override": {
          "Microsoft.EntityFrameworkCore.Migrations": "Warning",
          "Microsoft.EntityFrameworkCore.Database.Command": "Warning"
        }
      },
      "WriteTo": [
        {
          "Name": "Console"
        },
        {
          "Name": "LokiHttp",
          "Args": {
            "lokiUrl": "http://localhost:3100",
            "logLabelProvider": {
              "type": "Serilog.Sinks.Loki.Labels.DefaultLogLabelProvider, Serilog.Sinks.Loki",
              "arguments": {
                "labels": [
                  { "key": "assemblyName", "value": "WebApi" }
                ]
              }
            },
            "outputTemplate": "[{Level:u3}] {Message:lj}{NewLine}{Exception}"
          }
        }
      ],
      "Enrich": ["FromLogContext"]
    }
}

关键修改点：

• 将serverUrl改为lokiUrl，匹配LokiSinkConfiguration类的属性名
• 用logLabelProvider配置块替代原有的labels数组，指定标签提供器的类型和参数

步骤2：初始化静态Log.Logger实例 #

修改配置代码，设置静态日志实例：

private static void SetLogging(WebApplicationBuilder builder)
{
    Log.Logger = new LoggerConfiguration()
        .ReadFrom.Configuration(builder.Configuration)
        .Enrich.FromLogContext()
        .CreateLogger();

    builder.Logging.ClearProviders();
    builder.Logging.AddSerilog(Log.Logger);
}

步骤3：验证控制台输出 #

如果控制台仍无日志，可检查：

• 确保MinimumLevel.Default设置的级别低于或等于你输出的日志级别（比如输出Information日志，配置不能设为Warning）
• 移除restrictedToMinimumLevel配置（如果不需要），避免限制日志输出

内容的提问来源于stack exchange，提问作者SydneyShoo