Create alerts to monitor performance and get notified when things change.
This page shows how to create and configure a basic Custom alert.
For more alert examples, visit Sample alerts.
Before you begin
The steps below are intended for Cloud Observability users with either the Admin or Member role.
The steps also assume you’ve done the following:
Step 1: Name and describe your alert
Follow these steps to name and describe a new alert:
- In Cloud Observability, click Alerts > Create an alert.
- Click Enter an alert name to name your alert, for example, Supernova request rate alert.
Add a description by clicking Describe important details about this alert.
The description supports Markdown, and you can include links to teams and runbooks. Here’s an example:
Send alerts when request rates go above 13 per second over two minutes. Have questions?
Ask in [#sre](https://lightstep.com/).
You can also add labels (such as
service:myservice) to the description.
Step 2: Select an alert template
In the Alert template section, click Custom.
Custom is Cloud Observability’s most flexible alert template.
To see examples of other alert templates, visit Sample alerts.
You can switch templates when creating and configuring alerts.
You may lose information if the inputs aren’t compatible, so Cloud Observability asks you to confirm the switch.
Step 3: Build your query
In the Query section, create your query using the Unified Query Builder.
The example below queries request rates for the customer PackingKings.
It groups results by method name, averaged over a final two-minute rolling input window.
To manually write a query, click Editor.
You can also use existing queries on dashboards or existing queries on notebooks to create alert queries.
Step 4: Configure your alert
Follow these steps to configure your alert:
- In the Alert configuration section, click a single notification and select an option to configure notification behavior:
- a single notification - Get only one notification if one or more group values cross the threshold during the input window.
For example, if two group values cross the threshold in a 30-minute input window, you get one notification.
- separate notifications - Get a notification every time a group value crosses the threshold during the input window.
For example, if two group values cross the threshold in a 30-minute input window, you get two notifications.
- Click the above drop-down and select one of the following:
- above - Send notifications when the metric goes above the threshold.
- below - Send notifications when the metric goes below the threshold.
- To set alert thresholds, select the Critical threshold and/or Warning threshold checkboxes and enter your values.
Cloud Observability plots the values on the chart.
- To be notified if Cloud Observability isn’t receiving any data for the query, select Notify if no data is reporting for this query.
Step 5: Configure notification rules and save
Follow these steps to set your notification rules and activate your alert:
- Under Notification rules, click Search for a destination type to select the third-party tool you use for notifications.
Click Search for the destination name and enter the name of your notification destination.
If you haven’t created a notification destination, click Search for a destination name > + Create a destination.
- Make these optional changes to your notification rules setup:
- By default, Cloud Observability sends notifications when data crosses the configured threshold.
If you want to receive notifications until the issue resolves, click Add notification frequency and configure the rate.
- To send notifications to another destination, click Add another rule and repeat the steps above.
- Review your changes and click Save to activate your alert.
Cloud Observability displays Alert saved and returns you to the Alerts tab.
You’re all set! Visit the links below to learn more about Cloud Observability alerts.
Manage notification destinations
View and manage alerts
Updated Sep 21, 2023