如何通过OpenTelemetry SDK/API或代理配置覆盖/忽略客户端Span错误状态？

针对你遇到的外部库Elasticsearch请求Span被误标记为error的问题，有三种可行的解决方式：

1. 通过OTEL Java代理配置过滤错误状态 #

无需修改代码，直接通过代理启动参数配置规则，就能覆盖特定场景下的Span错误状态：

• 忽略指定HTTP状态码的错误：

  -Dotel.instrumentation.common.experimental.http.status-code.error.override="404=ignore"
  

  把404替换为外部库实际忽略的状态码，多个状态码用逗号分隔即可，比如404,400=ignore。
• 针对Elasticsearch请求精准配置：
  如果需要只对Elasticsearch的请求生效，可使用对应仪器库的专属前缀：

  -Dotel.instrumentation.elasticsearch.experimental.http.status-code.error.override="404=ignore"
  

2. 使用SDK自定义Span处理器 #

如果配置方式不够灵活，可通过自定义Span处理器，在Span结束前修改其错误状态：

public class ElasticsearchErrorFixSpanProcessor implements SpanProcessor {
    @Override
    public void onStart(Context parentContext, ReadWriteSpan span) {}

    @Override
    public boolean isStartRequired() { return false; }

    @Override
    public void onEnd(ReadableSpan span) {
        // 匹配Elasticsearch的client类型Span
        if ("client".equals(span.getKind()) 
            && "elasticsearch".equals(span.getAttribute("peer.service"))
            && span.getStatus().getStatusCode() == StatusCode.ERROR) {
            // 获取响应的HTTP状态码
            Integer statusCode = span.getAttribute("http.status_code");
            // 忽略目标状态码对应的错误标记
            if (statusCode != null && (statusCode == 404 || statusCode == 400)) {
                ((ReadWriteSpan) span).setStatus(StatusCode.OK);
            }
        }
    }

    @Override
    public boolean isEndRequired() { return true; }
}

初始化OpenTelemetry时注册该处理器：

OpenTelemetry openTelemetry = OpenTelemetrySdk.builder()
    .setTracerProvider(TracerProviderSdk.builder()
        .addSpanProcessor(new ElasticsearchErrorFixSpanProcessor())
        .build())
    .buildAndRegisterGlobal();

3. 通过API拦截并修改Span状态 #

如果你能找到外部库请求的切入点（比如用AOP拦截方法），可以直接通过API获取当前Span并修改状态：

// 在外部库发起请求后，获取当前链路的Span
Span currentSpan = Span.current();
// 假设已拿到响应的HTTP状态码
int responseStatusCode = ...;
// 对目标状态码清除错误标记
if (responseStatusCode == 404 || responseStatusCode == 400) {
    currentSpan.setStatus(StatusCode.OK);
}

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