GuidesAPI ReferenceDiscussions

Advanced Alerts Definition

Using Advanced Alerts (beta feature).



Advanced alerts are a beta feature intended to be used in collaboration with the Databand team. To start using advanced alert definitions, reach out to us via Slack for assistance.

With advanced alerting, you can define alert rules with more complex formulas. Advanced alerts are built from a set of clauses with logical operators (AND/OR/UNLESS) between them.

Each clause is built from a metric, a comparison binary operator, and a value. For example, "metric1 > 1".

The resulting expression needs to be evaluated against a boolean query which (once satisfied) will trigger an alert.

To add a new advanced alert:

  • Switch to the "Advanced BETA" tab within the Alerts screen
  • Focus on the input by pressing the specified key combination
  • Build the clause by clicking the basic alert editor's interface (at the bottom of the screen)

After building a valid clause, manually enter a logical operator, after which additional clauses can be added to the alert definition.

Numeric Alert Examples

  • metric1 > 10 - An alert constructed from a single clause. Databand will trigger this alert any time metric1 returns a value greater than 10.
  • metric1 > 10 or metric2 != 0 - An advanced alert constructed from multiple conditions. Databand will trigger this alert if either of the two conditions are satisfied.

Non-Numeric Alert Examples

Using Enum Metrics
Enum metrics cannot be typed directly, but they can be added using auto-completion. For example:


Using String Metrics


Allowed Inputs

  • Logical operators: and, or, unless
  • Comparison: <, <=, ==, !=, >=, >
  • Integers, floating-point numbers, and strings can be typed directly
  • Enums (e.g. failed run state) can be added via auto-completion by clicking on the desired metric in the basic interface
  • Parentheses: ( )
  • Whitespace: space, tabs, line breaks (have no effect on the logic)