Setting Up KPI Alerts

Using scheduled alerts, you can define a time period to receive notifications on your KPI. 

How to set up a scheduled alert

To schedule a repeated notification for changes in your KPI, follow these steps:

1. Select the KPI you want to monitor, either by accessing a dashboard, or by searching within AI Analyst. If using the AI analyst route, once you have created a KPI, pin it to a new or existing dashboard.

2. Hover over the KPI visualization and select the Create Alert icon.

   

3. The pop-up Set up your alert window appears.

4. Select Scheduled.
5. Under How often, choose whether to receive an alert notification hourly, daily, weekly, or monthly.
   
6. If Hourly, enter an hour interval to receive an alert notification Every n hours. All alerts are rounded up to the next half-hour or hour. For example, if you set an alert for 11:20am, it will be sent at 11:30am.
7. If Daily, select a time of day to receive an alert notification. ASK BOSCO® displays the time zone in which your account is deployed.
   [Optional] Choose whether to receive an alert notification on weekends.
8. If Weekly, choose a minimum of one weekday to receive an alert notification. Select a time of day to receive an alert notification as per your desired timezone.
9. If Monthly, choose a minimum of one date to receive an alert notification.
   Enter the date as a numerical value or a comma-separated list (for example, "5, 10, 15" to receive an alert on the fifth, tenth and fifteenth of each month). Select a time of day to receive an alert notification as per your desired timezone.

11. Select Create Alert.

Using threshold alerts, you can receive alerts when your KPI reaches a set value. For example, you could create a condition to receive an alert when your Cost KPI becomes greater than 12,000 or "Changes by (%)"

How to set up a threshold alert

To create a threshold-based notification for changes in your KPI, follow these steps:

1. Select the KPI you want to monitor, either by accessing a dashboard, or by searching within AI Analyst. If using the AI analyst route, once you have created a KPI, pin it to a new or existing dashboard.

2. Hover over the KPI visualization and select the Create Alert icon.

   

3. The pop-up Set up your alert window appears.
   

4. Select Threshold.

5. [Optional] Enter the name of your alert under Alert name.

6. Under Condition, select the mathematical operator for your KPI alert:

   • Greater than

   • Greater than or equal to

   • Less than

   • Less than or equal to

   • Equal to

   • Not equal to

     If your KPI includes a time-series keyword (such as 'weekly'), you may also select the following options for percentage changes in your KPI within the defined time bucket: Changes by (%) Increases by (%) Decreases by (%)

7. Enter your threshold value. The exact value against which the selected threshold condition will be checked appears below the Threshold value entry.

8. The default time interval to check for threshold conditions appears below the Condition entry.

   Note the sentence underlined in Red above "Check for threshold condition weekly at n hours..." . This explains that ASK BOSCO® checks your threshold condition against the value displayed in your KPI chart at the time period you define. However, If your KPI temporarily satisfies the threshold condition, but does not satisfy the condition at the time the threshold condition is next checked, you will not receive an alert notification. 

9. [Optional] Select change to manually schedule the frequency at which ASK BOSCO® checks your KPI for the threshold condition. For example, you can schedule to check the KPI 'Sales weekly' every week, every day, or every hour. 

10. When setting up an alert, you can specify the desired timezone (e.g., "UTC") for when the alert should be sent.

    [Optional] Choose whether to receive an alert notification on weekends

     

11. Select Create Alert

Back to top

Anomaly alerts let you know when a KPI you follow is behaving unusually - outside its normal range. You can choose when and how often ASK BOSCO® checks the KPI so you get alerts at the times you want.

How to create an Anomaly Alert

To create an anomaly alert, follow these steps:

1. Select the KPI you want to monitor by accessing a dashboard, or by creating a visualization for the KPI in a new dashboard.

2. In a dashboard, hover over the KPI visualization and select the Create Alert icon.

3. The pop-up Select up your alert window appears.

4. Select Anomaly.

5. [Optional] Edit the Alert name.

   1. If Every N minutes, enter a minute interval to receive an alert notification Every N minutes.

   2. If Hourly, enter an hour interval to receive an alert notification Every n hours.

      For all alert types, when the frequency is set to hourly, then it means we may send alerts at either the 30- or 60-minute mark.

   3. If Daily, select a time of day to receive an alert notification. When setting up an alert, you can specify the desired timezone (e.g., "UTC") for when the alert should be sent. [Optional] Choose whether to receive an alert notification on weekends.

   4. If Weekly, choose a minimum of one weekday to receive an alert notification. Select a time of day to receive an alert notification in the desired timezone.

   5. If Monthly, choose a minimum of one date to receive an alert notification.
      Enter the date as a numerical value or a comma-separated list (for example, "5, 10, 15" to receive an alert on the fifth, tenth and fifteenth of each month). Select a time of day to receive an alert notification in the desired timezone.

      Below the Alert name text box, ASK BOSCO® displays the cadence at which it will check the KPI against the expected data range. To change this cadence, select Change and choose from the following options: 

6. [Optional] Select the checkbox next to Add custom message and type your custom message in the text box.

7. Select Create alert.