Appearance
New or edit an alert rule
Also known as
- New KPI alert rule
- create alert
- threshold
- kpi
- alert condition
- percentage change
- notify by email
- alert recipients
- test alert
- edit alert rule
An alert rule names a KPI, the condition that should raise an alert, how often to check it and whom to notify. Use Test now to see whether the rule would fire before you save it.
Create an alert rule
- Open AnalyticsKPI alerts and select New alert rule, or press Ctrl K and choose New KPI alert rule.
- Under Rule, type a Name and choose the KPI.
- Under Condition, choose what to Compare:
- The value against a threshold: choose Alert when the KPI is Above, At or above, Below or At or below, and type the Threshold.
- The change against the previous period: choose Rises by at least, Falls by at least or Changes by at least, and type the Change (%).
- Select Test now. The line next to it says Would fire now or Would not fire now, with the current value. Nothing is saved or sent.
- Under Schedule, choose Check (Every hour or Once a day) and, for daily checks, At (an hour in the workspace time zone).
- Under Notify, choose the People, Roles and Other email addresses to tell.
- Select Create rule. The rule is active and waits for its first check.
To change a rule, open it and select Edit; then select Save rule. Changing the KPI, the comparison, the condition, the threshold or the period resets the state to Pending.
Fields
| Field | What to enter | Required / default |
|---|---|---|
| Name | A name people recognise in notifications. | Required |
| KPI | The KPI to watch. Message: Choose a KPI. | Required |
| Description | Why the rule exists. | Optional |
| Compare | The value against a threshold or The change against the previous period. | Threshold |
| Alert when the KPI | The operator. A threshold needs above or below (Choose above or below.); a change needs a direction (Choose increase, decrease or either.). | Above |
| Threshold / Change (%) | The limit in the KPI's unit, or a positive percentage (Use a positive percentage.). | Required |
| KPI period | Optional period passed to the KPI, for example mtd or 2026-09. | Default |
| Check | Every hour or Once a day. | Once a day |
| At | The hour of the daily check (Workspace time zone). | 07:00 |
| Repeat while it stays in alert | Notify at every check while the rule stays in alert, not only when it starts. | Off |
| In-app notification | Notify the people and roles in the app. They also get an email unless they turned KPI alert emails off. With nobody selected, the owner is notified. | On |
| People, Roles | Who is notified. | Optional |
| Other email addresses | Addresses outside the app; type one and press Enter. Message: Not an email address. Without in-app notification you must add one (Notify in the app or add at least one address.). | Optional |
A change rule never fires when the KPI has no previous value (or the previous value is zero).
The owner's access
The user who creates the rule is its owner. Checks run with the owner's permissions, so a rule on a finance KPI needs an owner who can see that KPI.
