feat: Android observability plugin session replay support #268

tanderson-ld · 2025-10-14T20:59:36Z

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.

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.

^{Written by Cursor Bugbot for commit d52ac80. This will update automatically on new commits. Configure here.}

…lay GraphQL API Service

…ted tests

...-android/lib/src/main/kotlin/com/launchdarkly/observability/client/InstrumentationManager.kt

...rvability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/CaptureSource.kt

...droid/lib/src/main/kotlin/com/launchdarkly/observability/client/RoutingLogRecordProcessor.kt

...-android/lib/src/main/kotlin/com/launchdarkly/observability/client/NoopLogRecordPrcoessor.kt

...y/observability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/Capture.kt

...y-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/ReplaySessionProtocol.kt

...y-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/ReplayInstrumentation.kt

...android/lib/src/main/kotlin/com/launchdarkly/observability/replay/SessionReplayApiService.kt

...rvability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/CaptureSource.kt

...y-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/ReplayInstrumentation.kt

...y-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/ReplaySessionProtocol.kt

...d/lib/src/main/kotlin/com/launchdarkly/observability/replay/RRwebGraphQLReplayLogExporter.kt

...-android/lib/src/main/kotlin/com/launchdarkly/observability/client/NoopLogRecordProcessor.kt

...d/lib/src/main/kotlin/com/launchdarkly/observability/replay/RRwebGraphQLReplayLogExporter.kt

🤖 I have created a release *beep* *boop* --- <details><summary>launchdarkly-observability-android: 0.12.0</summary> ## [0.12.0](launchdarkly-observability-android-0.11.0...launchdarkly-observability-android-0.12.0) (2025-10-24) ### Features * Android observability plugin session replay support ([#268](#268)) ([4ba5124](4ba5124)) * O11Y-601 - Add Android launch time instrumentation ([#274](#274)) ([38b4a84](38b4a84)) </details> <details><summary>observability: 0.4.6</summary> ## [0.4.6](observability-0.4.5...observability-0.4.6) (2025-10-24) ### Dependencies * The following workspace dependencies were updated * dependencies * highlight.run bumped to 9.22.3 </details> <details><summary>session-replay: 0.4.6</summary> ## [0.4.6](session-replay-0.4.5...session-replay-0.4.6) (2025-10-24) ### Dependencies * The following workspace dependencies were updated * dependencies * highlight.run bumped to 9.22.3 </details> <details><summary>highlight.run: 9.22.3</summary> ## [9.22.3](highlight.run-9.22.2...highlight.run-9.22.3) (2025-10-24) ### Bug Fixes * avoid noisy error log on starting new sessions ([#269](#269)) ([e76004c](e76004c)) * make sessionCookie session a boolean type ([#272](#272)) ([9fb304d](9fb304d)) </details> --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).  --- > [!NOTE] > Publish new Android, Web Observability, and Session Replay releases plus highlight.run 9.22.3 with minor features and fixes, and bump internal dependencies accordingly. > > - **SDK releases**: > - **Android (`sdk/@launchdarkly/observability-android`) 0.12.0**: > - Add session replay support in the Android observability plugin. > - Add Android launch time instrumentation. > - **Web Observability (`sdk/@launchdarkly/observability`) 0.4.6**: > - Dependency: `highlight.run` -> `9.22.3`. > - **Session Replay (`sdk/@launchdarkly/session-replay`) 0.4.6**: > - Dependency: `highlight.run` -> `9.22.3`. > - **highlight.run (`sdk/highlight-run`) 9.22.3**: > - Bug fixes: reduce noisy error log on new sessions; make `sessionCookie.session` a boolean. > - **Version manifests**: > - Update `.release-please-manifest.json` and package versions to match releases. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 1081a4c. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>

tanderson-ld added 2 commits October 14, 2025 16:55

feat: adds initial Android observability plugin session replay support

fc74ce0

Merge remote-tracking branch 'origin' into ta/O11Y-606/replay

b16b617

tanderson-ld requested a review from agrognetti October 14, 2025 20:59

tanderson-ld requested a review from a team as a code owner October 14, 2025 20:59

Vadman97 self-requested a review October 15, 2025 14:18

tanderson-ld added 2 commits October 15, 2025 12:05

adding stories for todos

31badab

adding rotation handling logic, piping service options through to rep…

0bc072b

…lay GraphQL API Service

This comment was marked as outdated.

Sign in to view

tanderson-ld added 2 commits October 16, 2025 10:09

fixing prettier issue

33a2f9e

adds unit tets for replay exporter

4c15d96

tanderson-ld force-pushed the ta/O11Y-606/replay branch from 5d0717c to 4c15d96 Compare October 16, 2025 15:24

refactoring some functions in instrumentation manager and adding rela…

9e1e15a

…ted tests

tanderson-ld commented Oct 17, 2025

View reviewed changes

...-android/lib/src/main/kotlin/com/launchdarkly/observability/client/InstrumentationManager.kt Outdated Show resolved Hide resolved

tweaking telemetry inspector usage for testing

3d7315a

agrognetti requested changes Oct 21, 2025

View reviewed changes

Vadman97 reviewed Oct 21, 2025

View reviewed changes

...rvability-android/lib/src/main/kotlin/com/launchdarkly/observability/replay/CaptureSource.kt Show resolved Hide resolved

agrognetti requested changes Oct 21, 2025

View reviewed changes

Vadman97 requested a review from agrognetti October 24, 2025 18:10

addressing lots of review comments

6cbc102

tanderson-ld force-pushed the ta/O11Y-606/replay branch from 293e55d to 6cbc102 Compare October 24, 2025 18:24

Merge remote-tracking branch 'origin/main' into ta/O11Y-606/replay

7ee432d

cursor bot reviewed Oct 24, 2025

View reviewed changes

...-android/lib/src/main/kotlin/com/launchdarkly/observability/client/NoopLogRecordProcessor.kt Show resolved Hide resolved

fixing file name issue

627d5e5

agrognetti approved these changes Oct 24, 2025

View reviewed changes

Merge remote-tracking branch 'origin/main' into ta/O11Y-606/replay

d52ac80

cursor bot reviewed Oct 24, 2025

View reviewed changes

...d/lib/src/main/kotlin/com/launchdarkly/observability/replay/RRwebGraphQLReplayLogExporter.kt Show resolved Hide resolved

Vadman97 approved these changes Oct 24, 2025

View reviewed changes

tanderson-ld merged commit 4ba5124 into main Oct 24, 2025
22 checks passed

tanderson-ld deleted the ta/O11Y-606/replay branch October 24, 2025 20:50

LaunchDarklyReleaseBot mentioned this pull request Oct 24, 2025

chore: release main #271

Merged

feat: Android observability plugin session replay support #268

feat: Android observability plugin session replay support #268

Uh oh!

Conversation

tanderson-ld commented Oct 14, 2025 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

How did you test this change?

Are there any deployment considerations?

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

tanderson-ld commented Oct 14, 2025 •

edited by cursor bot

Loading