Appearance
KPI alert rule
AnalyticsKPI alertsKPI alert rulePermission:
analytics.alert.viewAlso known as
- alert rule detail
- evaluate now
- pause alert
- resume alert
- acknowledge alert
- alert state
- in alert
- within limits
- last check
- delete alert rule
The rule page shows what the rule watches, its current state on the Evaluation rail, the KPI's value and trend, and every time the rule fired or resolved. From here you check it now, pause it, edit it or delete it.
Read the rule
| Area | What it shows |
|---|---|
| Line under the title | The KPI, the condition (for example below 50 items) and Checked hourly or Checked daily at hh:00. |
| Rule | KPI, Condition, Period, Owner (checks run with this person's access), Notify, Recipients (The owner when none are set), Description. |
| KPI now | The KPI's current value and a trend line of its recent points. |
| History | Each event: When, Event (Triggered, Resolved, Error), Value, Change, Message, Notified (number of people). |
| Evaluation | Waiting for first check, Within limits, In alert; for a paused rule, Active and Paused. A failed check marks the rail as failed. |
| Last check | Last value, Previous and Last checked. The last check failed. shows the error when the KPI could not be computed. |
Check the rule now
- Select Evaluate now.
- A message gives the result: Within limits, The alert fired, The alert resolved, Still in alert or Evaluated with an error.
Unlike Test now on the form, Evaluate now stores the result like a scheduled check: the state changes and, if the rule fires or resolves, the recipients are notified. A paused rule cannot be evaluated (Resume the rule to evaluate it).
Pause or resume a rule
- Select Pause. The rule shows Paused and is no longer checked (message Rule paused).
- To start again, select Resume. The state returns to Pending until the next check.
Acknowledge an alert
In History, select Acknowledge on a Triggered or Error event to show that you have seen it. The row then shows Seen with the time. Resolved events need no acknowledgement.
Edit or delete the rule
- Select Edit to change it. See New or edit an alert rule.
- Select Delete, then Delete rule in the dialog. The rule stops being checked and its alert history is deleted.
Statuses
| Status | Meaning | What you can do next |
|---|---|---|
| Active, Pending | Waiting for the first check after it was created, resumed or its condition changed. | Evaluate now, Pause, Edit |
| Active, Ok | Within limits. | Evaluate now, Pause, Edit |
| Active, Triggered | In alert; recipients notified (again at every check if Repeat while it stays in alert is on). | Acknowledge, Evaluate now, Pause |
| Active, Error | The KPI failed; the owner was notified. | Fix the cause (often the owner's access), Evaluate now |
| Paused | Not checked. | Resume, Edit, Delete |
See Documents and their states.
Differences by role
- Viewing and acknowledging need Permission:
analytics.alert.view. Evaluate now, Pause, Resume, Edit and Delete need Permission:analytics.alert.manage.
