---
title: "Create notification rules | Grafana Cloud documentation"
description: "Learn how to create an alert notification rule when there is important or time-sensitive information that needs to be communicated to users promptly."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# 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](/docs/grafana-cloud/knowledge-graph/configure/notifications/). To understand how notifications work, refer to [How notifications work](/docs/grafana-cloud/knowledge-graph/reference/notifications/).

## Create a Request notification

To create a Request notification, complete the following steps:

1. Sign into Grafana Cloud and click **Observability &gt; Rules &gt; 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](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/) 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 &gt; Rules &gt; Notify**.
2. Click **Resource**.
3. Complete the following fields:
   
   Expand table
   
   | Field name    | Description                                                                                                                                                                                                                                                 |
   |---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
   | Insight       | Select the insight that you are notifying on.                                                                                                                                                                                                               |
   | Resource Type | Optional. The category or type of notification you are creating. For example: `inbound`, `client_connections`, `logger`, and so on.                                                                                                                         |
   | Container     | Optional. The name of the container using the resource.                                                                                                                                                                                                     |
   | Source        | The source of the metrics for the resource. This could be any exporter or framework serving up resource metrics.                                                                                                                                            |
   | Severity      | The severity of the threshold, for example `warning` or `critical`.                                                                                                                                                                                         |
   | Receiver      | The target system that receives the notification, such as Slack, MS Teams, or a pager. You must [configure a contact point](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/) before you create a notification. |
   | For           | Duration for which the alert condition must be true before a notification is sent.                                                                                                                                                                          |
   | Other Labels  | Any additional alert labels that you want to match on, for example, `asserts_env="prod"`.                                                                                                                                                                   |
   | Rule Name     | Enter a name for the rule.                                                                                                                                                                                                                                  |
4. Click **Add new**.

## Create a Health notification

To create a Health notification, complete the following steps:

1. Sign into Grafana Cloud and click **Observability &gt; Rules &gt; Notify**.
2. Click **Health**.
3. Complete the following fields:
   
   Expand table
   
   | Field name    | Description                                                                                                                                                                                                                                                 |
   |---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
   | Group         | Prometheus rules are organized into rule groups.                                                                                                                                                                                                            |
   | Rules         | Select a rule from the rule group.                                                                                                                                                                                                                          |
   | Env           | Select the environment for which this notification is relevant.                                                                                                                                                                                             |
   | Receiver      | The target system that receives the notification, such as Slack, MS Teams, or a pager. You must [configure a contact point](/docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/) before you create a notification. |
   | Continues for | Duration for which the alert condition must be true before a notification is sent.                                                                                                                                                                          |
   | Other Labels  | Any additional alert labels that you want to match on, for example, `asserts_severity="warning"`.                                                                                                                                                           |
   | Rule Name     | Enter a name for the rule you are creating.                                                                                                                                                                                                                 |
4. Click **Add new**.

## Used in these workflows

Creating notifications is used in:

- [Monitor selected services](/docs/grafana-cloud/knowledge-graph/use-cases/monitor-services/) - Set up alerts for your team’s services
- [Investigate incidents](/docs/grafana-cloud/knowledge-graph/use-cases/investigate-incidents/) - Get notified during incident response

## Related topics

- [How notifications work](/docs/grafana-cloud/knowledge-graph/reference/notifications/)
- [Configure notifications](/docs/grafana-cloud/knowledge-graph/configure/notifications/)
