Learnings and changelog for Dashboard Conventions. Agents read the Learnings section before dashboard work and append to it in-session; the Changelog is for reflection. Shape and rules: 0020-conventions-and-learnings-two-type-capture.
Learnings
- 2026-07-31 · rejection · one big cutover bundling Foundry, ClickHouse, and the server bump; they separate, and the ClickHouse jump stays on its own change after two ZooKeeper burns · 2026-07-31 SigNoz Dashboard v2 Break and Upgrade Readiness
- 2026-09-01 · correction · a build guard that validates the wrong package reports success; demand a failing case before trusting any checker · 2026-09-01 The Rename Was the Visible Half
- 2026-09-01 · confirmation · no cost metric in OTel semconv, verified three ways before trusting a docstring; a panel number must be sourced before it becomes a column · 2026-09-01 The Rename Was the Visible Half
- 2026-09-03 · correction · “active” in the metric list meant exported, not recording; a flat quantile is a bucket or cardinality problem at the emitter, not a query problem · 2026-09-03 The Histogram Had One Series Per Request
- 2026-09-03 · confirmation · the fix at the emitter (one exclude line, validated at startup) beat the collector processor planned two days earlier · 2026-09-03 The Histogram Had One Series Per Request
- 2026-09-04 · confirmation · every rule in the conventions doc came from a human opening the rendered panel; “ships when legible, not when the query is correct” · the LiteLLM dashboard sessions that produced the doc
Changelog
- 2026-09-04 · added · the full rule set, as the SigNoz Dashboard Design Guide · distilled from the LiteLLM Proxy dashboard corrections above
- 2026-09-19 · changed · renamed to Dashboard Conventions and moved to
Atlas/References/Conventions/; learnings split into this file · 0020-conventions-and-learnings-two-type-capture