Document how to add span/transaction data for Java and Android (#12287)

Author: adinauer

docs/platforms/android/tracing/instrumentation/custom-instrumentation.mdx

@@ -17,3 +17,5 @@ To capture transactions and spans customized to your organization's needs, you m
 <PlatformContent includePath="performance/create-transaction-bound-to-scope" />
 
 <PlatformContent includePath="performance/connect-errors-spans" />
+
+<PlatformContent includePath="performance/improving-data" />

docs/platforms/java/common/tracing/instrumentation/custom-instrumentation/index.mdx

@@ -17,3 +17,5 @@ To capture transactions and spans customized to your organization's needs, you m
 <PlatformContent includePath="performance/create-transaction-bound-to-scope" />
 
 <PlatformContent includePath="performance/connect-errors-spans" />
+
+<PlatformContent includePath="performance/improving-data" />

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

@@ -0,0 +1,51 @@
+## Improving Data on Transactions and Spans
+
+### Adding Data Attributes to Transactions
+
+You can add data attributes to your transactions. This data is visible in the trace explorer in Sentry. Data attributes can be of type `String`, `Number` or `Boolean`, as well as (non-mixed) arrays of these types:
+
+```java
+ITransaction transaction = Sentry.startTransaction("processOrderBatch()", "task");
+transaction.setData("my-data-attribute-1", "value1");
+transaction.setData("my-data-attribute-2", 42);
+transaction.setData("my-data-attribute-3", true);
+
+transaction.setData("my-data-attribute-4", Arrays.asList("value1", "value2", "value3"));
+transaction.setData("my-data-attribute-5", Arrays.asList(42, 43, 44));
+transaction.setData("my-data-attribute-6", Arrays.asList(true, false, true));
+```
+```kotlin
+ITransaction transaction = Sentry.startTransaction("processOrderBatch()", "task");
+transaction.setData("my-data-attribute-1", "value1")
+transaction.setData("my-data-attribute-2", 42)
+transaction.setData("my-data-attribute-3", true)
+
+transaction.setData("my-data-attribute-4", listOf("value1", "value2", "value3"))
+transaction.setData("my-data-attribute-5", listOf(42, 43, 44))
+transaction.setData("my-data-attribute-6", listOf(true, false, true))
+```
+
+### Adding Data Attributes to Spans
+
+You can add data attributes to your spans. This data is visible in the trace explorer in Sentry. Data attributes can be of type `String`, `Number` or `Boolean`, as well as (non-mixed) arrays of these types:
+
+```java
+ISpan span = parent.startChild("task", "operation");
+span.setData("my-data-attribute-1", "value1");
+span.setData("my-data-attribute-2", 42);
+span.setData("my-data-attribute-3", true);
+
+span.setData("my-data-attribute-4", Arrays.asList("value1", "value2", "value3"));
+span.setData("my-data-attribute-5", Arrays.asList(42, 43, 44));
+span.setData("my-data-attribute-6", Arrays.asList(true, false, true));
+```
+```kotlin
+ISpan span = parent.startChild("task", "operation");
+span.setData("my-data-attribute-1", "value1")
+span.setData("my-data-attribute-2", 42)
+span.setData("my-data-attribute-3", true)
+
+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))
+```

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

@@ -0,0 +1,51 @@
+## Improving Data on Transactions and Spans
+
+### Adding Data Attributes to Transactions
+
+You can add data attributes to your transactions. This data is visible in the trace explorer in Sentry. Data attributes can be of type `String`, `Number` or `Boolean`, as well as (non-mixed) arrays of these types:
+
+```java
+ITransaction transaction = Sentry.startTransaction("processOrderBatch()", "task");
+transaction.setData("my-data-attribute-1", "value1");
+transaction.setData("my-data-attribute-2", 42);
+transaction.setData("my-data-attribute-3", true);
+
+transaction.setData("my-data-attribute-4", Arrays.asList("value1", "value2", "value3"));
+transaction.setData("my-data-attribute-5", Arrays.asList(42, 43, 44));
+transaction.setData("my-data-attribute-6", Arrays.asList(true, false, true));
+```
+```kotlin
+ITransaction transaction = Sentry.startTransaction("processOrderBatch()", "task");
+transaction.setData("my-data-attribute-1", "value1")
+transaction.setData("my-data-attribute-2", 42)
+transaction.setData("my-data-attribute-3", true)
+
+transaction.setData("my-data-attribute-4", listOf("value1", "value2", "value3"))
+transaction.setData("my-data-attribute-5", listOf(42, 43, 44))
+transaction.setData("my-data-attribute-6", listOf(true, false, true))
+```
+
+### Adding Data Attributes to Spans
+
+You can add data attributes to your spans. This data is visible in the trace explorer in Sentry. Data attributes can be of type `String`, `Number` or `Boolean`, as well as (non-mixed) arrays of these types:
+
+```java
+ISpan span = parent.startChild("task", "operation");
+span.setData("my-data-attribute-1", "value1");
+span.setData("my-data-attribute-2", 42);
+span.setData("my-data-attribute-3", true);
+
+span.setData("my-data-attribute-4", Arrays.asList("value1", "value2", "value3"));
+span.setData("my-data-attribute-5", Arrays.asList(42, 43, 44));
+span.setData("my-data-attribute-6", Arrays.asList(true, false, true));
+```
+```kotlin
+ISpan span = parent.startChild("task", "operation");
+span.setData("my-data-attribute-1", "value1")
+span.setData("my-data-attribute-2", 42)
+span.setData("my-data-attribute-3", true)
+
+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))
+```