From 60828636457d90b98484cced7e0b2439db435050 Mon Sep 17 00:00:00 2001
From: Andrea Marziali <andrea.marziali@datadoghq.com>
Date: Tue, 12 Nov 2024 15:46:47 +0100
Subject: [PATCH] Add reactor samples and doc (#7906)

* Add reactor samples and doc

* Apply suggestions from code review

Co-authored-by: Bruce Bujon <PerfectSlayer@users.noreply.github.com>

* review

---------

Co-authored-by: Bruce Bujon <PerfectSlayer@users.noreply.github.com>
---
 docs/reactor/README.md                        | 116 +++++++++++++++++
 docs/reactor/img.png                          | Bin 0 -> 7849 bytes
 docs/reactor/img_1.png                        | Bin 0 -> 12099 bytes
 docs/reactor/img_2.png                        | Bin 0 -> 13138 bytes
 docs/reactor/pom.xml                          |  83 ++++++++++++
 .../src/test/java/test/ReactorTest.java       | 120 ++++++++++++++++++
 6 files changed, 319 insertions(+)
 create mode 100644 docs/reactor/README.md
 create mode 100644 docs/reactor/img.png
 create mode 100644 docs/reactor/img_1.png
 create mode 100644 docs/reactor/img_2.png
 create mode 100644 docs/reactor/pom.xml
 create mode 100644 docs/reactor/src/test/java/test/ReactorTest.java

diff --git a/docs/reactor/README.md b/docs/reactor/README.md
new file mode 100644
index 00000000000..a55973ae6ca
--- /dev/null
+++ b/docs/reactor/README.md
@@ -0,0 +1,116 @@
+# Reactor with dd-trace-java
+
+This project shows basic examples of manual tracing with reactor and the datadog java tracer.
+The examples are provided in the form of JUnit tests. Manual tracing is achieved using the OpenTelemetry APIs.
+
+## Get started
+
+The project is configured to run with a JDK 17 and Apache Maven.
+To get started on a command line, just type `mvn test`. It will generate and log traces in a json format on the
+console.
+
+## How the context is propagated
+
+The Reactor context propagates bottom up from the first subscriber (last publisher) to the last subscriber (first publisher).
+The datadog tracer captures the active span when the subscription happens (i.e. methods like `subcribe` or `block` are called)
+and activates them when a publisher emits if there is no an already active span.
+
+This works out of the box for bottom-up propagation. For the opposite, top-down, the reactor context has to be used in order 
+to let know the publisher which span needs to be activated when emitting downstream. The span has to be 
+added to the context using the key `dd.span`.
+
+## Use cases
+
+The use cases are reflecting the tests in this project
+
+### Standard bottom-up context propagation
+
+The sample leverages the `@Trace` annotation to create a span when a method returning a `Mono` or `Flux` is called.
+The annotation is available as part of the `dd-trace-api` library. Alternatively, the OpenTelemetry equivalent `@WithSpan` can 
+also be used. 
+
+```java
+@Trace(operationName = "mono", resourceName = "mono")
+  private Mono<String> monoMethod() {
+   // ...
+  }
+```
+
+Since the tracer runs with the option `-Ddd.trace.annotation.async=true`, it will finish the span when the `Mono` 
+will complete and not when the method will return.
+
+In this test the context is captured when `block()` is called and every other span opened by the upstream operators
+will have it as parent.
+
+The diagram below shows the span propagated onSubscribe (up arrows)
+and the span propagated downstream onNext/onError/onComplete (down arrows). 
+
+```mermaid
+graph TD;
+    m1[Mono.just<br><em>creates mono</em>]-->|parent|m2;
+    m2[Mono.map<br><em>creates child</em>]-->|parent|m3[Mono.block];
+    m3-->|parent|m2;
+    m2-->|parent|m1;
+```
+
+The resulting trace:
+
+![img.png](img.png)
+
+
+### Top Down context propagation
+
+The context propagation can be changed by advising the span to publish via the reactor `Context`. 
+The span should be put under the key `dd.span`.
+As soon as a publisher emits this span, all the downstream operators will also have that span as active. 
+It is important to use `ContextWrite` in the right places in the reactive chain for this reason.
+
+Relating to the `testSimpleDownstreamPropagation` test case, the reactive chains will capture `parent` as bottom-up propagation
+when `block` is called, but then the propagation is changed when `contextWrite("dd.span", ...)` is called.
+
+The diagram below shows what's happening:
+
+```mermaid
+graph TD;
+    m1[Mono.defer+contextWrite<br><em>creates mono</em>]-->|mono|m2;
+    m2[Mono.map<br><em>creates child</em>]-->|mono|m3[Mono.block];
+    m3-->|parent|m2;
+    m2-->|parent|m1;
+```
+
+The resulting trace:
+
+![img_1.png](img_1.png)
+
+### A more complex scenario
+
+`ContextWrite` can be called several times in the chain in order to change the active span that will be propagated.
+In fact, generally speaking, when a span is put in the context, it will be propagated by all the upstream publishers
+that will have visibility to that reactor context. 
+
+Referring to the `testComplexDownstreamPropagation` test case, the propagation is resumed in the following (simplified) diagram:
+
+```mermaid
+graph TD;
+    m1[Mono.flatmap<br><em>creates first</em>]-->|first|m2;
+    m2[Mono.contextWrite<br><em>set first</em>]-->|first|m3;
+    m3[Mono.map<br><em>creates child</em>]-->|first|m4;
+    m4[Mono.flatmap<br><em>creates second</em>]-->|second|m5;
+    m5[Mono.contextWrite<br><em>set second</em>]-->|second|m6;
+    m6[Mono.flatmap+contextWrite<br><em>creates third</em>]-->|third|m7;
+    m7[Mono.flatmap+contextWrite<br><em>creates third</em>]-->|third|m8;
+    m8[Mono.map<br><em>creates child</em>]-->|third|m9[Mono.block];
+    m6-->|parent|m5;
+    m5-->|parent|m4;
+    m4-->|third|m3;
+    m3-->|second|m2;
+    m2-->|second|m1;
+    m10[start]-->|parent|m1;
+```
+
+The graph starts with parent since it's the span captured when `block` is called. 
+Each flatmap changes the context's active span when `onNext` is signaled
+
+The resulting trace:
+![img_2.png](img_2.png)
+
diff --git a/docs/reactor/img.png b/docs/reactor/img.png
new file mode 100644
index 0000000000000000000000000000000000000000..07e96b8d0c79954efd4c3ce1e653e5910b6dae77
GIT binary patch
literal 7849
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

literal 0
HcmV?d00001

diff --git a/docs/reactor/img_1.png b/docs/reactor/img_1.png
new file mode 100644
index 0000000000000000000000000000000000000000..029ce177f6aadb9909020c428b308d96584388e1
GIT binary patch
literal 12099
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

literal 0
HcmV?d00001

diff --git a/docs/reactor/img_2.png b/docs/reactor/img_2.png
new file mode 100644
index 0000000000000000000000000000000000000000..d78c8ea986182aca6328428edd7980c74f255976
GIT binary patch
literal 13138
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

literal 0
HcmV?d00001

diff --git a/docs/reactor/pom.xml b/docs/reactor/pom.xml
new file mode 100644
index 00000000000..f67dfdcfc7f
--- /dev/null
+++ b/docs/reactor/pom.xml
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>org.example</groupId>
+    <artifactId>dd-trace-java-reactor-examples</artifactId>
+    <version>1.0-SNAPSHOT</version>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>io.projectreactor</groupId>
+            <artifactId>reactor-core</artifactId>
+            <version>3.6.11</version>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.11.2</version>
+            <scope>test</scope>
+        </dependency>
+        <!-- https://mvnrepository.com/artifact/ch.qos.logback/logback-classic -->
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+            <version>1.5.11</version>
+        </dependency>
+        <dependency>
+            <groupId>io.opentelemetry</groupId>
+            <artifactId>opentelemetry-api</artifactId>
+            <version>1.43.0</version>
+        </dependency>
+        <dependency>
+            <groupId>com.datadoghq</groupId>
+            <artifactId>dd-trace-api</artifactId>
+            <version>1.42.0</version>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <version>3.8.0</version>
+                <executions>
+                    <execution>
+                        <id>copy-agent</id>
+                        <phase>process-test-classes</phase>
+                        <goals>
+                            <goal>copy</goal>
+                        </goals>
+                        <configuration>
+                            <artifactItems>
+                                <artifactItem>
+                                    <groupId>com.datadoghq</groupId>
+                                    <artifactId>dd-java-agent</artifactId>
+                                    <version>1.42.0</version>
+                                    <outputDirectory>${project.build.directory}/agents</outputDirectory>
+                                    <destFileName>dd-java-agent.jar</destFileName>
+                                </artifactItem>
+                            </artifactItems>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>2.12.4</version>
+                <configuration>
+                    <argLine>-javaagent:${project.build.directory}/agents/dd-java-agent.jar -Ddd.trace.otel.enabled=true -Ddd.trace.annotation.async=true</argLine>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
diff --git a/docs/reactor/src/test/java/test/ReactorTest.java b/docs/reactor/src/test/java/test/ReactorTest.java
new file mode 100644
index 00000000000..ef23c811f35
--- /dev/null
+++ b/docs/reactor/src/test/java/test/ReactorTest.java
@@ -0,0 +1,120 @@
+package test;
+
+import datadog.trace.api.Trace;
+import io.opentelemetry.api.GlobalOpenTelemetry;
+import io.opentelemetry.api.trace.Span;
+import io.opentelemetry.api.trace.SpanBuilder;
+import io.opentelemetry.api.trace.Tracer;
+import io.opentelemetry.context.Scope;
+import java.time.Duration;
+import java.util.Objects;
+import java.util.Random;
+import org.junit.jupiter.api.Test;
+import reactor.core.publisher.Mono;
+import reactor.util.context.Context;
+
+public class ReactorTest {
+
+  @Trace(operationName = "child", resourceName = "child")
+  private String doSomeMapping(String s) {
+    try {
+      // simulate some work
+      Thread.sleep(500 + new Random(System.currentTimeMillis()).nextInt(1000));
+    } catch (InterruptedException ie) {
+      Thread.currentThread().interrupt();
+    }
+    return s;
+  }
+
+  @Trace(operationName = "mono", resourceName = "mono")
+  private Mono<String> monoMethod() {
+    // This mono will complete when the delay is expired
+    return Mono.delay(Duration.ofSeconds(1)).map(ignored -> "Hello World");
+  }
+
+  @Trace(operationName = "mono", resourceName = "mono")
+  private Mono<String> monoMethodDownstreamPropagate() {
+    // here the active span is the one created by the @Trace annotation before the method executes
+    return Mono.just("Hello World").contextWrite(Context.of("dd.span", Span.current()));
+  }
+
+  private <T> Mono<T> tracedMono(
+      final Tracer tracer, final String spanName, Span parentSpan, final Mono<T> mono) {
+    SpanBuilder spanBuilder = tracer.spanBuilder(spanName);
+    if (parentSpan != null) {
+      spanBuilder.setParent(io.opentelemetry.context.Context.current().with(parentSpan));
+    }
+    final Span span = spanBuilder.startSpan();
+    return mono //
+        .contextWrite(Context.of("dd.span", span))
+        .doFinally(ignored -> span.end());
+  }
+
+  @Test
+  public void testSimpleUpstreamPropagation() {
+    final Tracer tracer = GlobalOpenTelemetry.getTracer("");
+    final Span parent = tracer.spanBuilder("parent").startSpan();
+    assert io.opentelemetry.context.Context.current() == io.opentelemetry.context.Context.root();
+    try (final Scope parentScope = parent.makeCurrent()) {
+      // monoMethod will start a trace when called but that span will complete only when the
+      // returned mono completes.
+      // doSomeMapping will open a span that's child of parent because it's the active one when we
+      // subscribe
+      assert Objects.equals(monoMethod().map(this::doSomeMapping).block(), "Hello World");
+    } finally {
+      parent.end();
+    }
+  }
+
+  @Test
+  public void testSimpleDownstreamPropagation() {
+    final Tracer tracer = GlobalOpenTelemetry.getTracer("");
+    final Span parent = tracer.spanBuilder("parent").startSpan();
+    assert io.opentelemetry.context.Context.current() == io.opentelemetry.context.Context.root();
+    try (final Scope parentScope = parent.makeCurrent()) {
+      // monoMethod will start a trace when called but that span will complete only when the
+      // returned mono completes.
+      // doSomeMapping will open a span that's child of parent because it's the active one when we
+      // subscribe
+      assert Objects.equals(
+          Mono.defer(this::monoMethodDownstreamPropagate).map(this::doSomeMapping).block(),
+          "Hello World");
+    } finally {
+      parent.end();
+    }
+  }
+
+  @Test
+  public void testComplexDownstreamPropagation() {
+    final Tracer tracer = GlobalOpenTelemetry.getTracer("");
+    final Span parent = tracer.spanBuilder("parent").startSpan();
+    assert io.opentelemetry.context.Context.current() == io.opentelemetry.context.Context.root();
+
+    Mono<String> mono =
+        // here we have no active span. when the mono is emitted we propagate the context captured
+        // onSubscribe
+        Mono.just("Hello World") //
+            // change the downstream propagated span to that new one called 'first'
+            // first will be child of parent since parent was captured onSubscribe
+            // (when block is called) and propagated upstream
+            .flatMap(s -> tracedMono(tracer, "first", null, Mono.just(s + ", GoodBye ")))
+            // map will use the active one (first) hence the child will be under first
+            .map(this::doSomeMapping)
+            // we change again the downstream active span to 'second' that's child of 'first'
+            .flatMap(
+                s ->
+                    tracedMono(
+                        tracer, "second", null, Mono.create(sink -> sink.success(s + "World"))))
+            // now we let the downstream propagate third child of parent
+            .flatMap(s -> tracedMono(tracer, "third", parent, Mono.just(s + "!")))
+            // third is the active span downstream
+            .map(this::doSomeMapping) // will create a child span having third as parent
+            .doOnNext(System.out::println);
+    try (final Scope parentScope = parent.makeCurrent()) {
+      // block, like subscribe will capture the current scope (parent here) and propagate upstream
+      assert Objects.equals(mono.block(), "Hello World, GoodBye World!");
+    } finally {
+      parent.end();
+    }
+  }
+}