Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.268 ·

Event upload holding reworked around a server-driven flush policy

Claude Code's telemetry uploader now follows a server-provided policy for when to hold or flush events, with a kill switch

TierUnder the hoodhow much it should matter to you
Useful2my rating, 1 to 5
Signal3worth watching, 1 to 5
AreaTelemetrywhat it touches
KindInternal Changesin v2.1.268,
Group of 2 Under the hood

Claude Code's telemetry uploader now follows a server-provided policy for when to hold or flush events, with a kill switch

What

The client-side logic that decides when to hold versus upload telemetry events was substantially reworked:

  • A new mechanism ingests a server-provided 'flush policy' (limits on max events, max age, max bytes, whether to flush when sampling ends, and which event types must always flush), logging when the policy is adopted, changed, or cleared, and warning when the policy is unreadable.
  • Hold decisions are now split into two lanes: served_policy (driven by the server's policy, which flushes when sampling ends) and no_subscriber_flag.
  • A new eventHoldEnabled setting acts as a kill switch that can turn off event holding entirely.
  • Ephemeral stream events can now be dropped entirely when there is no subscriber watching them, with a telemetry counter tracking how often this happens.
  • Each release/flush now tracks a reason: round-trip, event, or sampling-end.

Why

This lets the server control telemetry upload timing and volume dynamically instead of relying purely on fixed client-side rules, and provides a way to disable event holding if it causes problems, while avoiding wasted work uploading events nobody is watching.

See this entry in the whole of v2.1.268 →

Feedback