Java应用中Azure Service Bus调用未在Application Insights显示的排查求助

核心问题分析 #

当前配置下，微服务已成功接入Application Insights，应用地图可展示服务间互连关系，但Service Bus队列未在应用地图显示关联箭头，端到端事务链也缺失队列环节，同时存在微软文档表述矛盾的情况。

针对性解决方案 #

1. 确认Agent与SDK的兼容性配置 #

• 检查applicationinsights-agent-3.3.1.jar的配置文件applicationinsights.json，确保已启用Service Bus遥测收集，需添加或验证以下配置段：

  {
    "instrumentation": {
      "azure-servicebus": {
        "enabled": true
      }
    }
  }
  

• 尽管Azure Service Bus SDK 7.1.0+宣称支持自动遥测收集，但需确认Agent版本对7.8.0的适配性。若存在适配问题，建议升级Agent至最新稳定版（如3.4.x系列），新版本通常会修复高版本SDK的兼容问题。

2. 手动注入分布式追踪上下文 #

若自动收集未生效，可在消息发送和接收环节手动传递追踪上下文：

• 发送消息时：从当前Span提取追踪信息，注入到Service Bus消息属性中：

  import io.opentelemetry.api.trace.Span;
  import com.azure.messaging.servicebus.ServiceBusMessage;
  
  Span currentSpan = Span.current();
  ServiceBusMessage message = new ServiceBusMessage("业务消息内容");
  // 注入traceparent属性，传递追踪上下文
  message.getApplicationProperties().put("traceparent", currentSpan.getSpanContext().toTraceparent());
  

• 接收消息时：从消息属性提取追踪信息，创建关联父上下文的子Span：

  import io.opentelemetry.api.trace.SpanContext;
  import io.opentelemetry.api.trace.Tracer;
  import com.azure.messaging.servicebus.ServiceBusReceivedMessage;
  
  ServiceBusReceivedMessage receivedMessage = ...;
  String traceparent = (String) receivedMessage.getApplicationProperties().get("traceparent");
  if (traceparent != null) {
    SpanContext parentContext = SpanContext.fromTraceparent(traceparent);
    Tracer tracer = ...; // 获取OpenTelemetry Tracer实例
    try (Span span = tracer.spanBuilder("ServiceBus-消息处理")
        .setParent(parentContext)
        .startSpan()) {
      // 消息处理业务逻辑
    }
  }
  

3. 文档矛盾说明 #

微软文档的表述差异源于不同场景：

• 自动收集生效场景：使用Application Insights Agent时，Agent会自动拦截Service Bus的发送/接收方法，注入追踪上下文，实现遥测关联，此场景下7.1.0+ SDK支持自动收集。
• 不支持场景：指直接使用OpenTelemetry SDK手动埋点时，Azure Service Bus SDK本身不会自动传递追踪上下文，需手动处理，这与Agent自动拦截的机制完全不同。

验证步骤 #

• 重启微服务应用，确保配置变更生效。
• 发送测试消息，在Application Insights的事务搜索中，检查是否存在包含Service Bus发送/接收环节的完整事务链。
• 等待10-15分钟（遥测数据存在延迟），查看应用地图，确认是否出现指向Service Bus队列的关联箭头。

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