NLog 4.5中Callsite布局渲染如何仅捕获顶层堆栈信息？

核心结论 #

NLog 4.5 版本的 ${callsite} 布局渲染器没有原生参数可以直接禁用完整堆栈捕获，但可以通过以下两种方案实现你的需求（仅获取顶层调用的命名空间、类名和方法名）：

方案1：手动传递调用信息（性能最优） #

直接在日志调用时，通过 WithProperty 把当前方法的完整信息传递给日志事件，完全跳过堆栈捕获逻辑：

// 在业务代码中调用日志
logger.WithProperty("CustomCallsite", $"{typeof(YourClass).FullName}.{nameof(YourMethod)}")
      .Info("需要记录的日志内容");

然后在 NLog 配置的布局中，替换 ${callsite} 为自定义属性：

<target name="console" xsi:type="Console" layout="${event-properties:item=CustomCallsite} - ${message}" />

这种方式完全避免了堆栈遍历，性能开销最小，适合对性能敏感的场景。

方案2：自定义布局渲染器（自动获取顶层调用） #

如果不想在每个日志调用中手动传参，可以自定义一个布局渲染器，只遍历堆栈到第一个用户代码帧就停止，避免完整堆栈捕获：

1. 实现自定义渲染器：

[LayoutRenderer("custom-callsite")]
public class CustomCallsiteRenderer : LayoutRenderer
{
    protected override void Append(StringBuilder builder, LogEventInfo logEvent)
    {
        var stackTrace = new StackTrace();
        // 跳过NLog内部的调用帧，定位到用户代码的顶层方法
        foreach (var frame in stackTrace.GetFrames())
        {
            var method = frame.GetMethod();
            if (method == null) continue;
            
            var typeNamespace = method.DeclaringType?.Namespace;
            // 排除NLog自身的命名空间
            if (!string.IsNullOrEmpty(typeNamespace) && !typeNamespace.StartsWith("NLog"))
            {
                builder.Append($"{method.DeclaringType.FullName}.{method.Name}");
                break;
            }
        }
    }
}

2. 注册自定义渲染器：
   在应用启动时（比如 Program.cs 入口）添加注册代码：

NLog.Config.ConfigurationItemFactory.Default.LayoutRenderers
      .RegisterDefinition("custom-callsite", typeof(CustomCallsiteRenderer));

3. 在NLog配置中使用：

<target name="console" xsi:type="Console" layout="${custom-callsite} - ${message}" />

关于 capturestacktrace=false 的问题 #

这个参数是 NLog 4.7 版本才新增的配置项，4.5 版本的 ${callsite} 根本不识别该参数，设置后会导致渲染器无法正常解析，因此出现无输出的情况，属于版本不兼容问题。

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