Managing alerts

Adding an alert definition

You can create an alert definition by going to the Alerts page of the Databand UI. The following sections explain how to add an alert for all metric types in Databand, including threshold metrics.

1. In the Alerts or Alerts defined page of the Databand UI, click Add alert.
2. Choose the type of alert that you want to create. If you want to create a Custom task metric, Pipeline duration, Task duration, or Data quality metric alert, you can create an alert for a threshold metric. See the following section to create an alert for a threshold metric.
3. Choose the asset, either pipeline, project, or source, that you want to create an alert for.
4. Choose the operator and any other required parameters for your alert, such as pipeline or task state, or test severity.
5. Proceed to finish creating your alert.

1. For pipeline duration alerts, choose the pipeline and metric that you want to create an alert for. You can choose multiple pipelines, but anomaly detection alerts are only available if you choose a single pipeline. For custom task metric or task duration alerts, also choose a specific task.
2. Select the type of threshold metric: fixed value, percent deviation, or anomaly.

   For fixed value alerts:

   1. Choose an operator, such as greater than or equal to, less than or equal to, or does not equal.
   2. Set a numeric value. You can now see a graph of your last 30 runs, and view how many alerts would be triggered from this alert definition.
   3. Proceed to finish creating your alert.

   For percent deviation alerts:

   1. Enter a numeric value for your ratio baseline.
   2. Choose a percent deviation. You receive alerts if a run is this percent higher or lower than your ratio baseline. For example, if you select 5%, an alert triggers if a run is 5% higher or lower than the value of your baseline.
   3. Proceed to finish creating your alert.

   For anomaly alerts:

   1. Choose the number of runs to include in the lookback window. The default value is 10 runs.
   2. Select how sensitive the anomaly detection is. Lower sensitivity means that a wider range of values are seen as not anomalous. Higher sensitivity means that fewer values are seen as normal, and more values are seen as anomalous.
   3. Proceed to finish creating your alert.

1. Click Next.
2. Choose an Alert severity and provide a name for the alert.
3. Optional: Provide a description for the alert.
4. Click Save alert.
5. Optional: Select receivers and add collaborators for this alert. Receivers and collaborators can be changed at any time through the Alerts page of the Databand UI.
6. Click Save alert. You can now see your saved alert in the Alerts defined page of the Databand UI.

Editing an alert definition

The Alerts defined page displays all of the relevant details for each alert definition. If you want to change anything about an alert definition, click the More options icon in the row of the alert you want to edit, and then click Edit alert definition. You can edit any of the information that is included in an alert definition.

Deleting an alert definition

To delete an alert definition, choose one of the following options:

• Click the More options icon in the row of the alert that you want to edit, and then click Delete alert definition.
• Check the box in the row of the alert that you want to edit, and then click Delete. This method can be used to delete multiple alert definitions at once.

When you delete an alert definition, all historical triggered alerts are also deleted. If it is important that historical triggered alerts are preserved, instead of deleting an alert, see the following section on disabling alerts.

Disabling an alert definition

To temporarily disable an alert definition without deleting it, choose one of the following options:

• Click the More options icon menu in the row of the alert that you want to edit, and then click Turn off alert.
• Click the toggle in the Active column.
• Check the box in the row of the alert that you want to edit, and then click Disable alert. This method can be used to delete multiple alert definitions at once.

When you disable an alert definition, historical triggered alerts are preserved.