Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Grafana OnCall integrations

Open source

Grafana OnCall integrations

Integrations allow you to connect monitoring systems of your choice to send alerts to Grafana OnCall. Regardless of where your alerts originate, you can configure alerts to be sent to Grafana OnCall for alert escalation and notification. Grafana OnCall receives alerts in JSON format via a POST request, OnCall then parses alert data using preconfigured alert templates to determine alert grouping, apply routes, and determine correct escalation.

There are many integrations that are directly supported by Grafana OnCall. Those that aren’t currently listed in the Integrations menu can be connected using the webhook integration and configured alert templates.

Configure and manage integrations

You can configure and manage your integrations from the Integrations tab in Grafana OnCall. The following sections describe how to configure and customize your integrations to ensure alerts are treated appropriately.

Connect an integration to Grafana OnCall

To configure an integration for Grafana OnCall:

In Grafana OnCall, navigate to the Integrations tab and click + New integration for receiving alerts.
Select an integration from the provided options, if the integration you want isn’t listed, then select Webhook.
Follow the configuration steps on the integration settings page.
Complete any necessary configurations in your tool to send alerts to Grafana OnCall.

Manage Grafana OnCall integrations

To manage existing integrations, navigate to the Integrations tab in Grafana OnCall and select the integration you want to manage.

Customize alert templates and grouping

To customize the alert template for an integration:

Select an integration from your list of enabled integrations in the Integrations tab.
Click Change alert template and grouping.
Select a template to edit from the Edit template for dropdown menu.
Edit alert templates as needed to customize the fields and content rendered for an alert.

To customize alert grouping for an integration:

Click Change alert template and grouping.
Select Alert Behavior from the dropdown menu next to Edit template for.
Edit the grouping id, acknowledge condition, and resolve condition templates as needed to customize your alert behavior.

For more information on alert templates, see Configure alerts templates

Add Routes

To add a route to an integration using regular expression:

Select an integration from your list of enabled integrations in the Integrations tab.
Click + Add Route.
Use python style regex to match on your alert content.
Click Create Route.
Select an escalation chain for “IF alert payload matches regex” and “ELSE” to specify where to route each type of alert.

Edit integration name

To edit the name of an integration:

Navigate to the Integrations tab, select an integration from the list of enabled integrations.
Click the pencil icon next to the integration name.
Provide a new name and click Update.

Delete integration

To delete an integration:

Select an integration from your list of enabled integrations in the Integrations tab.
Click the trash can icon next to the selected integration.
Confirm by clicking Delete.