feat: Android observability plugin session replay support (#268)

## Summary

Adds initial implementation of Android observability plugin session
replay support. Still has many remaining TODOs, some of which will be
given new stories for fleshing out specific handling/behaviors.

## How did you test this change?

Unit tests on instrumentation manager. There is a later story in the
epic to add e2e instrumented tests.

## Are there any deployment considerations?

This is only for alpha consumption and no promises related to stability
of code can be made at this time.



<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Introduces session replay capture/export via RRWeb GraphQL, adds
pluggable instrumentations with a routing log processor, updates GraphQL
var handling and TelemetryInspector.
> 
> - **SDK/Core**:
> - **Session Replay**: New replay pipeline with
`ReplayInstrumentation`, `CaptureSource`,
`RRwebGraphQLReplayLogExporter`, `SessionReplayApiService`, protocol
models (`ReplaySessionProtocol.kt`), and GraphQL ops
(`InitializeReplaySession.graphql`, `IdentifyReplaySession.graphql`,
`PushPayload.graphql`).
> - **Options**: Add `instrumentations:
List<LDExtendedInstrumentation>`; expose `DEFAULT_SERVICE_NAME`,
`DEFAULT_OTLP_ENDPOINT`, `DEFAULT_BACKEND_URL`.
> - **InstrumentationManager**: Support external instrumentations; add
`createLoggerProcessor` using `RoutingLogRecordProcessor`; integrate
`TelemetryInspector` exporters (lazy); minor refactors to
exporters/processors.
> - **Logging**: Add `RoutingLogRecordProcessor` and
`NoopLogRecordProcessor` for scope-based log routing.
> - **GraphQL**: Change variables to `JsonElement`; update
`SamplingApiService` accordingly.
>   - **Build**: Add Compose UI deps for capture.
> - **Example App**:
> - Include `ReplayInstrumentation` in `BaseApplication` plugin options.
> - **Tests**:
> - New tests for logger processor routing and replay exporter; update
GraphQL/Sampling tests for `JsonPrimitive`; adjust E2E disabling tests
to not depend on null exporters.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
d52ac80. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: tanderson-ld

e2e/android/app/src/main/java/com/example/androidobservability/BaseApplication.kt

@@ -9,6 +9,7 @@ import com.launchdarkly.sdk.android.Components
 import com.launchdarkly.sdk.android.LDClient
 import com.launchdarkly.sdk.android.LDConfig
 import com.launchdarkly.observability.plugin.Observability
+import com.launchdarkly.observability.replay.ReplayInstrumentation
 import com.launchdarkly.sdk.android.LDAndroidLogging
 import com.launchdarkly.sdk.android.integrations.Plugin
 import io.opentelemetry.api.common.AttributeKey
@@ -29,6 +30,10 @@ open class BaseApplication : Application() {
         ),
         debug = true,
         logAdapter = LDAndroidLogging.adapter(),
+        // TODO: consider these being factories so that the obs plugin can pass instantiation data, log adapter
+        instrumentations = listOf(
+            ReplayInstrumentation()
+        ),
     )
 
     var telemetryInspector: TelemetryInspector? = null

e2e/android/app/src/test/java/com/example/androidobservability/DisablingConfigOptionsE2ETest.kt

@@ -2,18 +2,17 @@ package com.example.androidobservability
 
 import android.app.Application
 import androidx.test.core.app.ApplicationProvider
+import com.example.androidobservability.TestUtils.TelemetryType
 import com.example.androidobservability.TestUtils.waitForTelemetryData
+import com.launchdarkly.observability.api.Options
 import com.launchdarkly.observability.interfaces.Metric
 import com.launchdarkly.observability.sdk.LDObserve
 import io.opentelemetry.api.common.AttributeKey
 import io.opentelemetry.api.common.Attributes
 import io.opentelemetry.api.logs.Severity
-import com.example.androidobservability.TestUtils.TelemetryType
-import com.launchdarkly.observability.api.Options
 import junit.framework.TestCase.assertEquals
 import junit.framework.TestCase.assertFalse
 import junit.framework.TestCase.assertNotNull
-import junit.framework.TestCase.assertNull
 import junit.framework.TestCase.assertTrue
 import org.junit.Test
 import org.junit.runner.RunWith
