.NET下OpenTelemetry跨Scope关联追踪：如何串联三服务完整链路？

核心问题是后台队列处理时，原始请求的追踪上下文已丢失，导致发起第三个服务请求时生成了新的Trace。正确的做法是在入队时保存追踪上下文，处理工作项时恢复上下文并创建关联的Span，具体步骤如下：

1. 入队时保存追踪上下文 #

在第二个服务处理HTTP请求的逻辑中，将当前请求的ActivityContext和工作项一起存储。这个上下文包含TraceId、SpanId等关键追踪信息，是链路关联的核心。

// 定义包含追踪上下文的工作项类
public class BackgroundWorkItem
{
    public string BusinessData { get; set; }
    public ActivityContext TraceContext { get; set; }
}

// 入队逻辑（在第二个服务的HTTP接口处理方法中）
public IActionResult TriggerBackgroundWork()
{
    var workItem = new BackgroundWorkItem
    {
        BusinessData = "需要处理的业务数据",
        // 获取当前请求的Activity上下文，若没有则用空上下文
        TraceContext = Activity.Current?.Context ?? ActivityContext.Empty
    };
    
    _backgroundQueue.Enqueue(workItem);
    return Ok();
}

2. 处理工作项时恢复并关联追踪上下文 #

在后台队列的处理逻辑中，基于保存的ActivityContext创建一个新的Activity（作为原始请求的子Span），并在这个Activity的Scope内发起对第三个服务的请求。HttpClient的OpenTelemetry instrumentation会自动从当前Activity生成正确的traceparent header。

// 后台队列服务的处理逻辑
public async Task ProcessQueueAsync(CancellationToken stoppingToken)
{
    while (!stoppingToken.IsCancellationRequested)
    {
        var workItem = await _backgroundQueue.DequeueAsync(stoppingToken);
        
        if (workItem.TraceContext != ActivityContext.Empty)
        {
            // 使用后台服务的ActivitySource创建关联的子Span
            using var activity = _activitySource.StartActivity(
                "ProcessBackgroundWorkItem", 
                ActivityKind.Internal, 
                workItem.TraceContext);
            
            try
            {
                // 在Activity的Scope内发起HTTP请求，自动携带正确的traceparent
                await _httpClient.GetAsync("https://third-service/api/process");
            }
            finally
            {
                activity?.Stop();
            }
        }
        else
        {
            // 无追踪上下文时的降级处理
            await _httpClient.GetAsync("https://third-service/api/process");
        }
    }
}

3. 为什么手动设置父Activity ID无效？ #

你之前的尝试失败，主要有两个原因：

• 仅设置ParentId但未同步TraceId，导致生成了新的Trace链路；
• 手动创建Activity时未正确传入父ActivityContext，OpenTelemetry无法识别父子关系，HttpClient instrumentation也无法捕获正确的上下文生成traceparent。

额外注意事项 #

• 如果使用第三方队列（如RabbitMQ、Azure Service Bus），优先使用官方的OpenTelemetry Instrumentation包（如OpenTelemetry.Instrumentation.AzureServiceBus），它们会自动处理追踪上下文的注入与恢复，无需手动编码；
• 确保所有服务的OpenTelemetry配置启用了W3C Trace Context格式（默认已启用），并正确注册了HttpClient的Instrumentation；
• 后台服务需要初始化自己的ActivitySource，并在OpenTelemetry TraceProvider中注册：

  var activitySource = new ActivitySource("Your.Background.Service");
  
  // 在OpenTelemetry配置中添加
  builder.Services.AddOpenTelemetry()
      .WithTracing(tracing => tracing
          .AddSource("Your.Background.Service")
          .AddHttpClientInstrumentation()
          .AddJaegerExporter());
  

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