KPI Dashboard
beta · Family governance-docs · Phase undefined · Sizes lean, full · ~1,750 tokens
The defined set of key performance indicators an organization watches to know whether it is making progress toward its objectives, plus the specification of how each is measured, targeted, owned, and reviewed. A standing governance instrument and a platform-agnostic dashboard definition (not a live BI tool) that survives Goodhart’s Law and the vanity-metric trap by keeping metrics actionable, precisely defined, owned, and reviewed on a cadence.
Fast reference for using the kpi-dashboard bundle. For the full reasoning, history, and sources, read
kpi-dashboard_companion.md.
First, the scope: this bundle is a document that defines a dashboard - which metrics matter, how each is measured, targeted, owned, and reviewed. It is platform-agnostic and precedes the build in Tableau, Looker, Power BI, or Amplitude. It is not the live tool.
When to use
Section titled “When to use”- You need to agree, in writing, on the few metrics that show whether an objective is being met - and exactly how each is calculated.
- Metrics are disputed across teams (“our number says X, yours says Y”) and you need locked definitions.
- Someone other than the author will build the live dashboard, and needs a spec to build from.
- You want a standing monitoring instrument for progress toward objectives, reviewed on a cadence.
When NOT to use
Section titled “When NOT to use”- You are choosing objectives, not monitoring them. That is OKRs (the objective and its key results). The dashboard monitors the KPIs; it does not set the direction. Use both, in sequence.
- You want a periodic snapshot against targets, not live monitoring. That is a scorecard. A dashboard monitors current state; a scorecard compares actual to target at a point in time.
- You are reporting project status. That is a status report (completion against a plan), not an ongoing performance monitor.
- You have no objective to measure against. A dashboard with no objective above it is a pile of numbers. Name the objective first, or you are collecting vanity metrics.
Dashboard, OKRs, scorecard, or risk register? (the question people actually have)
Section titled “Dashboard, OKRs, scorecard, or risk register? (the question people actually have)”| KPI dashboard | OKRs | Scorecard | Risk register | |
|---|---|---|---|---|
| Answers | “How are we doing, live?” | “Where are we going, by when?” | “Above or below target, this period?” | “What could stop us?” |
| Direction | Monitors progress | Sets direction | Compares to target | Tracks threats |
| Cadence | Continuous | Quarterly | Periodic snapshot | Weekly-to-quarterly |
| In this family | this bundle | (strategy-docs) | (a dashboard variant) | risk-register |
The dashboard and the risk register are governance siblings: the dashboard tracks progress toward objectives, the register tracks threats to them. Read them together - a green dashboard beside an unreviewed register is a program performing today while accumulating exposure for tomorrow.
Pick a variant
Section titled “Pick a variant”- Lean (default): Purpose and Audience, KPIs, Review and Ownership. Enough for one team to agree what it watches and act on it.
- Full: adds Metric Definitions (formula, inclusions/exclusions, owner and data steward), Layout and Thresholds (RAG bands and escalation), and Data Sources and Refresh. Use it when the dashboard feeds governance, when teams must agree what a metric means, or when someone else builds it on a BI platform.
Grow lean into full by adding sections; never reorder the shared three. The scaling signal is stakes and audience, not the number of charts.
Quality rubric (self-grade)
Section titled “Quality rubric (self-grade)”- The dashboard names the objective it monitors and the audience it serves.
- Every row is a KPI (a metric paired with an objective and a target), not a bare metric.
- Metrics are actionable: for each, “if it moved, we would do X.” No vanity numbers.
- The list is short (under ten; 5-9 on any one view), not thirty metrics of noise.
- Each KPI is marked leading or lagging, and headline lagging targets are paired with leading indicators.
- Every KPI has one named owner.
- There is a stated review cadence and the last-reviewed date is current.
- (Full) Each KPI has a locked definition with inclusions/exclusions, formula, grain, and a data steward distinct from the owner.
- (Full) RAG thresholds are defined numerically, with an escalation rule when a metric is red.
- (Full) Each metric names an automated source of record; nothing critical is entered by hand.
- The dashboard is read beside the risk register, and an all-green dashboard is treated with suspicion.
Named anti-patterns (the usual wrecks)
Section titled “Named anti-patterns (the usual wrecks)”- The vanity dashboard. Numbers that go up and to the right but guide no decision. Fix: keep only metrics that change what you do.
- The gamed metric (Goodhart). A KPI that became a target and is now optimized directly, decoupled from the outcome. Fix: pair lagging targets with leading indicators; watch for the metric improving while the outcome does not.
- The ambiguous metric. No locked definition, so every team has its own number and reviews argue about data. Fix: define inclusions/exclusions, formula, grain, and source.
- Dashboard bloat. Thirty metrics on one view. Fix: a three-tier hierarchy (headline / supporting / drill-down).
- The orphaned metric. No owner, so no one can act when it moves. Fix: one named owner per KPI, distinct from the data steward.
- The all-green dashboard. Every metric green, because the targets are soft or the risks are tracked nowhere. Fix: honest targets, and read it beside the risk register.
No paired skill (yet)
Section titled “No paired skill (yet)”There is no deliver-kpi-dashboard or govern-kpi-dashboard skill in the product-on-purpose org today,
so this bundle’s pairs_with is empty. Until one exists, this template is filled by hand.
The artifacts
Section titled “The artifacts”kpi-dashboard_template-lean.md · ~1,750 tokens
---title: "{{dashboard_name}} KPI Dashboard"monitors: "{{objective_or_program}}"audience: "{{audience_tier}}"dashboard_owner: "{{dashboard_owner}}"last_reviewed: "{{date}}"review_cadence: "{{cadence}}"status: "{{status}}"doc_type: kpi-dashboardsize: leansource_template: kpi-dashboardsource_template_version: 0.1.0---
<!--LEAN KPI DASHBOARD SPECIFICATION. The smallest real dashboard spec: what objective it monitors and for whom,the KPIs themselves (each a metric paired with an objective and target), and the cadence that keeps it alive.Use it for one team to agree on what it watches and act on it. To grow it into a governance-grade spec (seekpi-dashboard_template-full.md), ADD sections; never rename or reorder the ones below, because the fullvariant is a strict superset of this one.
THIS IS A DASHBOARD DEFINITION, NOT A LIVE TOOL. It specifies which metrics matter, how each is measured, thetarget, the owner, and the cadence - platform-agnostic. It precedes and outlives the build in Tableau,Looker, Power BI, or Amplitude. Write the definition first: if a metric's meaning is unclear, it is useless.See kpi-dashboard_companion.md section 1.
A KPI IS NOT JUST ANY METRIC. A metric becomes a KPI when it is paired with a specific business objective anda target. Keep the list short (fewer than ten). Prefer ACTIONABLE metrics - ones that change what you do -over VANITY metrics that feel good but guide no decision. See kpi-dashboard_companion.md sections 3 and 6.
BEWARE GOODHART'S LAW. "When a measure becomes a target, it ceases to be a good measure." A KPI undertarget-pressure gets gamed. Pair headline (lagging) targets with leading indicators, and treat an all-greendashboard with suspicion, not relief. See kpi-dashboard_companion.md section 6.
HOW TO FILL THIS IN1. Read the comment under each heading: WHAT it wants, WHY it matters (with a companion pointer), guiding questions to ASK, a GOOD and a WEAK example, and the TRAP to avoid. Tables add PRIORITY and ROW HINT.2. Replace each {{placeholder}}. Give every KPI a target and one named owner.3. If a section does not apply, write "N/A" and one line of why, rather than deleting it.4. Never finished, but before you share it: self-grade against kpi-dashboard_guide.md, then DELETE every HTML comment.-->
# {{dashboard_name}} KPI Dashboard
## Purpose and Audience
<!-- WHAT What objective this dashboard monitors, who reads it (audience tier), and the review cadence. One short block. WHY The audience determines everything downstream: an executive dashboard is 3-5 headline metrics, an operational one is dozens refreshed in minutes, an analytical one is for data-literate users. Name the objective the metrics serve, or the dashboard is a pile of numbers. Deep dive: kpi-dashboard_companion.md section 3 (Purpose and Audience). ASK What objective or program does this monitor? Who is the audience (executive / operational / analytical)? How often is it reviewed, and by whom? GOOD "Monitors progress toward the Reporting Platform Modernization program's value goal (cut Time to Insight 30% by Q3). Audience: the program steering group (strategic). Reviewed monthly; owned by the program manager." WEAK "A dashboard of our metrics." (no objective, no audience, no cadence; nothing to judge the metrics against) TRAP Building for "everyone." A dashboard that serves executives and analysts at once serves neither; pick the audience and design for it. -->
{{purpose_and_audience}}
## KPIs
<!-- WHAT The key performance indicators, one row each: name, a one-line definition, the target, the current value, the trend, whether it is leading or lagging, and the owner. WHY This is the dashboard. A KPI is a metric paired with an objective and a target - not every metric qualifies. SMART (specific, measurable, achievable, relevant, time-bound) is the quality bar. Mark leading vs lagging: leading indicators can be acted on; lagging ones only confirm the past. Deep dive: kpi-dashboard_companion.md section 3 (KPIs). ASK For each KPI: what is measured (in one line)? What is the target, and by when? What is the current value and trend? Is it leading (predictive, actionable) or lagging (confirms past)? Who owns it? PRIORITY Keep it short (under ten; 5-9 is what the eye holds). Order by importance, headline metrics first. Owner is one named person. Every KPI has a target - a metric with no target is not a KPI. ROW HINT A good row is a SMART, actionable metric with a target and an owner. A weak row is a vanity number (goes up, guides no decision) or a metric with no target. GOOD | Time to Insight | Median minutes from opening a report to acting | -30% vs baseline by Q3 | -18% | improving | leading | Priya Nair | WEAK | Page views | Total report page views | (no target, no objective; a vanity metric) | 2.1M | up | | | TRAP Vanity metrics and metric bloat. Ask of every row: "if this moved, what would we do differently?" If the answer is nothing, it does not belong. Thirty metrics is not a dashboard; it is noise. -->
| KPI | Definition (one line) | Target | Current | Trend | Lead/Lag | Owner ||---|---|---|---|---|---|---|| {{kpi_name}} | {{definition}} | {{target}} | {{current}} | {{trend}} | {{lead_lag}} | {{owner}} |
## Review and Ownership
<!-- WHAT How often the dashboard is reviewed, who owns it, and what happens when a metric turns red. A few lines. WHY A dashboard is an instrument for a review meeting; the meeting is where value is created or lost. An exception-driven review (discuss what moved, not every green metric) plus a clear escalation when a metric goes red is what keeps the dashboard a decision tool, not wallpaper. Deep dive: kpi-dashboard_companion.md section 3 (Review and Ownership). ASK How often is the dashboard reviewed, and by whom? Is the review exception-driven (focus on what changed)? Who owns the dashboard overall? What action triggers when a KPI turns red? GOOD "Reviewed monthly by the steering group, exception-driven (owners speak only to metrics off-target or off-trend). The program manager owns the dashboard; each KPI has a named owner. A red KPI gets a root-cause and an action item at the review. Last reviewed 2026-07-20." WEAK "Reviewed periodically." (no cadence, no owner, no escalation; the dashboard becomes wallpaper) TRAP A review where every metric is green and everyone nods. The most dangerous dashboard is the one that is all green; either the targets are too soft or the risks are tracked nowhere. Read it beside the risk register. -->
{{review_and_ownership}}kpi-dashboard_template-full.md · ~3,050 tokens
---title: "{{dashboard_name}} KPI Dashboard"monitors: "{{objective_or_program}}"audience: "{{audience_tier}}"dashboard_owner: "{{dashboard_owner}}"last_reviewed: "{{date}}"review_cadence: "{{cadence}}"status: "{{status}}"doc_type: kpi-dashboardsize: fullsource_template: kpi-dashboardsource_template_version: 0.1.0---
<!--FULL KPI DASHBOARD SPECIFICATION. The governance-grade spec: everything in the lean variant, plus a detailedMetric Definitions section (formula, inclusions/exclusions, owner and data steward), a Layout and Thresholdssection (RAG bands and escalation), and a Data Sources and Refresh section. Use it when the dashboard feedsgovernance, when multiple teams must agree what a metric means, or when someone other than the author willbuild it on a BI platform.
This is a STRICT SUPERSET of kpi-dashboard_template-lean.md: Purpose and Audience, KPIs, and Review andOwnership appear in the same relative order; full only inserts the three detail sections. If you are growingfrom lean, add them; do not reorder.
THIS IS A DASHBOARD DEFINITION, NOT A LIVE TOOL. Platform-agnostic; it precedes and outlives the Tableau /Looker / Power BI / Amplitude build. The Metric Definitions section is the point of the full variant: withoutlocked definitions, every dashboard becomes a new version of the truth, and governance meetings drift intoarguments about data quality rather than action. See kpi-dashboard_companion.md sections 1 and 3.
A KPI IS NOT JUST ANY METRIC (paired with an objective and target). Prefer ACTIONABLE over VANITY metrics.BEWARE GOODHART'S LAW ("when a measure becomes a target, it ceases to be a good measure") - pair laggingtargets with leading indicators, and treat an all-green dashboard with suspicion. See kpi-dashboard_companion.mdsections 3 and 6.
HOW TO FILL THIS IN1. Read the comment under each heading: WHAT, WHY (with a companion pointer), ASK, GOOD, WEAK, TRAP; tables add PRIORITY and ROW HINT.2. Replace each {{placeholder}}. Every KPI has a target, one named owner, and (in Metric Definitions) a data steward and a locked formula.3. If a section does not apply, write "N/A" and one line of why, rather than deleting it.4. Never finished, but before you share it: self-grade against kpi-dashboard_guide.md, then DELETE every HTML comment.-->
# {{dashboard_name}} KPI Dashboard
## Purpose and Audience
<!-- WHAT What objective this dashboard monitors, the audience tier, the review cadence, and its relationship to the live BI implementation. WHY The audience determines metric count, refresh rate, and depth. At governance scale, also state that this is the spec (the source of truth for what each metric means) and where it is implemented. Deep dive: kpi-dashboard_companion.md section 3 (Purpose and Audience) and section 8 (vs the BI tool). ASK What objective does this monitor? Audience (executive / operational / analytical)? Cadence? Which BI platform implements it, and who keeps the implementation in sync with this spec? GOOD "Monitors progress toward the Reporting Platform Modernization program's value goal (cut Time to Insight 30% by Q3). Audience: program steering group (strategic). Reviewed monthly. This document is the metric source of truth; implemented in the Acme BI workspace (Amplitude + Looker)." WEAK "Program metrics dashboard." (no objective, audience, cadence, or implementation link) TRAP Letting the spec and the live dashboard drift. This document defines the metrics; the BI tool renders them. When they disagree, this document wins - so keep it current. -->
{{purpose_and_audience}}
## KPIs
<!-- WHAT The key performance indicators, one row each: name, one-line definition, target, current, trend, lead/lag, and owner. The summary view; the detailed definitions are the next section. WHY A KPI is a metric paired with an objective and target; SMART is the quality bar. Keep it short (5-9). Mark leading vs lagging so the dashboard shows both what you can act on now and what you can only confirm later. Deep dive: kpi-dashboard_companion.md section 3 (KPIs). ASK For each KPI: one-line definition? target and by when? current and trend? leading or lagging? owner? PRIORITY Under ten; headline metrics first. Every KPI has a target. Owner is one named person. The full definition (formula, inclusions/exclusions) lives in Metric Definitions below, linked by name. ROW HINT A good row is a SMART, actionable metric with a target and an owner. A weak row is a vanity number or a metric with no target. GOOD | Time to Insight | Median minutes from opening a report to acting | -30% vs baseline by Q3 | -18% | improving | leading | Priya Nair | WEAK | Page views | Total report page views | (no target; vanity) | 2.1M | up | | | TRAP Metric bloat and vanity. Ask of each: "if this moved, what would we do?" If nothing, cut it. -->
| KPI | Definition (one line) | Target | Current | Trend | Lead/Lag | Owner ||---|---|---|---|---|---|---|| {{kpi_name}} | {{definition}} | {{target}} | {{current}} | {{trend}} | {{lead_lag}} | {{owner}} |
## Metric Definitions
<!-- WHAT The detailed definition record for each KPI: exact formula (numerator/denominator), inclusions and exclusions, grain and time window, leading/lagging, known limitations, the owner, and the data steward. WHY This is the anti-ambiguity layer and the point of the full variant. The most dispute-generating omission is inclusions/exclusions. Without locked definitions, every dashboard becomes a new version of the truth. The owner is accountable for performance and interpretation; the data steward for data integrity - two distinct roles. Deep dive: kpi-dashboard_companion.md section 3 (Metric Definitions). ASK For each KPI: exact formula? What is included and excluded (the critical part)? What grain and time window? Leading or lagging? Known limitations or edge cases? Owner and data steward? ROW HINT A good definition is one another team could compute the same number from. A weak one is a name with no formula, so two teams produce two numbers and the review argues about which is right. GOOD "Saved Views adoption = (distinct Recurring Analysts who used a saved view in the trailing 7 days) / (all Recurring Analysts). Includes: analysts active in the period. Excludes: trialists, internal test accounts. Grain: per analyst, trailing-7-day. Lagging. Limitation: a shared view counts for the viewer, not the creator. Owner: Priya Nair. Data steward: Lee Zhang (Data Eng)." WEAK "Adoption: how many people use saved views." (no formula, no inclusions/exclusions; ungovernable) TRAP Skipping inclusions/exclusions. "Active users" means five different things until you say whether a trialist counts. The undefined edge case is where every metric dispute starts. -->
{{metric_definitions}}
## Layout and Thresholds
<!-- WHAT The visual specification: the layout (which metrics go where, for which audience), the chart type per metric, the red/yellow/green threshold bands, and the escalation rule when a metric turns red. WHY Most KPI dashboards fail on design, not data. Color means status, not decoration; a consistent RAG scheme plus a stated escalation turns metrics into actionable responsibilities. A three-tier layout (headline / supporting / drill-down) keeps any one view within what the eye can hold. Deep dive: kpi-dashboard_companion.md section 3 (Layout and Thresholds). ASK What is the layout (headline metrics, supporting, drill-down)? Chart type per metric (line for trend, bar for comparison, gauge for status)? RAG threshold bands per KPI? Who is escalated to when a metric is red, and how fast? PRIORITY One row per KPI, in the same order as the KPIs table (headline metrics first). Every KPI on the dashboard needs a band and an escalation - do not leave any KPI unthresholded. ROW HINT A good threshold row states the metric, the green/amber/red bands, and the escalation. A weak one colors a metric red with no band definition and no action. GOOD "Time to Insight: green >=25% improvement, amber 10-25%, red <10%. Line chart, trailing 6 months with target line. Red escalates to the steering group within one week with a root-cause. Layout: Time to Insight and Adoption headline; performance and engagement supporting; the rest drill-down." WEAK "Use red/yellow/green." (no bands defined, no escalation, no layout; color becomes decoration) TRAP Coloring without defined bands. "Red" that anyone can argue into "amber" is theater; state the numeric band and the action it triggers. -->
{{layout_and_thresholds}}
## Data Sources and Refresh
<!-- WHAT The system of record for each metric, its refresh cadence and latency, and the non-approved sources to avoid. WHY A dashboard with an undocumented or manual source rots: a dashboard that requires manual data entry has an expiration date. Naming the approved source (and the ones NOT to use) is what makes "single source of truth" a governance decision rather than a slogan. Deep dive: kpi-dashboard_companion.md section 3 (Data Sources and Refresh). ASK For each metric: what is the approved system of record? How is it refreshed (automated feed? how often? what latency)? Are there tempting non-approved sources to explicitly rule out? PRIORITY One row per KPI, same order as the KPIs table. Every KPI needs a named source; a metric with no documented source of record does not belong on the dashboard. ROW HINT A good row names the source, the refresh, and the latency. A weak one says "our database" with no table, pipeline, or cadence. GOOD "Time to Insight: source = product analytics event stream (Amplitude), automated daily refresh, ~6h latency. Do NOT use the marketing dashboard's session metric (different definition of a 'session'). Adoption: source = the entitlements DB, nightly." WEAK "Data comes from our systems." (no source of record, no refresh, no latency; the number is untrustworthy) TRAP A manual refresh. A metric a human copies in by hand will go stale the first busy week and the dashboard will quietly lie. Automate the feed or mark the metric as manual and short-lived. -->
{{data_sources_and_refresh}}
## Review and Ownership
<!-- WHAT The review cadence, the dashboard owner, the audience-appropriate review, and what happens when a metric is red. WHY The dashboard is an instrument for a review meeting; exception-driven reviews (discuss what moved, not every green) and a clear red-metric escalation keep it a decision tool. Discuss inputs, not just outputs - output metrics lag the inputs you can actually act on. Deep dive: kpi-dashboard_companion.md section 3 (Review and Ownership) and section 6. ASK How often is the dashboard reviewed, by whom? Is it exception-driven? Who owns it? What triggers when a KPI is red? Do owners come prepared to explain inputs, not just report outputs? GOOD "Reviewed monthly by the steering group, exception-driven; owners speak to metrics off-target or off-trend and come prepared with the input metrics behind them. The program manager owns the dashboard; each KPI has a named owner. A red KPI gets a root-cause and an action item. Last reviewed 2026-07-20." WEAK "Reviewed at meetings." (no cadence, owner, or escalation) TRAP A status-theater review where every metric is green and no decision is made. The most dangerous dashboard is all green; read it beside the risk register, and if nothing is ever red, question the targets. -->
{{review_and_ownership}}---title: "Acme Analytics - Reporting Platform Modernization KPI Dashboard"monitors: "Reporting Platform Modernization program (value goal: cut Time to Insight 30% by Q3)"audience: "Program steering group (strategic)"dashboard_owner: "Marta Reyes (Program Manager)"last_reviewed: "2026-07-20"review_cadence: "Monthly, exception-driven, at the program steering review"status: activerelated: ["../risk-register/risk-register_example.md (the program risk register; tracks threats to these outcomes)", "../raid-log/raid-log_example.md (the program RAID log; tracks open items behind these outcomes)", "../prd/prd_example.md (Saved Views for Dashboards PRD, where the Time to Insight goal is set)"]doc_type: kpi-dashboardsize: fullsource_template: kpi-dashboardsource_template_version: 0.1.0---
<!--This is a worked example for the kpi-dashboard bundle: a realistic, fully filled full-variant KPI dashboardSPECIFICATION (not a live BI tool) for the same Acme Analytics Reporting Platform Modernization program thatthe risk-register and raid-log examples cover. It closes the governance-docs family loop:- the risk register tracks THREATS to the program's objectives;- the RAID log tracks OPEN ITEMS (risks, assumptions, issues, dependencies) behind them;- this dashboard tracks whether the delivered program actually WORKS.The cross-links are deliberate: Saved Views adoption is the outcome the register's R-04 adoption riskthreatens and the RAID log's A-02 assumption underlies; view-list load is the metric the RAID log's ISS-12issue (from register risk R-06) moved.
All figures, targets, dates, and names are illustrative. This is a snapshot as of the last-reviewed date. Useit as a model of shape, definition discipline, and tone, not as a source of facts about real products.-->
# Acme Analytics - Reporting Platform Modernization KPI Dashboard
## Purpose and Audience
Monitors **progress toward the Reporting Platform Modernization program's value goal**: cut the median Time toInsight for Recurring Analysts by 30% by the end of Q3. The program set that target; the[Saved Views PRD](../prd/prd_example.md) tracks the same metric but deliberately leaves its magnitude "to beset with the data team", so this dashboard is where the number lives. **Audience:** the program steering group(strategic tier) - a handful of headline metrics, reviewed monthly. Owned by the program manager(Marta Reyes).
**This document is the metric source of truth**; the live dashboard is implemented in the Acme BI workspace(Amplitude for product events, Looker for the executive view). Where the live dashboard and this specdisagree, this spec wins. It is read **beside the [risk register](../risk-register/risk-register_example.md)**:this dashboard shows whether the program is working; the register shows what could stop it.
## KPIs
Headline first. *(Illustrative.)*
| KPI | Definition (one line) | Target | Current | Trend | Lead/Lag | Owner ||---|---|---|---|---|---|---|| Time to Insight | Median minutes from opening a report to taking a logged action | -30% vs baseline by Q3 | -18% | improving | lagging | Priya Nair || Saved Views adoption | Share of Recurring Analysts using a saved view weekly | 60% by end Q3 | 41% | improving | leading | Priya Nair || View-list load (p95) | 95th-percentile time to render a dashboard's saved-view list | < 500ms | 620ms (staging, pre-launch) | declining | leading | Dana Osei || Weekly active analysts | Distinct Recurring Analysts active in the trailing 7 days | Hold >= 480 | 495 | stable | lagging | Priya Nair || Migration integrity | Share of legacy saved-view configs reconciled post-cutover | 100% at cutover | n/a (pre-cutover) | n/a | leading | Lee Zhang |
## Metric Definitions
Locked definitions - another team should compute the same number from these. *(Illustrative.)*
**Time to Insight.** Formula: median over the period of (timestamp of first logged action on a report -timestamp the report was opened), in minutes, per analyst-session. **Includes:** Recurring Analysts (thesegment the program targets); sessions with at least one report opened. **Excludes:** trialists, internal testaccounts, sessions with no report opened. **Grain:** per analyst-session, reported as a monthly median.**Lagging** (the program's headline outcome; a monthly median confirms whether the delivered feature improvedanalyst efficiency, and by the time it is read the period is over - its leading drivers are adoption andperformance below). **Known limitation:** "action" is proxied by a set of logged events (export, share,annotate); a purely visual read that changes a decision is not captured. **Owner:** Priya Nair. **Datasteward:** Lee Zhang (Data Eng).
**Saved Views adoption.** Formula: (distinct Recurring Analysts who used a saved view in the trailing 7 days)/ (all Recurring Analysts). **Includes:** analysts active in the period. **Excludes:** trialists, internalaccounts. **Grain:** per analyst, trailing-7-day, reported monthly. **Leading** (a behavioral input that predicts theTime-to-Insight outcome: if adoption rises, Time to Insight should follow). **Known limitation:** a sharedview counts for the viewer, not the creator, so heavy sharing can understate creator adoption. **Owner:**Priya Nair. **Data steward:** Lee Zhang. *(This is the outcome the[register's R-04 adoption risk](../risk-register/risk-register_example.md) threatens and the[RAID log's A-02 assumption](../raid-log/raid-log_example.md) rests on.)*
**View-list load (p95).** Formula: 95th percentile of the client-measured time from view-list request torender, in milliseconds. **Includes:** production sessions. **Excludes:** synthetic monitoring traffic.**Grain:** per request, p95 over a trailing 24 hours. **Leading** (a degradation predicts the adoption andTime-to-Insight risk before they move). **Known limitation:** client-measured, so it includes network timeoutside Acme's control. **Owner:** Dana Osei. **Data steward:** Lee Zhang (Data Eng). **Until launch** there areno production sessions of the new view list to measure, so the current value is the staging load-test figure,labelled as such, and production RUM replaces it at launch. *(This is the metric the[RAID log's ISS-12](../raid-log/raid-log_example.md), which materialized from register risk R-06, moved.)*
**Weekly active analysts.** Formula: count of distinct Recurring Analysts with at least one report session inthe trailing 7 days. **Includes:** the Recurring Analyst segment. **Excludes:** trialists, internal accounts,service accounts. **Grain:** per analyst, trailing-7-day, reported weekly. **Lagging** (an engagement outcome;a guardrail that the program is not driving analysts away). **Known limitation:** multi-device use isde-duplicated on analyst identity, not device, so a shared login understates the count. **Owner:** Priya Nair.**Data steward:** Lee Zhang (Data Eng).
**Migration integrity.** Formula: (count of legacy saved-view configs reconciled against the new schema) /(count of legacy configs in scope), as a percentage. **Includes:** all in-scope legacy configs at cutover.**Excludes:** configs already deleted by their owners pre-migration. **Grain:** whole-migration, measured atthe cutover dry-run and at cutover. **Leading** (a cutover-quality gate: a shortfall predicts the data-lossrisk R-02 materializing). **Known limitation:** reconciliation matches on config ID and field count, notsemantic equivalence of every field. **Owner:** Lee Zhang. **Data steward:** Lee Zhang (Data Eng). *(Gates the[register's R-02 data-loss risk](../risk-register/risk-register_example.md).)*
## Layout and Thresholds
RAG bands are set to the program's targets, not a generic scale. *(Illustrative.)*
| KPI | Green | Amber | Red | Chart | Escalation when red ||---|---|---|---|---|---|| Time to Insight | >= 25% improvement | 10-25% | < 10% | Line, trailing 6 months + target line | Steering group within 1 week, with root-cause || Saved Views adoption | >= 55% | 40-55% | < 40% | Line, trailing 6 months | Product review; feeds the R-04 mitigation || View-list load (p95) | < 500ms | 500-700ms | > 700ms | Line, trailing 30 days | Eng on-call same day (currently amber at 620ms) || Weekly active analysts | >= 480 | 460-479 | < 460 | Sparkline, trailing 30 days | Product review within 1 week (guardrail metric) || Migration integrity | 100% | n/a | < 100% | Single-value tile, cutover window only | Lee Zhang same day, with a reconciliation report |
**Layout:** Time to Insight and Saved Views adoption are the two headline panels; view-list load and weeklyactive analysts are supporting; migration integrity is a cutover-window panel, hidden afterward. Everythingelse (per-segment breakdowns) is drill-down.
## Data Sources and Refresh
*(Illustrative.)*
| KPI | Source of record | Refresh | Latency | Do NOT use ||---|---|---|---|---|| Time to Insight | Product analytics event stream (Amplitude) | Automated daily | ~6h | The marketing "engagement" metric (different "session" definition) || Saved Views adoption | Entitlements DB + event stream | Automated nightly | ~12h | Manual pilot spreadsheet (pilot-only; not the full segment) || View-list load (p95) | Front-end RUM pipeline from launch; the staging load test until then, labelled | Automated hourly | ~1h | Staging numbers presented as production || Weekly active analysts | Entitlements DB + event stream (same pipeline as adoption) | Automated nightly | ~12h | The raw session log (double-counts multi-device) || Migration integrity | Migration reconciliation script output (the R-02 dual-write reconciler) | Automated per dry-run and at cutover | minutes | Manual spot-checks (not exhaustive) |
No headline metric is entered by hand: an automated feed is a condition of a metric appearing on thisdashboard.
## Review and Ownership
Reviewed **monthly** by the program steering group, **exception-driven**: owners speak only to metrics thatare off-target or off-trend, and come prepared with the **input metrics** behind them, not just the headlinenumber. The program manager owns the dashboard; each KPI has a named owner. A **red** KPI gets a root-causeand an action item at the review.
The dashboard is read **beside the [risk register](../risk-register/risk-register_example.md)**: by the bandsabove, Time to Insight (-18% vs the 25% green line) and Saved Views adoption (41% vs the 55% green line) areboth **amber and improving**, view-list load is amber, and the register still carries the adoption risk (R-04)and the PII risk (R-05) as open threats. This is exactly the picture the family is built to show - amberheadline metrics trending the right way while real risks stay live - and an all-green dashboard here would betreated with suspicion, not relief. Last reviewed **2026-07-20**; next review **2026-08-17**.
*(All KPIs, targets, figures, and names are illustrative.)*Provenance
Section titled “Provenance”The reasoning, the history and every source, in the repository:
- Companion - the long-form argument: why these sections, where the sources disagree, and what the bundle refuses to claim
- History - what changed in this bundle, and when
- Research log - every source consulted, with what each one actually supports
- Catalog metadata - the machine-readable record this page is generated from
Catalog record: 6 sections across 1 format(s), methodology methodology-agnostic, typically owned by PM / Data Analyst.