Skip to main content

Alert rules

Use the Alert rules tab to manage alert rules. Here you can:

  1. Add a new alert rule.
  2. Review the alert rule running states for each existing alert rule.
  3. Review the alert rule alerting state for each existing alert rule.
  4. Pause/Start the alert rule.
  5. Delete the alert rule.
Use the Alert Rules tab to manage alert rules.
Use the Alert Rules tab to manage alert rules.

Alert rules states​

To temporate pause alert execution click on Pause icon for the specific alert rule. Alert can be started anytime to resume execution.

Alert rules statuses​

Right after an alert is created it becomes Active and Scheduled. After modification, the alert status changes to Scheduled if it requires reexecution with a new set of parameters.

  • Scheduled. The alert is scheduled, but never run yet with a current set of parameters. This status is assigned right after the alert is created or modified by the user and API.
  • OK. The alert has been run and the thresholds are NOT breached and the Regex pattern is NOT found.
  • Alerting. The alert has been run and the thresholds are being breached or the Regex pattern is found.
  • Error. Something is wrong which could be the query, annotation or action.

Flow schema​

Reference the flow schema to get a better understanding of how statuses change in the Business Engine.

A logical schema of alert rules statuses.
A logical schema of alert rules statuses.

Add a new rule​

The Add a new rule window looks as follows:

The Add a new rule window.
The Add a new rule window.

The new alert rule/edit window has the following configuration elements to specify:

  • Title is an alert name.
  • Schedule is a frequency of how often the rule should run.
    • With CRON expressions your schedule can be as complex as needed.
  • Target Dashboard and Target Panel are drop-downs to select from the existing ones.
    • The alert rule will take queries and thresholds from there automatically.
  • Time Range could be either taken from the dashboard or specified custom.
  • The alert evaluation could be set to Thresholds or Regex Pattern.
    • For the Thresholds, the alert examines the data against thresholds set in the panel options.
    • For the Regex Pattern, the alert examines the specified fields (optional) and searches the specified pattern.
  • For the alert action, select from the drop-down list of the existing, pre-configured action APIs.
  • Add Annotation option.
    • specify Panel to create and attach an annotation to a panel,
    • specify Dashboard to create and attach an annotation to a dashboard (i.e. all panels of this dashboard),
    • specify Disabled to disable the creation of any annotation following the alert rule breach.

Multi-frames​

The Business Engine supports multi-frame data sets. That means that the alert rule assigned to a dashboard and panel will be applied to all data frames fetched from the connected data source.

Dashboard and panel are mandatory parameters for an alert rule.
Dashboard and panel are mandatory parameters for an alert rule.

Transformations​

BETA

Support of Grafana transformation is in beta state. This is due to the number of existing transformations.

Grafana transformations are supported. However, please, note, that Grafana offers a large number of transformations, hence, there is a chance that some of them will not work correctly.