"/home/yossef/notes/git/projects/maplibra/observability/Rollout Telemetry.md"

path: maplibra/observability/Rollout Telemetry.md

- **fileName**: Rollout Telemetry
- **Created on**: 2026-06-16 00:48:42

Rollout Telemetry

Migrated from: obs_vault

Parent: ./Runtime Flags and Observability.md

This note covers the opt-in telemetry sink used for routing fallbacks and startup observation.

Main Source File

• src/bootstrap/rollout-telemetry.js

What It Does

• Sends routing and startup telemetry with sendBeacon first, then fetch(..., keepalive).
• Augments payloads with a timestamp and the current URL.

Why It Matters

• This is the quickest way to understand which rollout path the app actually used.

Risks

• Telemetry is best-effort and silent on failure, so missing data does not always mean missing events.
• Including the page URL in the payload is useful for debugging, but it has privacy implications.

See Also

• ./Runtime Flags.md

• ./Startup Perf and Budgets.md

  continue:[[]]
  before:[[]]