Skip to content

How Metric Works

Metric checks watch a specific numeric field over time and compare each scan's measurement against configured thresholds. They live under the Metrics tab of the Observability page and each check shows one card with its own chart.

How measurements are captured

Unlike Volumetric and Freshness, Metric measurements are not captured on the hourly sweep. Each measurement is produced by a Profile or Scan operation. That means:

  • A new measurement appears on the chart every time a scan that includes the metric's target field completes.
  • If you have not run enough scans since the check was created, the chart stays empty (see Minimum measurements for chart rendering below).
  • Turning on Volume Tracking or Freshness Tracking has no effect on Metric checks.

Check properties

  • Field. The target field the metric evaluates (for example max_value on a sales table).
  • Comparison. One of Absolute Change, Absolute Value, or Percentage Change. See Comparisons for the semantics of each.
  • Min / Max thresholds. The boundaries used by the selected comparison to decide whether a measurement is within range.
  • Importance. How much weight the check carries when aggregating anomaly signals for the container.
  • Description. A short label so the check reads clearly in the listing.

Minimum measurements for chart rendering

The chart needs a minimum number of recorded measurements before it will render:

Comparison Minimum measurements
Absolute Value 2
Absolute Change 3
Percentage Change 3

If the check has fewer measurements than the minimum, the card shows No measures and the chart stays blank until additional scans record more measurements.

What the chart shows

  • Points. Each point is one scan's measurement, plotted against the field's recorded value.
  • Threshold band. The chart overlays the Min / Max range (or the change delta, depending on comparison type).
  • Out-of-range points. Measurements that fall outside the thresholds are highlighted on the chart line.

Filters, sort, and search on the listing

The Metrics tab supports these controls:

  • Filter: by Tags, by Datastore, by Container, and by Field (the Rule Type filter is not used on this tab because Metric is the only rule type here).
  • Sort by: Importance, Created Date, Active Anomalies.
  • Search: matches the check's description or identifier.

Marking a check as a favorite pins it to the top of the listing; favorites are per-user.