Using conditions for alerts
This topic provides an overview of the types of condition alerts you can use when configuring a Condition Alert.
Score-based conditions
You can use score-based conditions to identify when the overall data quality score or the score of particular monitors exceed a given threshold. You can use any number of AND
and OR
operators in the condition.
Type | Variable | Description | Condition example |
---|---|---|---|
Score | score
|
Send an alert when the data quality score meets the required conditions. | score < 75
|
Behavior score | behaviorscore
|
Send an alert when the behavior score meets the required conditions. | behaviorscore < 20
|
Outlier score | outlierscore
|
Send an alert when the outlier score meets the required conditions. | outlierscore > 15
|
Pattern score | patternscore
|
Send an alert when the pattern score meets the required conditions. | patternscore = 0
|
Source score | sourcescore
|
Send an alert when the source score meets the required conditions. | sourcescore < 75
|
Record score | recordscore
|
Send an alert when the record score meets the required conditions. | recordscore < 50
|
Schema score | schemascore
|
Send an alert when the schema score meets the required conditions. | schemascore < 50
|
Dupe score | dupescore
|
Send an alert when the dupe score meets the required conditions. | dupescore > 10
|
Shape score | shapescore
|
Send an alert when the shape score meets the required conditions. | shapescore > 0
|
Row count condition
You can use the row count condition to help you monitor changes to the number of rows in your dataset.
Type | Variable | Description | Condition example |
---|---|---|---|
Row count | rc
|
Send an alert when the row count meets the required conditions. | rc = 0
|
Run time conditions
You can use run time conditions to monitor how long it takes for a DQ Job to run.
Type | Variable | Description | Condition example |
---|---|---|---|
Run time in seconds | totalTimeInSeconds
|
Send an alert when the run time meets the required conditions. | totalTimeInSeconds > 20
|
Run time in hours | totalTimeInHours
|
Send an alert when the run time meets the required conditions. | totalTimeInHours > 2
|
Run time in minutes | totalTimeInMinutes
|
Send an alert when the run time meets the required conditions. | totalTimeInMinutes > 20
|
Stale data conditions
You can use stale data conditions to monitor for when DQ Jobs have missing or no rows, or have not run for a given number of days.
Type | Variable | Description | Condition example |
---|---|---|---|
Days without data | daysWithoutData
|
Send an alert when the number of days without data meets the required conditions. | daysWithoutData >= 1
|
Runs without data | runsWithoutData
|
Send an alert when the number of runs without data meets the required conditions. | runsWithoutData > 2
|
Days since last run | daysSinceLastRun
|
Send an alert when the number of days since a dataset last ran meets the required conditions. | daysSinceLastRun > 1
|
Rule conditions
Tip We highly recommend adding rule condition alerts from the Rules tab of the Alert Builder.
To use a rule condition as an alert, enter the name of an existing rule in the Condition field and optionally select Add Rule Details to include the following details of your rule in the email:
- Rule name
- Rule condition
- Total number of points to deduct from the quality score when breaking
- Percentage of records that are breaking
- Number of breaking records
- Assignment Status
Rule conditions use a <ruleName> <operator> <rule score>
syntax. For example, RegionNullCheck > 0
sends an alert when there are any breaking records. Similarly, RegionNullCheck >= 10
sends an alert when the percentage of rule breaks is greater than or equal to 10%.