Alerts and Triggers

When data reaches important thresholds, you need to pay immediate attention to it. Alerts and triggers, notify you when your data meets certain thresholds or anomalies are detected.

Gathr Analytics enables you to set alerts on such critical situations and trigger actions on them.

Let us understand this with examples

Suppose you have a bar or pie chart depicting bugs, stories, epics and you want to monitor when the bugs cross a threshold, let’s say 100. You can set an alert when the value of the bar/pie crosses this threshold.

You can set alerts on string values too. So, for example, you want to be alerted if descriptions in your column contain the word- Critical. Gathr Analytics will raise an alert when this criteria is matched.

When an alert is raised, it can trigger one of the following actions:

  • Send Email to Shared Users

  • Execute another Editable App

Type of Alerts:

  • Visualization level Alerts

  • Dataset level Alerts

Alert on Visualization

Alert on visualization can be used when you want to monitor change in the value of Visual elements of any Visualization(e.g. Size of a pie slice, bar etc.) Alert on visualization is raised when the value of a measure (i.e. aggregate function like count average etc.) crosses a threshold.

Note: You can define single alert on a visualization, unlike Dataset Level Alerts.

Create Alert on Visualization

  1. Click on the icon of the visualization on which you want to create an alert, and select ‘Add Alert’

  1. Provide following input in ‘Add Alert’ pop-up

    • Alert name – Name for this Alert

    • Alert When – Alert will be raised when

      • All - All the values of this measure meets the criterion.

      • Any - Any one value of this measure meets the criterion.

    • Value Of – You can choose one of the measures used in this visualization (Note: non-aggregated visualizations like grid will show columns here)

    • Is - Options according to the type of the measure/column, e.g. ‘Less Than’/’Greater Than’ etc. for measures and Contains/Equals for text Dimensions

    • Value – The threshold value that must be breached by the measure to raise an alert.

    • Where - Define this If you want alert on threshold breach by selected values of the dimension. e.g. Assume bar chart is showing bars for Type of issues (Bugs, Stories, Epics and Objectives) and you want an alert when the bar for “Bugs” crosses a threshold then you can provide “Bug” in this field.

  2. Click on NEXT to define actions to be triggered when the alert is raised

  1. Provide the following input to define the trigger

    • Trigger name – Name of the trigger.

    • Trigger type– Select one from the drop-down.

      • Execute Editable App - To Run another Editable App when alert is raised.

      • Send Email - To send an email when the alert is raised.

    • Frequency – Configure the frequency at which the system should raise an alert after the threshold is met.

    • Depending on the trigger type chosen in previous steps, you will get different options.

For ‘Execute Editable App’ you will get the list of Editable Apps to choose from.

For ‘Send Email, you can define To, CC, BCC, Subject and Content of the email.

  1. Click ‘Add’, Once the alert is defined you will see a bell icon on the container header.

Edit/Delete Alert Defined on a Visualization

To edit or delete the alert created on a visualization, follow below steps:

  1. Click on icon on the visualization on which alert is already defined

  1. To Edit: Click on ‘Edit Alert’. Enter details and click on UPDATE.

  2. To Delete: Click on ‘Delete Alert’, provide confirmation and click Ok.

Dataset Level Alerts

A dataset level alert is raised when the value of a field of a dataset meets a given criterion. You can define multiple alerts on a single field of a dataset.

How to Create an Alert

  1. Open the Data Panel, Search the Dataset and field you want to put an Alert on.

  2. Click on Overflow menu of the field on which you want to create an alert.

  1. Click on ‘Add Alert’

  2. Provide following input in the pop-up form:

    • Alert Name – Name for the Alert

    • Alert When – Alert can be raised in either of the following two conditions

      • All - Alert when all the rows of this column meet the threshold condition

      • Any - Alert even if the value in any one row of this column meets the threshold condition

    • Value Of – Alert is being added to this Field. It is a Read only entry in the form

    • Alert Condition - This field will show options according to the type of the field, e.g. Contains/Equals for Text fields and ‘Less Than’/’Greater Than’ etc. for numeric.

    • Value – The threshold criterion which must be met to raise an alert.

  3. Click on NEXT will open another form to to let you define “actions to trigger” when the alert is raised.

    • Trigger name – Provide a name

    • Trigger Type– Select from the drop-down list

    • Execute Editable App - To execute another Editable App when the alert is raised

    • Send Email - To send an email when the alert is raised.

    • Frequency – Configure the frequency at which the system will raise the alert. This shall be used for frequently occurring alerts.

    • If Trigger Type is ‘Execute Editable App’, then Select the Editable App which shall be Run when the alert is raised.

  • If Trigger Type is ‘Send Email’, then you need to provide the following details:

    • To, Cc, Bcc – Select the recipients from the list of email ids of shared users

    • Email Subject – As desired

    • Email Content – As desired

Note: Email can only be sent to users with whom the Editable App is shared.

  1. Click on ‘Add’.

  2. A Bell icon is shown next to the column name in the data panel

You can add multiple triggers by following the steps defined above.

Edit Alert

To edit an alert, follow these steps:

  1. Open the Data Panel, Search the Dataset and field you want to put an Alert on.

  2. Locate the column with alert you need to edit (You will see icon besides field name)

  3. Click on Overflow menu and select ‘Edit Alert’.

  1. The Edit Alert pops up will open.

  2. If multiple alerts are defined on this field then select an alert from the drop-down list. Make necessary changes and click NEXT.

  1. Trigger details form will pop-up.

  2. Change the Trigger details and click on UPDATE.

Delete Alert

To delete an alert, follow these steps:

  1. Open the Data Panel, to view the columns of the dataset

  2. Goto the column where alert needs to be deleted. (You will see icon besides field name).

  3. Click on Overflow menu icon and select ‘Delete Alert’.

  1. A pop-up box will show existing alerts on this field. Select and click on ‘DELETE’.

  1. After confirmation, the alert is deleted and you can see the remaining alerts on the screen.

  2. Close the pop-up box by clicking on the icon.

If you have any feedback on Gathr documentation, please email us!

← Create a story
Create Visualization and Dashboard using GathrIQ →