Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Alertingbreadcrumb arrow Configure notificationsbreadcrumb arrow Configure contact pointsbreadcrumb arrow Grafana OnCall
Grafana Cloud Enterprise Open source

Configure Grafana OnCall for Alerting

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.

Note

You can also configure the integration from Grafana OnCall. For more information, refer to Grafana OnCall documentation.

Before you begin

Grafana OnCall is available in Grafana Cloud by default.

If you are using Grafana OSS, install and enable the Grafana OnCall plugin. Also, ensure your version of Grafana is up-to-date and supports the new features.

Procedure

To set up the Grafana OnCall integration using the Grafana Alerting application, complete the following steps.

  1. Navigate to Alerts & IRM -> Alerting -> Contact points.

  2. Click + Add contact point.

  3. Enter a contact point name.

  4. From the Integration list, select Grafana OnCall.

    Note

    The Grafana OnCall integration is only available for Grafana Alertmanager.

  5. Choose whether to add a new OnCall integration or add an existing one.

    • If you add a new one, enter an Integration name.
    • If you add an existing one, choose from the list of available integrations.

  6. Click Save contact point.

  7. On the contact points list view page, you should see a link to Grafana OnCall.

    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.

  8. To see the integration details and test the integration, click the link to Grafana OnCall on the contact points list view page.

  9. Click Send demo alert > Send alert.

  10. Go to Grafana OnCall Alert Groups. You should see the demo alert.

Next steps

The OnCall contact point is ready to receive alert notifications.

To add the contact point to your alert rule, complete the following next steps:

  1. In Grafana, navigate to Alerting > Alert rules.
  2. Edit or create a new alert rule.
  3. Scroll down to the Configure labels and notifications section.
  4. Under Notifications, click Select contact point.
  5. From the drop-down menu, select the contact point you created.
  6. Click Save rule and exit.