Alerts¶

Add alert¶

Alerts are based on Grafana. Here only the configuration of the Alerts is explanined. You can find detailed informations about Grafana in the Visualization manual.

Preparation¶

To add an alert, you first need to visit the Visualization page.

If you visit this page for the first time, make sure to configure it correctly according to the Visualisation manual.

1. Simple alert¶

1. Click on Menu of a Sensor

   

2. Click on "Edit"

   

3. Click on "+"

   

4. Enter alert condition
   

   • "Evaluation": In this time interval, the condition is checked.
     Example: Every 30 seconds, the condition is checked.
     
   • "Time Range": In this range, it's checked, if the condition is true.
     Example: The avarage value of the last 30 seconds is checked.
     
   • "Pending": If you don't like to raise an alarm immediately, you can use it. It keeps the alarm in a pending state for a defined time before raising the alert.
     Example: After 60 seconds, the alarm raised. Before, its in pending state.
     
   • "When": Here you can select the type of the condition.
     Example: average, minimal or maximum value.
     
   • "Of": Here you can select the measurement value of the sensor, which is used for the alert.
     Example: vibration or contact temperature.
     
   • "Is above": You can change it to another type of comparison and set the comparison value.
     Example: you can select "is above", "is below" or others and enter a value.
     

     

5. Save alert
   After setting the conditions, click on "Save Alert".

   

   After saving, this notification on the top right of the screen will pop up.

   

6. Alert shows up
   When the alert conditions are true, a pending and alerting line will show up. You may need to refresh the graph to see it.

   

   In this case it gets triggered immediately, because the temperature is above 25° all the time.
   

   

   The broken heart shows that its in alerting state.

2. Complex alert¶

1. Click on Menu next to Home

   

2. Click on "Alerting"

   

3. Click on "Alert rules"

   

4. Click on "New alert rule"

   

   • Insert title

     

5. Configure alert rule query
   • Click + sign and select origin::tag

     

   • Select the master where the signal is to create the alarm

     

   • Select the port where the signal is to create the alarm

     

   • Select the signal to create the alarm

     

6. Configure the query
   

   • A - Query to apply alarm on
   • Click on "Options"
   • Select "Time Range" to measure in, then insert desired "From" value, e.g. now-10s

     

   • B & C - Remove Reduce and Threshold
   • Click on delete icon of B Reduce and C Threshold

     

   • Add Classic condition
   • Click on Add expression
   • Then click on Classic condition

     

   • Configure query in Classic condition

     

   • Set as alert condition
     • Click on Set as alert condition button

       

   • Verify condition with Preview
     • Click on Preview button

       

7. Point 3

   • Add or select any folder name you want
   • Add or select any evaulation group you want, this group decides how often the alert will be checked, e.g. every 10 seconds it checks the query interval for the condition
   • Set a "Pending period", this is the time the alarm could be over the threshold, but not alarming right away

     

8. (Optional) Link the alert to a widget.

   • In point 4, click on button Link dashboard and panel

     

   • Select the widget to link the alert to and confirm

     

9. On the dashboard you can see now the alert within the tile (only if the alert was linked to the widget), and if pending or alerting also in the "Alarms" tile
   Please remember that the dashboard needs refresh set to on to see changes