Set telemetry configuration

Sets the telemetry configuration. Returns 201 if telemetry was not previously configured; returns 200 if it was. Selection is opt-in: a request that enables no categories (a browser config with nothing set to true, or every category disabled) clears the configuration; this is idempotent when telemetry is not configured.

put/telemetry

Request body

Response

Telemetry configuration updated

seqinteger required

Process-monotonic sequence number of the last published event. Does not reset across configuration changes.

dropped_eventsinteger

Cumulative number of buffered events a consumer missed because it fell behind the ring, summed across consumers and configuration changes. A rising count means the stream is being produced faster than it is being read; a steady one means nothing has been lost. Always present on images that report it; absent on an image predating the field, which is not the same as zero.

applied_atstring date-time

Wall-clock time at which the current configuration was applied. Omitted when telemetry is not configured.

Changes