在.NET C#中为Serilog Sentry添加全局面包屑的方法咨询

针对你的问题，有几种可靠的方式实现全局面包屑，让所有类的日志都能携带：

1. 用Serilog自定义Enricher全局注入 #

Serilog的Enrich机制可以给所有日志事件统一添加上下文信息，包括Sentry面包屑。你可以自定义一个Enricher，在其中添加固定的全局面包屑：

public class GlobalSentryBreadcrumbEnricher : ILogEventEnricher
{
    public void Enrich(LogEvent logEvent, ILogEventPropertyFactory propertyFactory)
    {
        // 直接通过SentrySdk添加面包屑
        SentrySdk.AddBreadcrumb("Excel插件全局操作", "plugin_init");
        
        // 也可通过Serilog属性传递，让Sentry集成自动识别
        logEvent.AddPropertyIfAbsent(propertyFactory.CreateProperty("SentryBreadcrumb", "Excel插件全局操作"));
    }
}

然后在Serilog初始化时注册这个Enricher：

Log.Logger = new LoggerConfiguration()
    .Enrich.With<GlobalSentryBreadcrumbEnricher>()
    .WriteTo.Sentry(o =>
    {
        o.Dsn = "你的Sentry DSN";
        // 其他Sentry配置项
    })
    .CreateLogger();

这样所有通过Serilog输出的日志（包括静态类中的Log.Error）都会触发这个Enricher，自动添加全局面包屑。

2. 在Sentry初始化时配置全局Scope #

Sentry的Scope是上下文共享的核心，你可以在插件启动的全局入口（比如Excel-DNA的AutoOpen方法）中配置全局Scope，添加固定面包屑：

public class AddIn : IExcelAddIn
{
    public void AutoOpen()
    {
        // 初始化Sentry
        SentrySdk.Init(options =>
        {
            options.Dsn = "你的Sentry DSN";
            // 其他Sentry配置
        });

        // 配置全局Scope，添加全局面包屑
        SentrySdk.ConfigureScope(scope =>
        {
            scope.AddBreadcrumb("Excel插件已启动", "plugin_lifecycle");
            scope.AddBreadcrumb("运行环境：Excel " + ExcelDnaUtil.ExcelVersion, "env_info");
        });
    }

    public void AutoClose()
    {
        Log.CloseAndFlush();
        SentrySdk.Close();
    }
}

全局Scope中的面包屑会被所有后续的日志事件继承，不管是窗体类还是静态类的日志，都会自动携带这些面包屑。

3. 利用Sentry的BeforeSend事件统一添加 #

如果需要更灵活的控制（比如根据日志内容动态添加面包屑），可以在Sentry初始化时配置BeforeSend事件，在事件中统一给所有上报的事件添加面包屑：

SentrySdk.Init(options =>
{
    options.Dsn = "你的Sentry DSN";
    options.BeforeSend = sentryEvent =>
    {
        // 添加全局面包屑
        sentryEvent.Breadcrumbs.Add(new Breadcrumb(
            message: "全局操作轨迹",
            category: "global",
            level: BreadcrumbLevel.Info));
        return sentryEvent;
    };
});

这种方式会在每个事件上报前触发，确保所有日志都带上指定的面包屑。

为什么之前窗体中的面包屑仅局部生效？ #

你在窗体初始化时调用SentrySdk.AddBreadcrumb，只会将面包屑添加到当前线程的局部Scope中。而静态类的日志可能在其他线程（比如Excel的后台计算线程）执行，这些线程的Scope没有继承窗体的上下文，所以无法获取到面包屑。上面的三种方法都是基于全局Scope或全局日志拦截，能覆盖所有线程和类的日志场景。

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