Serilog MinimumLevel Override在.NET 6 Web API中配置不生效问题

问题场景 #

• 在appsettings.json中配置以下内容时，System.Net.Http.HttpClient.SomeClassLibraryName命名空间仅记录Error级别的日志，配置正常生效：

  {
    "Logging": {
      "LogLevel": {
        "Default": "Warning",
        "System.Net.Http.HttpClient.SomeClassLibraryName": "Error"
      }
    }
  }
  

• 但在.NET 6 Web API中使用Serilog代码方式配置日志时，相同的命名空间配置无法生效：

  public static void LoggingConfiguration(){
      Log.Logger = new LoggerConfiguration()
          .MinimumLevel.Information()
          .MinimumLevel.Override("System.Net.Http.HttpClient.SomeClassLibraryName", LogEventLevel.Error)
          .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
          .MinimumLevel.Override(SomeClassLibraryName, LogEventLevel.Information)
          .Enrich.FromLogContext()
          .WriteTo.Async(c => c.File("Logs/Log.txt", rollingInterval: RollingInterval.Day))
          .WriteTo.Async(c => c.Console())
          .CreateLogger();
  }
  

• 测试发现针对Microsoft命名空间的级别配置可正常生效，但上述特定HttpClient命名空间的配置无效，已查阅相关资料未找到解决方案。

问题原因与解决方法 #

核心原因 #

Serilog的MinimumLevel.Override匹配的是日志的SourceContext字段，而HttpClient生成的日志，其SourceContext实际格式为System.Net.Http.HttpClient.{ClientName}.LogicalHandler或System.Net.Http.HttpClient.{ClientName}.ClientHandler，并非直接的System.Net.Http.HttpClient.SomeClassLibraryName。

解决办法 #

1. 使用通配符匹配
   修改Serilog配置中的Override规则，添加通配符匹配所有该客户端下的Handler日志：

   .MinimumLevel.Override("System.Net.Http.HttpClient.SomeClassLibraryName*", LogEventLevel.Error)
   

   也可以精确匹配两个Handler：

   .MinimumLevel.Override("System.Net.Http.HttpClient.SomeClassLibraryName.LogicalHandler", LogEventLevel.Error)
   .MinimumLevel.Override("System.Net.Http.HttpClient.SomeClassLibraryName.ClientHandler", LogEventLevel.Error)
   

2. 确认HttpClient的命名正确性
   确保创建HttpClient时指定的名称与配置中的SomeClassLibraryName一致：

   // 直接创建HttpClient时指定名称
   var client = new HttpClient { Name = "SomeClassLibraryName" };
   // 或使用IHttpClientFactory注册命名客户端
   services.AddHttpClient("SomeClassLibraryName");
   

3. 验证实际SourceContext值
   临时修改日志输出模板，打印出所有日志的SourceContext，确认具体的匹配字符串：

   .WriteTo.Console(outputTemplate: "{Timestamp:HH:mm:ss} [{Level:u3}] ({SourceContext}) {Message:lj}{NewLine}{Exception}")
   

   根据实际输出的SourceContext调整Override规则即可。

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