Alerts Builder

Users can build alerts based on given cells within a visual. You will then receive alerts based on the triggers you've defined. For instance, you may set an alert to be triggered if the costs for a given product increase. Depending on your requirements, you can build a basic alert, or an advanced alert. Alerts can be configured in Discover and Present.

This feature is available with Enterprise licensing only.

Build an Alert

  1. Alerts can only be configured for saved discoveries, so start by saving the visualization.
  2. Right click on the relevant data point (i.e. a grid cell, or chart column, etc) to open the context menu.
    • To build an alert for multiple cells in the query, use the selection or lasso tool to select the relevant cells, and then right click on the selection to open the context menu.
  3. From the context menu, open the Build New Alert sub-menu and choose the required alert type: get an alert when the value of the given data point is up, the same, or down. Once inside the alert dialog, there are more choices for triggering a data alert.
  4. Configure the alert from the Alert Builder dialog (continue reading to learn how).
  5. You can see information about alerts from the Bulletin Board and the Alerts Feed

Alert Builder Dialog

Open the context menu on the relevant data point(s) and make a selection from the Build New Alert sub-menu to open the Alert Builder dialog:

  • Name: name your alert; by default it is named according to the members in the given data point.
  • When: displays the given data point for which an alert will be triggered.
  • Is: This drop down provides a simple way to set up the alert logic trigger based on the selected data points. See below for more.
  • Alert me: choose the outcome that should be displayed in the alert based on the value (see below).
  • Run me: select a time when the alert should run. The basic alert builder enables scheduling of the alert job based on a number of presets. If you want to create your own schedule, configure an advanced alert.
    • On Demand: use on demand scheduling to trigger the alert schedule to run when the underlying data model is reprocessed. You must also configure on demand subscriptions for the relevant data models via the Master Flow or APIs.
  • Send to: choose where you want to receive the alerts; either Bulletin Board, email, SMS, or channel Webhook. Note that email and SMS can only be selected if messaging is enabled from the Admin console. The basic alert builder allows you to have alerts sent to yourself only. If you want to distribute the alert to other users, configure an advanced alert.
  • Advanced: select this option to configure an advanced alert (not available with the Community Edition).

Alert Triggers

  • The alert triggers can be set to a number of "simple" choices. These can be HEAVILY configured and adjusted using the advanced alert setup. The simple choices include:
    • up - a simple increase from the last measured value
    • down - a simple decrease from the last measured value
    • same - no change from the last measured value
    • up by amount - a specified increase from the last measured value
    • down by amount - a specified decrease from the last measured value
    • greater than - greater than a specified value
    • less than - less than a specified value
    • greater than or equal - greater than or equal to a specified value
    • less than or equal - less than or equal to a specified value
    • Automatic Detection - this runs the "Smart Alerts" engine (see below).

    Alert Outcomes

    The user can elect what type of alert outcome icon is shown when the alert runs. The icon outcome does not itself indicate if the alert is successful or not. For example, an alert that measures things that produce "good news", may have the green outcome icon - so when the user gets the message, they see "good" news. Likewise, an alert that is triggered when there is "bad news", would use the red icon.

    Smart Alerts

    The Smart Alerts engine tracks the specified data point as it changes per data refresh or per the specified schedule of the alert. The historical values are tracked and run through time series machine learning algorithms to create a projection of where new values should fall. When real values fall dramatically outside the expected range, and alert is triggered to the user. Smart Alerts cannot operate until sufficient data has been accumulated for the projection (usually 6-12 data points).

    Smart Alerts are licensed separately.

    Data Source Authentication

    If the data source used in the discovery or presentation is based on Windows Authentication, then a separate panel will be presented to the user. The user may need to supply a set of credentials to successfully submit the scheduled task.

    This often occurs when the authentication method for the data source is set to "End-user" Windows Authentication. Under this model, the user running the queries is used to connect (via Kerberos token) to the data source. However, when running a batch task (offline), the user's token is not available - as such a set of their credentials is required for connectivity by the Pyramid engine.

    This may not be required if the website authentication is via Basic or Forms.

    Schedules can also be configured for SAP BW sources if SAP Logon Tickets is selected as the authentication method in the Admin console. In this case, you'll be prompted to enter the relevant credentials.

    Note: SAP Logon Tickets are available with an Enterprise license only.

    Managing Alerts

    Once an alert has been created, it can be managed from the content manager, through the related content item's Action Panel.

    • Click here for more on the Alert Manager tools in the content manager.