Creating a Metric Alert (Studio)

About Creating a Metric Alert

You can create an alert that goes out to key stakeholders whenever a certain threshold is met by one of your metrics. You can either create metric alerts right inside your dashboards by clicking data points that interest you, or you can create alerts inside a dedicated page of Studio.

Creating Alerts from Drilled Widgets

You can create a metric by drilling into a widget. Just click a data point and select Alert Me.

From there, you can set up the following:

• General Settings
• Define Trigger
• Notifications
• Case Creation
• Save

Creating Alerts from the Alerts Page

1. Click the Spaces menu.
   
2. Click Alerts.
3. Go to the Metric tab.
   
4. Select the Project your metric exists in.
   Qtip: You may also need to choose an account and a content provider, depending on what you have access to.
5. Click New Alert.

From there, you can set up the following:

• General Settings
• Define Trigger
• Notifications
• Case Creation
• Save

General Settings

General settings can be found in the Definition tab.

In General Settings, name the alert, enable or disable it, and decide the date when it starts.

• Alert Name: Provide a unique name for your alert. No other alerts in your account can have this name.
• Enable: Determine whether the alert should be enabled or disabled when you submit your changes.
  Qtip: You can create as many metric alerts as you want, but you can only enable up to 10 of them. Once 10 metric alerts are enabled, you will need to disable a metric alert before enabling another. Alerts shared with you by other users do not count towards this limit.
• Starts on: Click the calendar to choose a date the alerts should start. Alerts run between midnight and 6 AM of the selected time zone.

Define Trigger

Define Trigger can be found in the Definition tab.

In the Define Trigger section, decide what data events trigger alerts.

1. Alert: Choose whether the alert should go out daily, weekly, or monthly.
   • For Weekly alerts, you can choose a day of the week the alert will send.
   • When you choose Monthly, the alert can go out every few months instead. You will be asked what day of the month and how frequently the alert should go out.
2. Calculation: Select the calculation to monitor. Once this calculation hits a defined threshold, an alert will trigger. You can choose any of these calculations, or scorecards.
3. Criteria: Select the condition to monitor for calculation threshold:
   • Is less than or equal to: Send an alert when the calculation is equal to or less than the threshold.
   • Is greater than or equal to: Send an alert when the calculation is equal to or greater than the threshold.
   • Increases more than or equal to: Send an alert when the calculation’s increase during the monitored time period compared to the previous time period is equal to or greater than the threshold.
   • Decreases more than or equal to: Send an alert when the calculation’s decrease during the monitored time period compared to the previous time period is equal to or greater than the threshold.
   • Changes more than or equal to: Send an alert when the calculation’s increase or decrease during the monitored time period compared to the previous time period is equal to or greater than the threshold.
   • Changes significantly: This option is only for numeric attributes aggregated by average. Send an alert when the calculation’s increase or decrease during the monitored time period compared to the previous time period is statistically significant.
4. Threshold: Define the minimum/maximum value (or change variance) required to send an alert. Percentage change calculations are not supported for sentiment, effort, emotional intensity, satisfaction, top box, and bottom box metrics, since percentage changes are irrelevant when calculated over values that range from negative to positive.
   Example: Send an alert when volume becomes greater than or equal to 1000.
   Qtip: You can use a zero volume threshold alert to monitor data ingestion into Designer. For example, when volume drops to 0 over the last week for a certain source, an alert will trigger and notify stakeholders. Be sure to set the minimum volume to 0 as well, otherwise the alert will not fire.
   
   Example: Send an alert when Likelihood to Recommend decreases by more than 30% compared to the previous month.
   
   Qtip: For change variance criteria, you can switch between delta change and percentage change calculations by clicking the percent ( % ) and delta ( Δ ) icons.
   
5. For Any: This setting is optional and lets you monitor specific data groupings as opposed to monitoring the entire project at once. You can click the trash icon to remove the grouping.
   Qtip: This setting is great for monitoring lots of groups without having to create multiple separate alerts. For example, it can save you a lot of time when you have a set of stores or products that you want to monitor. The alert will send notifications if 1 or more groups meet the threshold criteria.
6. Skip Alert if Minimum Volume Below: Define the minimum number of records required in the Over Time Period date range to send an alert.
7. Over Time Period: Choose the time period over which the calculation will be monitored.
8. Filter: Define additional criteria or conditions required to trigger an alert. You can add up to 5 filter conditions. For details, see Creating a Filter.
9. Explore Alert Trigger in Dashboard: Add a widget matching the parameters defined for this alert to a new or existing dashboard. If you have For Any groups applied, a table widget is created. Otherwise, a metric widget is created.
   

Notifications

The Notifications section can be found in the Notifications tab.

Here, you can set the channel the alert is sent through and write the message included.

1. Notification channel: Choose between the following:
   • Notify in App (the Studio desktop site)
   • Notify by Email
   • Notify by Both
2. Link to Dashboard: Choose a dashboard to link to in the notification. This is especially useful if the dashboard is relevant to the alert and can be used for further investigation.
   Qtip: If some recipients of this alert do not have access to the linked dashboard, Studio will prompt you when you save the alert. You can then choose to save the alert with or without sharing the dashboard with the alert’s recipients.
3. Notification message: Write the message for the in-app notifications only. Use dynamic text placeholders to reference various alert settings.
4. Email Subject: Write the subject of the email. Use dynamic text placeholders to reference various alert settings.
5. Email Body: Write the body of the email. Use dynamic text placeholders to reference various alert settings.

Dynamic Text Placeholders

You can use the following placeholders in the in-app message, email subject, and email body of your alert.

Share Settings

The Share Settings section can be found in the Notifications tab.

Here, you can choose who’ll get notifications when this alert is triggered.

1. Specify who should receive this alert’s notifications.
   • Individual Studio users: Type the email of the user or part of it, then select it from the dropdown list.
   • Studio groups: Type the name of the group or part of it, then select it from the dropdown list.
   • Organization hierarchy members: Type the name of the organization hierarchy or part of it, then select it from the dropdown list.
     Qtip: If you select the same organization hierarchy used for grouping the alert, notifications will only be sent to users who belong to the corresponding level of the hierarchy.
2. Select an appropriate permission.
   • Notify: Users will get notifications when the threshold and conditions are met.
   • Can Edit: Users will get notifications and be able to edit this alert’s settings.
3. Click the plus sign ( + ) next to the group name to expand a list of group members.
4. Add as many users and groups as you need before saving.

Case Creation

You can create a case whenever a metric reaches a threshold and your notification is sent.

1. Open the Case Creation tab.
2. Select Create Case to create a case whenever this notification is triggered.
3. If you’ve added a grouping to your alert (by filling out the For Any field), you can create separate cases for each grouping. To do so, select Create An Individual Case For Each Group Matching.
4. Under Assignee, search a group or user to assign them to the case.
   Qtip: You can only assign either 1 group or 1 user at a time.
5. Select a Topic to decide which inbox the case will be created in.
6. Create a title for the case.
7. Select a priority.
8. Under Case Body, describe the purpose of the case and the goal the assignee must complete.

Saving the Alert

When ready, click Save to save the alert or Cancel to close the window without saving.

If some recipients of this alert do not have access to the dashboard linked in the notification, Studio will give you the following options:

• Save And Share: Save the alert and share the linked dashboard with all its recipients.
  Qtip: Recipients will be given view-only permission of the dashboard, not editing permission.
• Save: Save the alert without sharing the linked dashboard.
• Cancel: Do not save the alert.

Viewing Metric Alerts

Any in-app alerts you’ve received can be found by clicking the Notifications icon on any page of Studio. Metric alerts appear in the Notifications tab.