使用OTEL Java agent，如何在不使用@WithSpan的情况下创建新上下文

Question

opentelemetry javaagent all（版本0.17.0和1.0.1）是向Java应用程序添加跟踪信息的起点。自动仪表工作得很好。

我的一些应用程序无法自动检测。对于应用程序的这一部分，我首先使用span向代码中的有趣点添加注释。

现在，我已经达到了使用span注释进行简单注释的极限。然而，我的应用程序的底层框架允许我注册在特定点调用的回调，例如，我可以提供在客户端连接/断开连接时通知的处理程序。

我想我需要的是在Foo时开始一个新的跨度。调用onConnect（），并将其设置为对应于每个请求的Span的父级。

public class Foo {

    void onConnect() {
        // called when a client connects to my app
        // Here I want to create a Span that will be the parent of the Span created in
        // Foo.processEachRequest().
    }

    @WithSpan
    public void processEachRequest() {
        // works, but since it is called for each request... each span is in a separate Trace
    }

    void onDisconnect() {
        // called when the client disconnects from my app
        // Here I can end the parent Span.
    }
}

其他想法——没有成功：

1-显而易见的解决方案是将@SusSpan注释添加到底层框架中。出于各种原因，这不会是一种切实可行的前进方式。

2-下一个选择可能是搜索一种方法来告诉javaagent我的底层框架中的方法。（New Relic代理可以做这样的事情。）无论如何，这似乎不是开放遥测代理的功能。

所以，我剩下的就是寻找一种使用回调实现这一点的方法，如上所述。有没有办法做到这一点？

Answer 1

这应该可以通过手动检测您的代码来实现。您将使用OpenTelem计的Tracer接口，如OpenTelem计Java文档中所述。

这应该给你一个大致的想法：

public class Foo {
    private Span parentSpan; // you might need a Map/List/Stack here

    void onConnect() {
        Tracer tracer =
                openTelemetry.getTracer("instrumentation-library-name", "1.0.0");
        Span span = tracer.spanBuilder("my span").startSpan();
        this.parentSpan = span; // might need to store span per request/client/connection-id
    }

    public void processEachRequest() {
        final Span parent = this.lookupParentSpan();
        if (parent != null) {
            try (Scope scope = span.makeCurrent()) {
              yourLogic();
            } catch (Throwable t) {
              span.setStatus(StatusCode.ERROR, "error message");
              throw t;
            }
        } else {
            yourLogic();
        }
    }

    void onDisconnect() {
        final Span parent = this.lookupParentSpan();
        if (parent != null) {
            parent.end();
        }
    }

    private Span lookupParentSpan() {
        // you probably want to lookup the span by client or connection id from a (weak) map
        return this.parentSpan;
    }
}

注意：您必须保证跨度始终处于末端且不会泄漏。确保正确地确定范围并最终调用Span#end（）。