Monitors¶
A monitor is a threshold alert on one of your charts. It watches a single value — cash on hand, outstanding AR, error rate, whatever a chart measures — and notifies you the moment that value crosses your threshold, so you don't have to keep checking the dashboard yourself.
What you can do¶
- Put an alert on any saved chart. Point a monitor at one of your charts (a saved metric/chart artifact), give it a title, and pick the value to watch — leave the measure column blank to track the chart's headline number (its metric scalar).
- Set a threshold and a comparator. Choose greater than, at least, less than, at most, equals, or not equal, and enter the threshold value. Ordering comparators work on numbers; equals/not equal also work on text (for status-style values).
- Get notified only when it matters. A monitor is edge-triggered: it alerts once when the value crosses from clear → breached, not every time it evaluates. When the value returns to clear, the monitor re-arms so the next breach alerts again — no repeated noise for a sustained problem.
- Evaluate on demand. Hit Evaluate now any time to run the check immediately and see the result: Breached or Clear — within threshold, the measured value, and whether an alert fired.
- Schedule background checks (optional). Add an eval cron (e.g.
0 9 * * *) to have it swept automatically where scheduled evaluation is enabled; leave it blank to evaluate manually only. - Pause, re-enable, or delete. Pause a monitor to stop it firing while keeping its history, re-enable it later, or remove it entirely.
- See state at a glance. Each monitor shows a badge — new (never evaluated), breached, clear, or off — and a detail pane with its rule, last state, last value, last evaluated, and last fired times.
How alerts fire¶
Monitors are owner-private: the ones in your list are yours, and the alert goes to you (the monitor's owner) with the title, the comparator, your threshold, and the measured value. Because alerts fire on the clear→breach transition, a value that stays over the line notifies you once — not on every evaluation — and a dip back under the threshold re-arms it.
Example: alert when AR outstanding tops $50k¶
Every new workspace ships with a sample monitor — "Sample — AR outstanding over $50k" — already showing a red breached badge over the demo data, so you can see the feature working before building your own. To make one:
- Open Monitors and click New monitor.
- Pick your Total outstanding (USD) chart and title it "AR aging breach."
- Leave Measure column blank to watch the chart's headline number.
- Choose > greater than and set the Threshold to
50000. Optionally add an Eval cron like0 9 * * *. - Click Create monitor, then Evaluate now — you'll see Breached · measured value · alert fired. When AR later drops below $50k the monitor re-arms for the next breach.
Related: monitors watch the charts you build in Dashboards (and the reusable Artifacts behind them).