Appearance
KPI alerts
Also known as
- alert rules
- KPI alert
- threshold alert
- notification rule
- watch a KPI
- monitoring
- alerting
- firing alerts
- metric alert
- early warning
KPI alert rules watch a KPI and notify people when it crosses a threshold or changes too much against its previous period. The worker checks each active rule hourly or once a day. This list shows every rule with its current state.
Find a rule
- Open AnalyticsKPI alerts.
- Type in Search rules, or add a filter: Status (Active, Paused), State (Firing, Normal, Not evaluated yet, Error) or Frequency (Hourly, Daily).
- Select a rule to open it. See KPI alert rule.
To create a rule, select New alert rule (needs Permission: analytics.alert.manage) and follow New or edit an alert rule.
Columns
| Column | Meaning |
|---|---|
| Rule, KPI | The rule's name and the KPI it watches. |
| Condition | For example below 50 items or falls by 25% or more vs previous period. |
| State | The rule's state (table below). |
| Last value | The KPI value at the last check. |
| Checked | Hourly or Daily at hh:00 (workspace time zone). |
| Last fired, Owner | When the rule last went into alert (Never if not yet) and who owns it. |
Statuses
A rule has a status (whether it is checked at all) and a state (the result of the last check).
| State shown | Meaning | What happens next |
|---|---|---|
| Pending | Active, not checked yet, or its condition was changed. | The next check moves it to Ok or Triggered. |
| Ok | Within limits at the last check. | Moves to Triggered when the condition is met. |
| Triggered | In alert: the condition was met. Recipients were notified. | Moves back to Ok (a resolved notification) when the KPI is within limits again. |
| Error | The KPI could not be computed. The owner is notified once. | The next successful check moves it on. |
| Paused | Not checked. Keeps its settings. | Resume makes it active again (state Pending). |
See Documents and their states.
Differences by role
- Permission:
analytics.alert.viewshows the rules and their history; Permission:analytics.alert.managecreates, changes, pauses and tests them. - Finance users have both in the demo workspace.
