Expand description
Top-level batch envelope posted by the analytics client to POST /v1/events.
Structs§
- Batch
- BatchId
- Idempotency key — the server dedups on this. Replays return 200
{"deduplicated": true}and write nothing. - Device
Id - Stable per-install identifier, present only when the underlying mesh SDK exposes its telemetry install id (derived from the per-install scrub secret; an already-scrubbed opaque string, never a raw device serial). Absent on SDKs without the capability — the server then falls back to session-unit counting (plan §1.1 distinct-device migration path).
- Session
Id - Minted by the telemetry client when telemetry is enabled, and rotated at the first foreground after a background or at an explicit session end. The protocol emits no session id of its own, so the client owns this one.
Enums§
- OsKind
- The host operating system a batch was produced on.
Constants§
Type Aliases§
- Wire
Version - Bumped on incompatible wire-schema changes. Servers must accept the current version and (per plan §6.4) the previous version for at least 90 days after the bump.