Catchpoint alerting
The Catchpoint data source supports Grafana alerting, so you can create alert rules on your Catchpoint Tests, RUM, and SLO data. Because it’s a backend data source, Grafana evaluates these rules server-side without an open dashboard.
Before you begin
- Configure the Catchpoint data source.
- Verify your queries return data in a panel or in Explore.
- Understand Grafana Alerting.
Create an alert rule
To create an alert rule that uses Catchpoint data:
- Navigate to Alerting > Alert rules.
- Click New alert rule.
- Select the Catchpoint data source for the query.
- Build a query with the query editor, such as a Tests query that returns availability.
- Add an expression to reduce the query to a single value, then set the alert condition and threshold.
- Set the evaluation behavior, labels, and notifications, then save the rule.
Alert rule example
This example alerts when the availability of a critical test drops below 99% over the last 5 minutes. A Grafana alert rule combines a data source query with one or more expressions that reduce the series to a single value and compare it against a threshold.
Add a query and name it
A, using the Catchpoint data source:Add a Reduce expression named
Bto collapse the series to a single number:Add a Threshold expression named
Cand set it as the alert condition:Set the evaluation interval, pending period, labels, and notification policy, then save the rule.
The rule fires when the reduced availability value for the test falls below 99.
Use cases
The following scenarios show common ways to alert on Catchpoint data:
- Availability drop: Alert when the availability metric for a critical test falls below a threshold.
- Slow response time: Alert when a test or RUM response time metric exceeds an acceptable value.
- SLO compliance: Alert when an SLO Status query returns compliance below the objective target.
