OpenTelemetry Java SDK日志导出器注入traceId与spanId问题咨询

你当前通过setAttribute设置的traceId/spanId都会作为普通日志属性存入LogAttributes，但OpenTelemetry日志规范中，TraceId和SpanId是LogRecord的核心关联字段，需要通过关联Span上下文的方式注入，才能被Collector识别并填充到Clickhouse的顶层TraceId/SpanId字段。

解决方案 #

1. 手动传入TraceId/SpanId的场景 #

如果是从外部获取traceId和spanId（而非当前线程活跃Span），需要手动构建SpanContext并关联到日志的上下文：

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.context.Context;

// 确保traceId是32位十六进制字符串，spanId是16位十六进制字符串（符合OTel规范）
SpanContext spanContext = SpanContext.create(
    otelTraceId,
    otelSpanId,
    TraceFlags.getSampled(), // 根据实际采样情况设置，非采样可传TraceFlags.getDefault()
    TraceState.getDefault()
);

// 创建包含该SpanContext的上下文
Context logContext = Context.current().with(Span.wrap(spanContext));

// 构建日志时关联上下文
Logger otelLogger = otel.getLogsBridge().get("test");
LogRecordBuilder logRecordBuilder = otelLogger.logRecordBuilder();

logRecordBuilder.setParent(logContext) // 关键：关联上下文，自动填充TraceId/SpanId
        .setTimestamp(instant)
        .setSeverity(severity)
        .setSeverityText(level)
        .setBody(message);

if (throwable != null) {
    logRecordBuilder.setAttribute("exception.message", throwable.getMessage())
            .setAttribute("exception.stacktrace", StackTraceUtil.getContentsOfStackTrace(throwable.getStackTrace()));
}

logRecordBuilder.emit();

2. 当前线程有活跃Span的场景 #

如果日志是在一个已经有OpenTelemetry Span的线程中输出，直接关联当前上下文即可：

LogRecordBuilder logRecordBuilder = otelLogger.logRecordBuilder();

logRecordBuilder.setParent(Context.current()) // 自动关联当前活跃Span的TraceId/SpanId
        .setTimestamp(instant)
        .setSeverity(severity)
        .setSeverityText(level)
        .setBody(message);

// 后续处理...
logRecordBuilder.emit();

效果说明 #

通过上述方式设置后，OpenTelemetry导出器会自动从关联的SpanContext中提取TraceId和SpanId，发送给Collector后，Clickhouse的顶层TraceId和SpanId字段会被正确填充，无需再通过setAttribute手动设置这些字段（如果业务需要在LogAttributes中保留副本，可以额外添加，但通常不需要）。

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