Skip to content

Add auction telemetry addendum design spec - #987

Merged
aram356 merged 6 commits into
mainfrom
auction-telemetry-addendum-spec
Sep 1, 2026
Merged

Add auction telemetry addendum design spec#987
aram356 merged 6 commits into
mainfrom
auction-telemetry-addendum-spec

Conversation

@jevansnyc

@jevansnyc jevansnyc commented Jul 31, 2026

Copy link
Copy Markdown
Collaborator

What

Adds the 2026-07-30 auction telemetry addendum design spec as a reviewable document at docs/superpowers/specs/2026-07-30-auction-telemetry-addendum-dimensions-dashboard.md, alongside the parent design it amends (2026-06-22-auction-prebid-metrics-tinybird-grafana-design.md, shipped in #818).

This PR is docs only so engineering can comment line by line on the spec. No code, Tinybird, or Grafana changes are included here.

Why open it as a PR

The addendum specifies several workstreams: edge Rust signal propagation, fixed per-minute materialized views, hourly dimensional rollups and endpoints, health and reconciliation endpoints, and dashboard as code. Landing the spec first gives those implementation PRs a shared contract.

What the spec covers

  • Rollup correctness: the three materialized-view null-filter fixes, conditional quantile handling, and explicit sample-count columns.
  • New hourly dimensional rollups carrying country, device_class, browser_family, and os_family.
  • Complete user_agent propagation from the edge, with browser and OS aggregation owned by Tinybird dimensional materialized views.
  • Intentional raw User-Agent retention under the existing 30-day datasource TTL, including consent-denied observations.
  • Health endpoints: real quarantine_counts plus event_reconciliation.
  • Grafana dashboard-as-code panel definitions.

Implementation tracking

Tracks #979.

Adds the 2026-07-30 addendum to the auction telemetry design
(2026-06-22-auction-prebid-metrics-tinybird-grafana-design.md, shipped
in #818): rollup correctness fixes, hourly breakdown dimensions, browser
signals from the edge, health endpoints, and a dashboard-as-code spec.

Tracks #979.
@aram356
aram356 marked this pull request as draft August 13, 2026 15:29
@aram356

aram356 commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

@jevansnyc to update the spec

@aram356 aram356 added this to the 202608 milestone Aug 27, 2026
@aram356
aram356 requested review from aram356 and prk-Jr August 27, 2026 15:52
@aram356
aram356 marked this pull request as ready for review August 27, 2026 15:52
@aram356 aram356 modified the milestones: 202608, 202609 Sep 1, 2026
@aram356
aram356 merged commit 67b1d74 into main Sep 1, 2026
19 checks passed
@aram356
aram356 deleted the auction-telemetry-addendum-spec branch September 1, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Auction telemetry addendum: rollup correctness, breakdown dimensions, and dashboard spec

4 participants