Alerts
This chapter explains how to be emailed when a chart crosses a threshold you care about, without watching a dashboard for it.
1. Start here: the message you will probably see first
Select Alerts on a new dashboard and you will most likely see this:
No charts on this dashboard have a goal yet. Add a goal to a chart to alert on it.
Nothing is broken. An alert watches a goal line, so a chart without one has nothing to watch. Section 2 sets a goal, and then alerts become available.
Where alerts live. Subscribe and Alerts in the dashboard header both open the same Notifications panel, which has two tabs: Subscriptions and Alerts. Scheduled reports are the first tab, threshold alerts the second. Subscriptions covers the other tab.
2. Setting a goal line
A goal line is a horizontal marker at a value you choose. It is also the threshold an alert fires on.
- On the chart’s card, select the …, then Edit question.
- Open the settings, the gear icon.
- Go to Display.
- Turn Goal line on.
- Set Goal value.
- Select Save, then Save changes.
Pick a value in the range your chart actually reaches. A goal far below your data sits flat on the axis, and one far above sits off the top, and neither tells a reader anything.
The chart now draws a dashed line at your value, labelled Goal, and can carry an alert.
3. Creating an alert
- Select Alerts in the dashboard header.
- The Alerts tab now reads No alerts on this chart yet instead of the goal message.
- Select Add alert.
- Under Chart, choose which chart to watch.
- Give the alert a name.
- Under Alert me when the value, choose Rises above the goal or Drops below the goal.
- Select Add.
There is no threshold to type in. The form explains: “Goal-line alerts email recipients when the chart crosses the goal set on it. There is no threshold to enter here. Set the goal when you edit the chart.” The goal is the threshold, which is why it has to exist first. To alert at a different number, change the goal.
4. When an alert fires
Analytics data refreshes periodically rather than live, and alerts are checked against the refreshed data. An alert therefore fires on the first check after the threshold was crossed, not at the exact moment it happens. That suits trends such as a daily upload count. For anything where minutes matter, use your operational monitoring instead.
5. Managing existing alerts
Alerts and subscriptions are managed from the same place.
On this dashboard. Select Alerts in the header. The panel lists the alerts already on it.
Everywhere. Select Alerts & subscriptions, under Settings at the foot of the dashboard list. That page holds every alert and subscription you have created, across every dashboard, with a filter for Alerts only.
Edit or delete from the Actions on a row.
Worth a look every few months. Alerts outlive the reason they were created, and an alert nobody acts on trains people to ignore the ones that matter.
6. Worked examples
Volume approaching a ceiling. Goal line on documents uploaded per day at the volume you plan for, alert when it goes above. Gives you warning before you hit it.
Validation failures rising. A question counting documents that failed validation in the last seven days, goal line at the count you consider normal, alert when it goes above. Catches a change in an upstream document format early.
7. Good to know
- A chart needs a goal line before it can carry an alert.
- A seat is all you need. If you have a Business Dashboard seat, you can create alerts.