OpenTelemetry Java中如何通过Span ID获取Span以设置父Span

OpenTelemetry Java SDK没有提供直接通过Span ID获取Span实例的API。因为Span对象由SDK内部管理，分布式追踪的设计逻辑里，通常是通过Context传递父Span关联，而非通过Span ID反向查找。

如果只能拿到父Span的Span ID，你需要同时获取父Span的Trace ID，才能构建父Span的上下文来关联子Span，具体实现如下：

代码示例 #

import io.opentelemetry.api.trace.Span;
import io.opentelemetry.api.trace.SpanContext;
import io.opentelemetry.api.trace.TraceFlags;
import io.opentelemetry.api.trace.TraceState;
import io.opentelemetry.sdk.trace.DefaultSpan;
import io.opentelemetry.context.Context;

// 替换为实际获取到的父Trace ID和Span ID
String parentTraceId = "your-parent-trace-id";
String parentSpanId = "your-parent-span-id";

// 构建父Span的SpanContext
SpanContext parentSpanContext = SpanContext.create(
    parentTraceId,
    parentSpanId,
    TraceFlags.getSampled(), // 根据实际采样情况设置，未采样用TraceFlags.getDefault()
    TraceState.getDefault()
);

// 创建用于上下文关联的DefaultSpan（仅用于传递父关系，并非实际运行的Span）
Span parentSpan = DefaultSpan.create(parentSpanContext);

// 构建子Span并设置父关系
Span childSpan = tracer.spanBuilder("child-span-name")
    .setParent(Context.current().with(parentSpan))
    .startSpan();

注意事项 #

• 仅Span ID无法唯一标识一个Span，必须搭配对应的Trace ID使用
• DefaultSpan是SDK内部类，仅用于上下文传递，不要调用它的end()等生命周期方法
• 如果父Span和子Span在同一进程内，优先直接传递Context或Span实例，比传递ID更可靠

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