Documentation Grafana Cloud Platform Knowledge graph Configure Notifications Create notification rules

Create notification rules

To receive alerts when an insight fires, you can create a notification rule. This rule specifies the conditions for triggering an alert when an insight fires. Notification rules are useful for customizing when you receive alerts, ensuring you are notified only for specific instances and not every time an insight occurs.

The knowledge graph uses Prometheus Alertmanager for notifications, which enables you to use the various receivers listed on its official page, such as email, PagerDuty, Slack, and so on.

Notifications are organized into different sections, just like the thresholds, and the same hierarchical granularity levels apply. For example, you can set notifications for an insight whenever it fires, or when it fires on a specific job or a job and request type. Free-form label conditions are also supported.

Before you begin

To learn the setup process, refer to Configure notifications. To understand how notifications work, refer to How notifications work.

Create a Request notification

To create a Request notification, complete the following steps:

1. Sign into Grafana Cloud and click Observability > Rules > Notify.

2. Click Request.

3. Complete the following fields:

   Expand table

   Field name	Description
   Job	Select a job. The list of jobs is generated from your environment.
   Insight	Select the insight that you are notifying on.
   Request Type	Optional. The category or type of notification you are creating. For example: inbound, client_connections, logger, and so on.
   Request Context	Optional. Details about the request. For example: the API path, the operation performed, the method called, and so on.
   Other Labels	Any additional alert labels that you want to match on, for example, asserts_severity="warning".
   For	Duration for which the alert condition must be true before the system sends a notification.
   Receiver	The target system that receives the notification, such as Slack, MS Teams, or a pager. You must configure a contact point before you create a notification.
   Rule Name	Enter a name for the rule.

4. Click Add new.

Create a Resource notification

To create a Resource notification, complete the following steps:

1. Sign into Grafana Cloud and click Observability > Rules > Notify.

2. Click Resource.

3. Complete the following fields:

   Expand table

   Field name