2023-09-12 22:46:13 +08:00
---
2024-02-27 18:56:11 +08:00
aliases:
2024-03-14 23:58:18 +08:00
- ../../../alerting-rules/manage-contact-points/configure-oncall/ # /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/manage-contact-points/configure-oncall/
- ../../../alerting-rules/manage-contact-points/integrations/configure-oncall/ # /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/manage-contact-points/integrations/configure-oncall/
2024-10-30 17:56:36 +08:00
- ../configure-oncall/ # /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/manage-contact-points/configure-oncall/
2024-02-27 18:56:11 +08:00
canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/configure-oncall/
2023-12-12 18:05:20 +08:00
description: Configure the Alerting - Grafana OnCall integration to connect alerts generated by Grafana Alerting with Grafana OnCall
2023-09-12 22:46:13 +08:00
keywords:
- grafana
- alerting
- oncall
- integration
labels:
products:
- cloud
- enterprise
- oss
2023-11-08 20:43:46 +08:00
menuTitle: Grafana OnCall
title: Configure Grafana OnCall for Alerting
2024-11-06 22:28:44 +08:00
weight: 120
2023-09-12 22:46:13 +08:00
---
2024-07-02 23:21:29 +08:00
# Configure Grafana OnCall for Alerting
2023-09-12 22:46:13 +08:00
Use the Grafana Alerting - Grafana OnCall integration to effortlessly connect alerts generated by Grafana Alerting with Grafana OnCall, where you can then route them according to defined escalation chains and schedules.
2024-07-02 23:21:29 +08:00
{{< admonition type = "note" > }}
2024-11-11 21:00:30 +08:00
You can also configure the integration from Grafana OnCall. For more information, refer to [Grafana OnCall documentation ](http://grafana.com/docs/oncall/latest/configure/integrations/references/grafana-alerting/ ).
2024-07-02 23:21:29 +08:00
{{< / admonition > }}
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
## Before you begin
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
Grafana OnCall is available in Grafana Cloud by default.
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
If you are using Grafana OSS, [install and enable the Grafana OnCall plugin ](http://grafana.com/docs/oncall/latest/set-up/open-source/#install-grafana-oncall-oss ). Also, ensure your version of Grafana is up-to-date and supports the new features.
## Procedure
2023-09-12 22:46:13 +08:00
To set up the Grafana OnCall integration using the Grafana Alerting application, complete the following steps.
2024-07-02 23:21:29 +08:00
1. Navigate to **Alerts & IRM** -> **Alerting** -> **Contact points** .
2023-09-12 22:46:13 +08:00
1. Click ** + Add contact point**.
1. Enter a contact point name.
2024-07-02 23:21:29 +08:00
1. From the **Integration** list, select **Grafana OnCall** .
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
{{< admonition type = "note" > }}
The Grafana OnCall integration is only available for Grafana Alertmanager.
{{< / admonition > }}
2023-09-13 01:46:03 +08:00
1. Choose whether to add a new OnCall integration or add an existing one.
2023-09-12 22:46:13 +08:00
- If you add a new one, enter an Integration name.
2024-07-02 23:21:29 +08:00
- If you add an existing one, choose from the list of available integrations.
2023-09-13 01:46:03 +08:00
1. Click **Save contact point** .
2024-07-02 23:21:29 +08:00
1. On the contact points list view page, you should see a link to Grafana OnCall.
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
If the integration is not being used anywhere in the notification policies tree, it has **Unused** as its status in the **Health** column. It won’ t receive any notifications, because there are no notifications using that integration.
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
1. To see the integration details and test the integration, click the link to Grafana OnCall on the contact points list view page.
1. Click **Send demo alert** > **Send alert** .
1. Go to Grafana OnCall **Alert Groups** . You should see the demo alert.
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
## Next steps
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
The OnCall contact point is ready to receive alert notifications.
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
To add the contact point to your alert rule, complete the following next steps:
2023-09-12 22:46:13 +08:00
2024-07-02 23:21:29 +08:00
1. In Grafana, navigate to **Alerting** > **Alert rules** .
1. Edit or create a new alert rule.
1. Scroll down to the **Configure labels and notifications** section.
1. Under **Notifications** , click **Select contact point** .
1. From the drop-down menu, select the contact point you created.
1. Click **Save rule and exit** .