Skip to content
Snippets Groups Projects
Commit c258188a authored by Maz Ameli's avatar Maz Ameli
Browse files

add alerts images [ci skip]

parent 5257c7a1
No related branches found
No related tags found
No related merge requests found
......@@ -20,24 +20,42 @@ To start, you'll need a line, area, or bar chart displaying a number over time.
Now we need to set up a goal line. To do that, open up the visualization settings by clicking the gear icon next to the dropdown where you chose your chart type. Then click on the Display tab, and turn on the "Show goal" setting. Choose a value for your goal and click Done.
Save your question, then click on the menu button in the top right of the screen and click on "Get alerts about this." This is where you'll get to choose a few things:
Save your question, then click on the menu button in the top right of the screen and click on "Get alerts about this."
![Get alerts](./images/alerts/get-alerts-about-this.png)
This is where you'll get to choose a few things:
- Whether you want to be alerted when the time series goes above the goal line or when it goes below it.
- Whether you only wanted to be alerted every time this happens or only the first time.
- How often you want Metabase to check to see if the goal line has been crossed.
![Goal line alert options](./images/alerts/goal-line-options.png)
Click Done, and your alert will be all set up! You'll get an email confirmation, too. If you need to edit or unsubscribe from the alert you set up, just open up that same menu. It'll say "Alerts are on," so just click that, and you'll see the Edit and Unsubscribe buttons. This is also where you'll see alerts about this question that administrators might have added you to.
![Edit menu](./images/alerts/edit-menu.png)
### Progress bar alerts
Setting up this kind of alert is really similar to setting up a goal line alert. First, create a question that returns a single number as its result, then choose the Progress Bar chart type from the Visualization menu. Click the gear to select a goal value, click Done, then save your question.
Next, open up the menu in the top-right, click "Get alerts about this," and you'll see that same screen of options for when you want to get alerts about this progress bar.
### Results alerts
Lastly, you can get an alert when one of your saved questions returns any result. This kind of alert is the most useful if you have a question that doesn't *usually* return any results, but you just want to know when it *does*. For example, you might have a table called `Reviews`, and you want to know any time a customer leaves a bad review, which you consider to be anything below three stars. To set up an alert for this situation, you'd go and create a raw data question (i.e., a question that returns a list of reviews), and add a filter to only include results with one or two stars. You probably don't want to be alerted about all the bad reviews you've *ever* gotten, but just recent ones, you'd probably also add a filter to only include results from yesterday or today, depending on how often you want to check for these bad reviews. At this point, when you check the results of this question, it probably won't return any results, which is a good thing. Save the question, the click on "get alerts about this" from the menu in the top-right of the screen, and select how often you want Metabase to check this question for results. That's it!
Lastly, you can get an alert when one of your saved questions returns any result. This kind of alert is the most useful if you have a question that doesn't *usually* return any results, but you just want to know when it *does*. For example, you might have a table called `Reviews`, and you want to know any time a customer leaves a bad review, which you consider to be anything below three stars. To set up an alert for this situation, you'd go and create a raw data question (i.e., a question that returns a list of reviews), and add a filter to only include results with one or two stars.
![Bad reviews](./images/alerts/bad-reviews.png)
You probably don't want to be alerted about all the bad reviews you've *ever* gotten, but just recent ones, you'd probably also add a filter to only include results from yesterday or today, depending on how often you want to check for these bad reviews. At this point, when you check the results of this question, it probably won't return any results, which is a good thing.
![No results](./images/alerts/no-results.png)
Save the question, the click on "get alerts about this" from the menu in the top-right of the screen, and select how often you want Metabase to check this question for results. That's it!
### Adding additional recipients to your alerts
If you're an administrator of your Metabase instance, you'll be able to see and edit every alert on all saved questions. You'll also see some additional options to add recipients to alerts, which look like this:
![Recipients](./images/alerts/recipients.png)
Just like with [Pulses](10-pulses.md), you can add any Metabase user, email address, or even a Slack channel as a recipient of an alert. Admins can add or remove recipients on any alert, even ones that they did not create themselves.
Here's more information about [setting up email integration](../administration-guide/02-setting-up-email.md) and [setting up Slack integration](../administration-guide/09-setting-up-slack.md).
......
docs/users-guide/images/alerts/bad-reviews.png

113 KiB

docs/users-guide/images/alerts/edit-menu.png

23.5 KiB

docs/users-guide/images/alerts/get-alerts-about-this.png

10.1 KiB

docs/users-guide/images/alerts/goal-line-options.png

70.2 KiB

docs/users-guide/images/alerts/no-results.png

64.2 KiB

docs/users-guide/images/alerts/recipients.png

27.6 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment