Sentry.Serilog集成Asp.Net Core未自动添加Breadcrumbs求助

1. 统一Sentry相关NuGet包版本 #

确保项目中Sentry.AspNetCore和Sentry.Serilog的版本都与Sentry服务器3.21.0完全一致，版本不兼容会直接导致功能失效或异常。可以通过NuGet包管理器查看并同步所有Sentry相关包的版本。

2. 必须添加Sentry Asp.Net Core中间件 #

仅配置Serilog的WriteTo.Sentry不足以实现自动面包屑收集，需要在Program.cs中添加Sentry中间件来初始化请求级别的作用域（Scope）——这是Serilog日志自动转为面包屑的核心前提：

var builder = WebApplication.CreateBuilder(args);

// 注册Sentry服务，统一配置基础参数
builder.WebHost.UseSentry(o =>
{
    o.Dsn = builder.Configuration["Sentry:Dsn"];
    o.Environment = builder.Configuration["AppSettings:Environment"];
    o.AttachStacktrace = bool.Parse(builder.Configuration["Sentry:AttachStackTrace"]);
});

// 配置Serilog，可移除重复的Sentry参数（从中间件配置继承）
builder.Host.UseSerilog((context, config) =>
{
    config.ReadFrom.Configuration(context.Configuration)
          .Enrich.FromLogContext()
          .Enrich.WithMachineName()
          .WriteTo.Async(a => a.Console())
          .WriteTo.Sentry(o =>
          {
              o.MinimumBreadcrumbLevel = LogEventLevel.Verbose;
              o.MinimumEventLevel = LogEventLevel.Verbose;
          });
});

var app = builder.Build();

// Sentry中间件需放在靠前位置，确保捕获全链路请求日志
app.UseSentry();

// 其他业务中间件配置...
app.Run();

3. 确认日志生成在请求Scope范围内 #

Sentry的面包屑绑定到当前请求的Scope上，只有请求上下文内生成的Serilog日志才会自动转为面包屑。启动时或后台任务中脱离请求上下文的日志，无法自动关联到Scope，也就不会生成面包屑。

4. 检查配置文件是否覆盖代码设置 #

如果同时使用appsettings.json配置Serilog，需确保配置文件中的Sentry参数与代码设置一致，避免被覆盖。例如：

"Serilog": {
  "WriteTo": [
    {
      "Name": "Sentry",
      "Args": {
        "minimumBreadcrumbLevel": "Verbose",
        "minimumEventLevel": "Verbose"
      }
    }
  ]
}

5. 验证Sentry Scope是否正常初始化 #

在请求内添加代码验证当前Scope是否存在，确认中间件生效：

using Sentry;

public IActionResult Test()
{
    var currentScope = SentrySdk.GetCurrentScope();
    if (currentScope != null)
    {
        Log.Information("Sentry Scope已初始化");
    }
    return Ok();
}

如果Scope为空，说明Sentry中间件未正确执行，需检查中间件添加顺序是否在业务中间件之前。

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