Add mongo commands to otel span attributes

See quarkusio#28473

extensions/mongodb-client/deployment/src/main/java/io/quarkus/mongodb/deployment/MongoClientBuildTimeConfig.java

@@ -24,6 +24,12 @@ public class MongoClientBuildTimeConfig {
     @ConfigItem(name = "force-default-clients")
     public boolean forceDefaultClients;
 
+    /**
+     * Whether or not tracing spans of driver commands are sent in case the quarkus-opentelemetry extension is present.
+     */
+    @ConfigItem(name = "tracing.enabled")
+    public boolean tracingEnabled;
+
     /**
      * Configuration for DevServices. DevServices allows Quarkus to automatically start MongoDB in dev and test mode.
      */

extensions/mongodb-client/deployment/src/main/java/io/quarkus/mongodb/deployment/MongoClientProcessor.java

@@ -13,6 +13,7 @@
 import java.util.Set;
 import java.util.function.Supplier;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 import jakarta.enterprise.context.ApplicationScoped;
 import jakarta.enterprise.inject.Default;
@@ -85,6 +86,8 @@ public class MongoClientProcessor {
 
     private static final DotName MONGO_CLIENT_CUSTOMIZER = DotName.createSimple(MongoClientCustomizer.class.getName());
 
+    private static final String MONGODB_TRACING_COMMANDLISTENER_CLASSNAME = "io.quarkus.mongodb.tracing.MongoTracingCommandListener";
+
     private static final String SERVICE_BINDING_INTERFACE_NAME = "io.quarkus.kubernetes.service.binding.runtime.ServiceBindingConverter";
 
     @BuildStep
@@ -147,10 +150,14 @@ CommandListenerBuildItem collectCommandListeners(CombinedIndexBuildItem indexBui
             MongoClientBuildTimeConfig buildTimeConfig, Capabilities capabilities) {
         Collection<ClassInfo> commandListenerClasses = indexBuildItem.getIndex()
                 .getAllKnownImplementors(DotName.createSimple(CommandListener.class.getName()));
-        List<String> names = commandListenerClasses.stream()
-                .map(ci -> ci.name().toString())
-                .collect(Collectors.toList());
-        return new CommandListenerBuildItem(names);
+        Stream<String> names = commandListenerClasses.stream()
+                .map(ci -> ci.name().toString());
+        Stream<String> tracing = Stream.empty();
+        if (buildTimeConfig.tracingEnabled && capabilities.isPresent(Capability.OPENTELEMETRY_TRACER)) {
+            tracing = Stream.of(MONGODB_TRACING_COMMANDLISTENER_CLASSNAME);
+        }
+        var items = Stream.concat(names, tracing).toList();
+        return new CommandListenerBuildItem(items);
     }
 
     @BuildStep

extensions/mongodb-client/runtime/pom.xml

@@ -36,6 +36,11 @@
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-mutiny-reactive-streams-operators</artifactId>
         </dependency>
+        <dependency>
+            <groupId>io.quarkus</groupId>
+            <artifactId>quarkus-opentelemetry</artifactId>
+            <optional>true</optional>
+        </dependency>
         <dependency>
             <groupId>org.mongodb</groupId>
             <artifactId>mongodb-driver-sync</artifactId>

extensions/mongodb-client/runtime/src/main/java/io/quarkus/mongodb/tracing/MongoTracingCommandListener.java

@@ -0,0 +1,95 @@
+package io.quarkus.mongodb.tracing;
+
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+import javax.annotation.Nullable;
+
+import org.jboss.logging.Logger;
+
+import com.mongodb.event.*;
+
+import io.opentelemetry.api.OpenTelemetry;
+import io.opentelemetry.api.common.AttributesBuilder;
+import io.opentelemetry.context.Context;
+import io.opentelemetry.instrumentation.api.instrumenter.AttributesExtractor;
+import io.opentelemetry.instrumentation.api.instrumenter.Instrumenter;
+import io.opentelemetry.instrumentation.api.instrumenter.SpanKindExtractor;
+import io.opentelemetry.instrumentation.api.instrumenter.SpanNameExtractor;
+import io.quarkus.arc.Arc;
+
+public class MongoTracingCommandListener implements CommandListener {
+    private static final org.jboss.logging.Logger LOGGER = Logger.getLogger(MongoTracingCommandListener.class);
+    private static final String KEY = "mongodb.command";
+    private final Map<Integer, ContextEvent> requestMap;
+    private final Instrumenter<CommandStartedEvent, Void> instrumenter;
+
+    private record ContextEvent(Context context, CommandStartedEvent commandEvent) {
+    }
+
+    public MongoTracingCommandListener() {
+        var openTelemetry = getOpenTelemetry();
+        requestMap = new ConcurrentHashMap<>();
+        SpanNameExtractor<CommandStartedEvent> spanNameExtractor = CommandEvent::getCommandName;
+        instrumenter = Instrumenter.<CommandStartedEvent, Void> builder(
+                openTelemetry, "quarkus-mongodb-client", spanNameExtractor)
+                .addAttributesExtractor(new CommandEventAttrExtractor())
+                .buildInstrumenter(SpanKindExtractor.alwaysClient());
+        LOGGER.debugf("MongoTracingCommandListener created");
+    }
+
+    OpenTelemetry getOpenTelemetry() {
+        return Arc.container().instance(OpenTelemetry.class).get();
+    }
+
+    @Override
+    public void commandStarted(CommandStartedEvent event) {
+        LOGGER.tracef("commandStarted event %s", event.getCommandName());
+
+        Context parentContext = Context.current();
+        if (instrumenter.shouldStart(parentContext, event)) {
+            Context context = instrumenter.start(parentContext, event);
+            requestMap.put(event.getRequestId(), new ContextEvent(context, event));
+        }
+    }
+
+    @Override
+    public void commandSucceeded(CommandSucceededEvent event) {
+        LOGGER.tracef("commandSucceeded event %s", event.getCommandName());
+        ContextEvent contextEvent = requestMap.remove(event.getRequestId());
+        if (contextEvent != null) {
+            instrumenter.end(contextEvent.context(), contextEvent.commandEvent(), null, null);
+        }
+    }
+
+    @Override
+    public void commandFailed(CommandFailedEvent event) {
+        LOGGER.tracef("commandFailed event %s", event.getCommandName());
+        ContextEvent contextEvent = requestMap.remove(event.getRequestId());
+        if (contextEvent != null) {
+            instrumenter.end(
+                    contextEvent.context(),
+                    contextEvent.commandEvent(),
+                    null,
+                    event.getThrowable());
+        }
+    }
+
+    private static class CommandEventAttrExtractor implements AttributesExtractor<CommandStartedEvent, Void> {
+        @Override
+        public void onStart(AttributesBuilder attributesBuilder,
+                Context context,
+                CommandStartedEvent commandStartedEvent) {
+            attributesBuilder.put(KEY, commandStartedEvent.getCommand().toJson());
+        }
+
+        @Override
+        public void onEnd(AttributesBuilder attributesBuilder,
+                Context context,
+                CommandStartedEvent commandStartedEvent,
+                @Nullable Void unused,
+                @Nullable Throwable throwable) {
+
+        }
+    }
+}

extensions/mongodb-client/runtime/src/test/java/io/quarkus/mongodb/tracing/MongoTracingCommandListenerTest.java

@@ -0,0 +1,105 @@
+package io.quarkus.mongodb.tracing;
+
+import static org.assertj.core.api.Assertions.assertThatNoException;
+
+import org.bson.BsonDocument;
+import org.junit.jupiter.api.Test;
+
+import com.mongodb.event.CommandFailedEvent;
+import com.mongodb.event.CommandStartedEvent;
+import com.mongodb.event.CommandSucceededEvent;
+
+import io.opentelemetry.api.OpenTelemetry;
+
+class MongoTracingCommandListenerTest {
+
+    @Test
+    void commandStarted() {
+        var listener = getListener();
+        var command = new BsonDocument();
+        var startEvent = new CommandStartedEvent(
+                null,
+                1L,
+                10,
+                null,
+                "db",
+                "find",
+                command);
+        assertThatNoException().isThrownBy(() -> listener.commandStarted(startEvent));
+
+        CommandSucceededEvent successEvent = new CommandSucceededEvent(null,
+                startEvent.getOperationId(),
+                startEvent.getRequestId(),
+                null,
+                startEvent.getDatabaseName(),
+                startEvent.getCommandName(),
+                startEvent.getCommand(),
+                10l);
+        assertThatNoException().isThrownBy(() -> listener.commandSucceeded(successEvent));
+    }
+
+    @Test
+    void commandSucceeded() {
+        var listener = getListener();
+        var command = new BsonDocument();
+        CommandSucceededEvent cmd = new CommandSucceededEvent(null,
+                1L,
+                10,
+                null,
+                "db",
+                "find",
+                command,
+                10l);
+        assertThatNoException().isThrownBy(() -> listener.commandSucceeded(cmd));
+    }
+
+    @Test
+    void commandFailed() {
+        var listener = getListener();
+        var command = new BsonDocument();
+        var startedEvent = new CommandStartedEvent(
+                null,
+                1L,
+                10,
+                null,
+                "db",
+                "find",
+                command);
+        assertThatNoException().isThrownBy(() -> listener.commandStarted(startedEvent));
+
+        CommandFailedEvent failedEvent = new CommandFailedEvent(null,
+                1L,
+                10,
+                null,
+                "db",
+                "find",
+                10L,
+                new IllegalStateException("command failed"));
+        assertThatNoException().isThrownBy(() -> listener.commandFailed(failedEvent));
+    }
+
+    @Test
+    void commandFailedNoEvent() {
+        var listener = getListener();
+        CommandFailedEvent cmd = new CommandFailedEvent(null,
+                1L,
+                10,
+                null,
+                "db",
+                "find",
+                10L,
+                new IllegalStateException("command failed"));
+        assertThatNoException().isThrownBy(() -> listener.commandFailed(cmd));
+    }
+
+    private static MongoTracingCommandListener getListener() {
+        return new TestMongoTracingCommandListener();
+    }
+
+    private static class TestMongoTracingCommandListener extends MongoTracingCommandListener {
+        @Override
+        OpenTelemetry getOpenTelemetry() {
+            return OpenTelemetry.noop();
+        }
+    }
+}