Analytics

Write the definition before drawing the chart

Editorial edition · 16 November 2026

The idea

A metric is a rule for counting or calculating, not merely a label on a dashboard. People can use the same name for different populations, time windows or exclusions. A written definition makes comparisons possible and reduces arguments that are really about meaning.

Design choice

Specify the numerator, denominator, time basis and eligibility rules. Give the definition an owner and a version. When the rule changes, decide whether history is recalculated or the chart needs a visible break.

Worked example

Two teams count active users differently: one counts sign-ins, the other completed tasks. The comparison becomes useful only after the activity and reporting window are aligned.

Before you ship

  • Define population and time window
  • Version changes to the formula
  • Show the definition near the chart

Examples are illustrative. Adapt the checks to your own environment.

Further reading

OpenTelemetry metrics

Search the library