@@ -96,7 +95,6 @@ class DisablingConfigOptionsE2ETest {
         LDObserve.flush()
         waitForTelemetryData(telemetryInspector = application.telemetryInspector, telemetryType = TelemetryType.METRICS)
 
-        assertNull(application.telemetryInspector?.metricExporter)
         assertFalse(requestsContainsUrl(metricsUrl))
     }
 
@@ -110,7 +108,6 @@ class DisablingConfigOptionsE2ETest {
         LDObserve.flush()
         waitForTelemetryData(telemetryInspector = application.telemetryInspector, telemetryType = TelemetryType.METRICS)
 
-        assertNotNull(application.telemetryInspector?.metricExporter)
         assertTrue(requestsContainsUrl(metricsUrl))
     }
 

sdk/@launchdarkly/observability-android/lib/build.gradle.kts

@@ -55,6 +55,11 @@ dependencies {
     // Android crash instrumentation
     implementation("io.opentelemetry.android.instrumentation:crash:0.11.0-alpha")
 
+    // TODO: O11Y-626 - move replay instrumentation and associated compose dependencies into dedicated package
+    // Compose dependencies for capture functionality
+    implementation("androidx.compose.ui:ui:1.7.5")
+    implementation("androidx.compose.ui:ui-tooling:1.7.5")
+
     // Use JUnit Jupiter for testing.
     testImplementation(platform("org.junit:junit-bom:5.13.4"))
     testImplementation("org.junit.jupiter:junit-jupiter")

sdk/@launchdarkly/observability-android/lib/src/main/kotlin/com/launchdarkly/observability/api/Options.kt

@@ -2,13 +2,15 @@ package com.launchdarkly.observability.api
 
 import com.launchdarkly.logging.LDLogAdapter
 import com.launchdarkly.observability.BuildConfig
+import com.launchdarkly.observability.interfaces.LDExtendedInstrumentation
 import com.launchdarkly.sdk.android.LDTimberLogging
 import io.opentelemetry.api.common.Attributes
 import kotlin.time.Duration
 import kotlin.time.Duration.Companion.minutes
 
-private const val DEFAULT_OTLP_ENDPOINT = "https://otel.observability.app.launchdarkly.com:4318"
-private const val DEFAULT_BACKEND_URL = "https://pub.observability.app.launchdarkly.com"
+const val DEFAULT_SERVICE_NAME = "observability-android"
+const val DEFAULT_OTLP_ENDPOINT = "https://otel.observability.app.launchdarkly.com:4318"
+const val DEFAULT_BACKEND_URL = "https://pub.observability.app.launchdarkly.com"
 
 /**
  * Configuration options for the Observability plugin.
@@ -27,21 +29,23 @@ private const val DEFAULT_BACKEND_URL = "https://pub.observability.app.launchdar
  * @property disableMetrics Disables metrics if true. Defaults to false.
  * @property logAdapter The log adapter to use. Defaults to using the LaunchDarkly SDK's LDTimberLogging.adapter(). Use LDAndroidLogging.adapter() to use the Android logging adapter.
  * @property loggerName The name of the logger to use. Defaults to "LaunchDarklyObservabilityPlugin".
+ * @property instrumentations List of additional instrumentations to use
  */
 data class Options(
-    val serviceName: String = "observability-android",
+    val serviceName: String = DEFAULT_SERVICE_NAME,
     val serviceVersion: String = BuildConfig.OBSERVABILITY_SDK_VERSION,
     val otlpEndpoint: String = DEFAULT_OTLP_ENDPOINT,
     val backendUrl: String = DEFAULT_BACKEND_URL,
     val resourceAttributes: Attributes = Attributes.empty(),
     val customHeaders: Map<String, String> = emptyMap(),
     val sessionBackgroundTimeout: Duration = 15.minutes,
     val debug: Boolean = false,
-    // TODO O11Y-398: implement disable config options after all other instrumentations are implemented
     val disableErrorTracking: Boolean = false,
     val disableLogs: Boolean = false,
     val disableTraces: Boolean = false,
     val disableMetrics: Boolean = false,
     val logAdapter: LDLogAdapter = LDTimberLogging.adapter(), // this follows the LaunchDarkly SDK's default log adapter
-    val loggerName: String = "LaunchDarklyObservabilityPlugin"
+    val loggerName: String = "LaunchDarklyObservabilityPlugin",
+    // TODO: update this to provide a list of factories instead of instances
+    val instrumentations: List<LDExtendedInstrumentation> = emptyList()
 )