Feat/java add data to all spans (#12483)

* document how to attach data to all transactions and its spans

* fix import statement

* fix kotlin samples, use setData on trace

* fix code samples

---------

Co-authored-by: Alexander Dinauer <[email protected]>

Author: lbloder

platform-includes/configuration/data-to-all-spans/android.mdx

@@ -0,0 +1,45 @@
+```java
+Sentry.init(options -> {
+    options.setBeforeSendTransaction((transaction, hint) -> {
+        
+        // set the attribute on the root span
+        if (transaction.getContexts().getTrace() == null) {
+            SpanContext spanContext = new SpanContext("op");
+            transaction.getContexts().setTrace(spanContext);
+        }
+        transaction.getContexts().getTrace().setData("myAttribute", "myValue");
+
+        // and on all child spans
+        transaction.getSpans().forEach(span -> {
+            if (span.getData() == null) {
+                span.setData(new HashMap<>());
+            }
+            span.getData().put("myAttribute", "myValue");
+        });
+
+        return transaction;
+    });
+});
+```
+```kotlin
+Sentry.init { options ->
+    options.setBeforeSendTransaction { transaction, hint ->
+    
+        // set the attribute on the root span
+        if (transaction.contexts.trace == null) {
+            transaction.contexts.setTrace(SpanContext("op"))
+        }
+        transaction.contexts.trace?.setData("myAttribute", "myValue")
+
+        // and on all child spans
+        transaction.spans.forEach { span ->
+            if (span.data == null) {
+                span.data = HashMap()
+            }
+            span.data?.set("myAttribute", "myValue")
+        }
+
+        transaction
+    }
+}
+```

platform-includes/configuration/data-to-all-spans/java.mdx

@@ -0,0 +1,45 @@
+```java
+Sentry.init(options -> {
+    options.setBeforeSendTransaction((transaction, hint) -> {
+        
+        // set the attribute on the root span
+        if (transaction.getContexts().getTrace() == null) {
+            SpanContext spanContext = new SpanContext("op");
+            transaction.getContexts().setTrace(spanContext);
+        }
+        transaction.getContexts().getTrace().setData("myAttribute", "myValue");
+
+        // and on all child spans
+        transaction.getSpans().forEach(span -> {
+            if (span.getData() == null) {
+                span.setData(new HashMap<>());
+            }
+            span.getData().put("myAttribute", "myValue");
+        });
+
+        return transaction;
+    });
+});
+```
+```kotlin
+Sentry.init { options ->
+    options.setBeforeSendTransaction { transaction, hint ->
+    
+        // set the attribute on the root span
+        if (transaction.contexts.trace == null) {
+            transaction.contexts.setTrace(SpanContext("op"))
+        }
+        transaction.contexts.trace?.setData("myAttribute", "myValue")
+
+        // and on all child spans
+        transaction.spans.forEach { span ->
+            if (span.data == null) {
+                span.data = HashMap()
+            }
+            span.data?.set("myAttribute", "myValue")
+        }
+
+        transaction
+    }
+}
+```

platform-includes/configuration/data-to-all-spans/java.spring-boot.mdx

@@ -0,0 +1,59 @@
+```java
+import io.sentry.protocol.SentryTransaction;
+import io.sentry.SentryOptions;
+import io.sentry.Hint;
+import org.springframework.stereotype.Component;
+
+@Component
+public class CustomBeforeSendTransactionCallback implements SentryOptions.BeforeSendTransactionCallback {
+    @Override
+    public SentryTransaction execute(SentryTransaction transaction, Hint hint) {
+
+        // set the attribute on the root span
+        if (transaction.getContexts().getTrace() == null) {
+            SpanContext spanContext = new SpanContext("op");
+            transaction.getContexts().setTrace(spanContext);
+        }
+        transaction.getContexts().getTrace().setData("myAttribute", "myValue");
+
+        // and on all child spans
+        transaction.getSpans().forEach(span -> {
+            if (span.getData() == null) {
+                span.setData(new HashMap<>());
+            }
+            span.getData().put("myAttribute", "myValue");
+        });
+
+        return transaction;
+    }
+}
+```
+
+```kotlin
+import io.sentry.protocol.SentryTransaction
+import io.sentry.SentryOptions
+import io.sentry.Hint
+import org.springframework.stereotype.Component
+
+@Component
+class CustomBeforeSendTransactionCallback : SentryOptions.BeforeSendTransactionCallback {
+    override fun execute(transaction: SentryTransaction, hint: Hint): SentryTransaction? {
+        
+        // set the attribute on the root span
+        if (transaction.contexts.trace == null) {
+            transaction.contexts.setTrace(SpanContext("op"))
+        }
+        transaction.contexts.trace?.setData("myAttribute", "myValue")
+
+        // and on all child spans
+        transaction.spans.forEach { span ->
+            if (span.data == null) {
+                span.data = HashMap()
+            }
+            span.data?.set("myAttribute", "myValue")
+        }
+
+        transaction
+    }
+}
+```

platform-includes/configuration/data-to-all-spans/java.spring.mdx

@@ -0,0 +1,59 @@
+```java
+import io.sentry.protocol.SentryTransaction;
+import io.sentry.SentryOptions;
+import io.sentry.Hint;
+import org.springframework.stereotype.Component;
+
+@Component
+public class CustomBeforeSendTransactionCallback implements SentryOptions.BeforeSendTransactionCallback {
+    @Override
+    public SentryTransaction execute(SentryTransaction transaction, Hint hint) {
+
+        // set the attribute on the root span
+        if (transaction.getContexts().getTrace() == null) {
+            SpanContext spanContext = new SpanContext("op");
+            transaction.getContexts().setTrace(spanContext);
+        }
+        transaction.getContexts().getTrace().setData("myAttribute", "myValue");
+
+        // and on all child spans
+        transaction.getSpans().forEach(span -> {
+            if (span.getData() == null) {
+                span.setData(new HashMap<>());
+            }
+            span.getData().put("myAttribute", "myValue");
+        });
+
+        return transaction;
+    }
+}
+```
+
+```kotlin
+import io.sentry.protocol.SentryTransaction
+import io.sentry.SentryOptions
+import io.sentry.Hint
+import org.springframework.stereotype.Component
+
+@Component
+class CustomBeforeSendTransactionCallback : SentryOptions.BeforeSendTransactionCallback {
+    override fun execute(transaction: SentryTransaction, hint: Hint): SentryTransaction? {
+        
+        // set the attribute on the root span
+        if (transaction.contexts.trace == null) {
+            transaction.contexts.setTrace(SpanContext("op"))
+        }
+        transaction.contexts.trace?.setData("myAttribute", "myValue")
+
+        // and on all child spans
+        transaction.spans.forEach { span ->
+            if (span.data == null) {
+                span.data = HashMap()
+            }
+            span.data?.set("myAttribute", "myValue")
+        }
+
+        transaction
+    }
+}
+```

platform-includes/performance/improving-data/android.mdx

@@ -49,3 +49,9 @@ span.setData("my-data-attribute-4", listOf("value1", "value2", "value3"))
 span.setData("my-data-attribute-5", listOf(42, 43, 44))
 span.setData("my-data-attribute-6", listOf(true, false, true))
 ```
+
+### Adding Attributes to all Spans and Transactions
+
+To add an attribute to all spans, use the `beforeSendTransaction` callback:
+
+<PlatformContent includePath="configuration/data-to-all-spans" />

platform-includes/performance/improving-data/java.mdx

@@ -49,3 +49,9 @@ span.setData("my-data-attribute-4", listOf("value1", "value2", "value3"))
 span.setData("my-data-attribute-5", listOf(42, 43, 44))
 span.setData("my-data-attribute-6", listOf(true, false, true))
 ```
+
+### Adding Attributes to all Spans and Transactions
+
+To add an attribute to all spans, use the `beforeSendTransaction` callback:
+
+<PlatformContent includePath="configuration/data-to-all-spans" />