如何使用NLog为每条日志消息添加专属标签？

你希望在不同类中给每条日志自动附加专属标签，避免每次调用日志方法都手动传入tag参数，现有手动构建LogEventInfo的方式确实繁琐，这里提供几种更简便的实现思路：

1. 实现类专属的日志包装器 #

这是最直接的方案，封装一个带标签的日志类，每个业务类实例化时传入专属标签，后续调用日志方法无需再手动传递标签：

public class TaggedLogger
{
    private readonly Logger _innerLogger;
    private readonly string _classTag;

    public TaggedLogger(string tag)
    {
        _innerLogger = LogManager.GetCurrentClassLogger();
        _classTag = tag;
    }

    // 封装Debug级别日志方法
    public void Debug(string message)
    {
        var logEvent = new LogEventInfo(LogLevel.Debug, _innerLogger.Name, message);
        logEvent.Properties["Tag"] = _classTag;
        _innerLogger.Log(logEvent);
    }

    // 按需封装Info、Warn、Error等其他级别方法
    public void Info(string message)
    {
        var logEvent = new LogEventInfo(LogLevel.Info, _innerLogger.Name, message);
        logEvent.Properties["Tag"] = _classTag;
        _innerLogger.Log(logEvent);
    }
}

// 业务类中使用
class A
{
    private readonly TaggedLogger _logger = new TaggedLogger("Tag A");

    public void DoSomething()
    {
        _logger.Debug("Some message");
    }
}

2. 扩展NLog.Logger类 #

通过扩展方法简化带标签的日志调用，无需额外封装新类，只需在业务类中保留标签字段，调用扩展方法时传入：

public static class LoggerTagExtensions
{
    public static void DebugWithTag(this Logger logger, string message, string tag)
    {
        var logEvent = new LogEventInfo(LogLevel.Debug, logger.Name, message);
        logEvent.Properties["Tag"] = tag;
        logger.Log(logEvent);
    }

    // 同理扩展其他日志级别
    public static void InfoWithTag(this Logger logger, string message, string tag)
    {
        var logEvent = new LogEventInfo(LogLevel.Info, logger.Name, message);
        logEvent.Properties["Tag"] = tag;
        logger.Log(logEvent);
    }
}

// 业务类中使用
class B
{
    private readonly Logger _logger = LogManager.GetCurrentClassLogger();
    private readonly string _tag = "Tag B";

    public void DoAnotherThing()
    {
        _logger.DebugWithTag("Another message", _tag);
    }
}

3. 配置NLog输出标签 #

无论采用哪种方案，都需要在NLog配置文件中添加标签的输出规则，确保日志中能显示标签内容，例如：

<targets>
    <target name="console" xsi:type="Console">
        <layout>${longdate} [${level}] ${event-properties:item=Tag} - ${message}</layout>
    </target>
</targets>

方案对比 #

• 日志包装器：一次性封装，业务类调用最简洁，无需每次传递标签，适合需要统一标签规则的场景。
• 扩展方法：更灵活，无需修改现有Logger的使用习惯，仅需添加标签参数，适合零散添加标签的场景。

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