如何为特定REST Client调用禁用Trace ID？

一、官方配置/轻量实现方式 #

目前OpenTelemetry主流生态（以Java为例）没有直接的类级/方法级注解可一键跳过追踪头注入，但可以通过以下方式实现需求：

1. 配置文件过滤目标请求 #

如果用Spring Boot + OpenTelemetry Starter，直接在配置文件里添加排除规则，让Instrumentation自动跳过指定URL的追踪头注入：

# 按域名/路径匹配，排除第三方请求
otel.instrumentation.restclient.exclude-urls=https://第三方域名/**,https://external-service.com/api/**

2. 方法级上下文隔离 #

针对单个调用第三方的方法，手动切换追踪上下文，让当前请求不继承父Span的追踪信息：

// 保存当前追踪上下文
Context originalContext = Context.current();
try (Scope ignored = Context.root().makeCurrent()) {
    // 此处调用第三方接口，不会携带traceparent等追踪头
    restClient.get().uri("https://第三方域名/api").retrieve().body(String.class);
} finally {
    // 恢复原有上下文
    originalContext.makeCurrent();
}

二、自定义拦截器细粒度控制 #

如果需要更灵活的判断逻辑，可给RestClient添加自定义拦截器，在请求发送前移除追踪头：

public class ThirdPartyTraceHeaderRemover implements ClientHttpRequestInterceptor {
    @Override
    public ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException {
        // 匹配第三方请求URL
        String requestUrl = request.getURI().toString();
        if (requestUrl.startsWith("https://第三方域名/")) {
            // 移除OpenTelemetry追踪头
            request.getHeaders().remove("traceparent");
            request.getHeaders().remove("tracestate");
        }
        return execution.execute(request, body);
    }
}

注册拦截器到RestClient：

RestClient thirdPartyRestClient = RestClient.builder()
        .interceptors(new ThirdPartyTraceHeaderRemover())
        .build();

三、自定义Sampler过滤采样 #

通过自定义采样器，对第三方请求直接丢弃Span，自然不会生成和注入追踪头：

Sampler thirdPartySkipSampler = new Sampler() {
    @Override
    public SamplingResult shouldSample(Context parentContext, String traceId, String name, SpanKind spanKind, Attributes attributes, List<Link> parentLinks) {
        // 从请求属性中获取URL
        String url = attributes.get(AttributeKey.stringKey("http.url"));
        if (url != null && url.startsWith("https://第三方域名/")) {
            return SamplingResult.create(SamplingDecision.DROP);
        }
        return SamplingResult.create(SamplingDecision.RECORD_AND_SAMPLE);
    }

    @Override
    public String getDescription() {
        return "Skip sampling for third-party requests";
    }
};

// 配置OpenTelemetry使用该采样器
OpenTelemetrySdk.builder()
        .setTracerProvider(TracerProviderSdk.builder()
                .setSampler(thirdPartySkipSampler)
                .build())
        .buildAndRegisterGlobal();

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