如何按方法名称实现Serilog子日志器的精细化日志过滤

Serilog 内置的过滤器机制完全支持多属性组合的筛选逻辑，不需要依赖自定义扩展包，即可实现“指定命名空间下特定方法日志定向投递邮件、其余日志沿用默认规则”的需求。

核心实现逻辑 #

整个方案的核心是利用子日志器的分支隔离能力，搭配自定义过滤谓词实现多条件匹配：

1. 前置准备：确保日志事件携带方法名属性
   默认情况下Serilog不会自动将当前执行方法名写入日志事件属性，可通过两种方式将方法名绑定到日志上下文：
   • 写日志时显式携带属性：

     Log.ForContext("SourceContext", "SomeNamespace")
        .ForContext("MethodName", nameof(SomeClass.method1))
        .Information("方法执行日志内容");
     

   • 编写全局增强器（Enricher）自动读取调用栈中的方法名，批量绑定属性，避免每次写日志手动传参。
2. 配置分支过滤规则
   为了避免手动处理Serilog字符串属性的转义格式，先封装一个安全的属性读取方法：

   // 从日志事件中安全读取字符串类型属性值
   static string GetStringProperty(LogEvent logEvent, string propertyName)
   {
       if (logEvent.Properties.TryGetValue(propertyName, out var propValue) 
           && propValue is ScalarValue scalarValue 
           && scalarValue.Value is string strValue)
       {
           return strValue;
       }
       return string.Empty;
   }
   

   之后在子日志器的过滤配置中，组合判断命名空间、方法名两个条件，仅匹配成功的日志才会进入邮件投递管道：

   var logger = new LoggerConfiguration()
       // 配置默认全局日志规则（控制台、文件等原有逻辑）
       .WriteTo.Console()
       // 配置邮件定向投递的子日志分支
       .WriteTo.Logger(subConfig => subConfig
           .Filter.ByIncludingOnly(logEvent => 
               // 同时满足两个条件才进入邮件渠道
               GetStringProperty(logEvent, "SourceContext") == "SomeNamespace" &&
               GetStringProperty(logEvent, "MethodName") == nameof(SomeClass.method1)
           )
           // 挂载邮件Sink，沿用原有邮件配置参数
           .WriteTo.Email(/* 原有邮件Sink配置 */)
       )
       .CreateLogger();
   

注意事项 #

• 该配置结构下，不满足过滤条件的日志（如同命名空间下的method2日志、其他命名空间的日志）不会进入邮件Sink的处理管道，只会沿用主日志器配置的默认规则，无需额外编写排除逻辑。
• 不要直接对比LogEvent.Properties中的原始字符串值，Serilog存储的字符串属性会自带转义格式，直接做等值判断大概率会匹配失败。
• Serilog 内置的Matching帮助类仅支持单属性的简单判断，无法直接实现多条件组合筛选，传入自定义谓词是官方明确支持的过滤器用法，不会引入额外的维护成本。
• 若需要进一步区分不同类的同名方法，可将类名也作为属性加入日志上下文，在过滤谓词中追加类名判断即可，逻辑与现有实现完全兼容。

内容的提问来源于stack exchange，提问作者Przemysław Lunic