Live Metrics
Last updated: 2026-07-17
Metrics let you show a stored numeric value on your status page — like requests served today, active users, or deploys shipped this week — without it affecting your operational status, incidents, uptime, or subscriber notifications.
What Metrics Are (and Aren’t)
Metrics are simple, standalone numbers you control. They are:
- Independent of components — a metric has no health state and never triggers a degraded/down badge
- Independent of incidents and maintenances
- Independent of uptime and monitor availability calculations
- Not part of subscriber notifications — changing a metric never emails or messages anyone
Metrics are not a telemetry or analytics pipeline. There’s no history graph, no alerting on thresholds, and no webhook that fires when a value changes. Think of them as a manually or programmatically updated counter or gauge, not a monitoring feature.
Accessing Metrics
- Go to Metrics in the left dashboard menu
- Select the status page you want to manage from the Status page dropdown at the top
Only status pages you have full manage access to (the same access level required to manage components) appear in the dropdown.
Creating a Metric
- Click Add metric
- Enter a Name (e.g., “Requests served today”)
- Enter an Initial value
- Optionally pick an Icon from the searchable Bootstrap Icons picker
- Optionally set a Unit or suffix (e.g., “req/s”, “GB”, “%”)
- Click Add metric
New metrics are appended to the end of your metrics list and appear on your public status page immediately.
Values and Formatting
- Values support up to three decimal places
- Trailing zeros are trimmed for display, so
12.500is shown as12.5 - Values can be negative (e.g., a counter that goes up or down)
Updating a Metric’s Value
Each metric card has quick actions:
| Action | Effect |
|---|---|
Set value (123 icon) | Replace the current value with a new one you type in |
| Reset | Set the value back to 0 |
Value changes take effect immediately on your public status page — there’s no publish step.
For programmatic updates (from a CI pipeline, a cron job, or your own backend), see Metrics API.
Editing a Metric
Click the pencil icon on a metric card to change its Name, Icon, or Unit or suffix. This does not change the current value — use Set value for that.
Deleting a Metric
Click the trash icon on a metric card and confirm. Deleting a metric removes it from your status page permanently; there’s no history to preserve.
Where Metrics Appear on Your Status Page
Metrics render in a Live metrics section on your public status page, separate from your components list. Each metric shows its icon (if set), name, and current value with its unit or suffix.
Permissions
Managing metrics requires the same full manage access as managing components and component groups. If your access to a status page is restricted to specific component groups, you won’t see that page in the Metrics dropdown.
What’s Next?
- Metrics API — update metric values programmatically
- Managing Components and Component Groups
- Status Page Settings Guide
- Spotlight Layout Mode — see how metrics look in the centered Spotlight layout