Configure a webhook in Grafana v8.x

Configure webhook endpoints so that Grafana can use the endpoint to communicate with Incident Response.

Before you begin

Ensure you have created an account in Grafana.

Role required: Responder, Manager, or Administrator

About this task

Note: While this integration with a third-party product is supported, the documentation here is based upon information provided by that third-party. More current information about the operation of that third-party’s system may be available from them directly.

Procedure

  1. Log in to the Grafana console.
    The Grafana v8.x landing page.
  2. On the navigation pane, click the bell icon (The bell icon.) and then click Alerting > Contact points.
    Alert contact point
  3. Under the Contact points section, click + New contact point.
    The Create contact point section appears.
    Add webhook URL.
  4. On the form, fill in the fields.
    Field Description
    Name Name for the contact point.
    Contact point type Select the type as Webhook.
    Url Webhook URL copied from Incident Response.
    Optional Webhook settings
    Http Method Select POST.
    Notification settings
    Options to manage your notifications.
  5. Click Test to verify whether a connection is being established between Grafana and Incident Response, to send events. This doesn't create an alert in Incident Response.
  6. Click Save contact point.

What to do next

Create alert rules and notification policies:
  1. In the left pane, click the dashboard icon (The Dashboard icon.) and under the Browse tab, select the dashboard.
  2. Select a panel and click Edit open the panel editor.
  3. Click the Alert tab.
  4. Click Create alert rule from this panel.

    The Create alert rule form appears.

  5. Under the Set a query and alert condition section, add alert conditions and then select the required alert condition.
  6. Under the Alert evaluation behavior section, add the alert evaluation interval.
  7. Under the Add details for your alert section, in the Group field, specify a pre-defined group.

    Rules within a group are run sequentially at a regular interval, with the same evaluation time.

  8. Under the Notifications section, in the Custom Labels, add severity and its value. For more information on severity, see Severity and state mappings for Grafana v8.x.

    Custom labels in notifications.

  9. Click Save.
  10. On the navigation pane, click the bell icon (The bell icon.) and then click Alerting > Notification policies.
  11. Choose any of the following ways to specify your contact point for the notifications:
    Notification policies Steps
    Root policy - default for all alerts
    1. Click Edit.
    2. In the Default contact point field, select the contact point that you have created.
    3. Click Save.
    Specific routing
    1. Click + New specific policy.
    2. Enter the matching labels that you have entered in the Notification section of the alert rule.
    3. In the Contact point field, select the contact point.
    4. Click Save policy.