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.

You can set up the integration using the Grafana Alerting application or the Grafana OnCall application. For more information on setting it up from the Grafana OnCall application, see Grafana OnCall documentation.

Before you begin

  • Ensure you have Installed and enabled the Grafana OnCall plugin

  • 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 can see the contact point with the Grafana OnCall icon.

    If the integration is not yet being used anywhere in the notification policies tree, it will have Unused as its status in the Health column. It won’t receive any notifications, because there are no notifications using that integration.

  8. Connect your contact point to a notification policy.

    For more information on connecting your contact point to a notification policy, see Create notification policy.

  9. To view your integration in the Grafana OnCall application and set up routes and escalation chains, click the Link next to the integration on the Contact points list view page in the Type column.

    This redirects you to the Grafana OnCall integration page in the Grafana OnCall application. From there, you can add routes and escalation chains.