Configure a webhook in Grafana

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 landing page.
  2. On the navigation pane, click the bell icon (The bell icon.) and then click Alerting > Notification channels.
    The Alerting page appears and the Notification channels tab is selected by default.
    The Notification channels page.
  3. Click New channel.
    The New notification channel form appears.
    The Notification channel form.
  4. On the form, fill in the fields.
    Field Description
    Name Name of the notification channel.
    Type Type of the notification channel.
    Note: Select the type as webhook.
    Url Webhook URL that you have already created.
    Optional Webhook settings
    Http Method Protocol to enable communication.
    Note: Select POST.
    Notification settings
    Options to manage your notifications.
  5. To verify your configuration, click Test.
  6. Click Save.
  7. On the navigation pane, click the dashboard icon (The dashboard icon.) and then click Manage.
    The page to create new dashboard or create existing dashboard.
  8. Perform any of the following actions:
    • To create a new dashboard, click New Dashboard, then click Add new panel.
    • Click an existing dashboard to which you want to add alert rules and conditions.
  9. Right-click on the required panel and click Edit.
    The Dashboard page.
  10. Click the Query tab and select the database on which you want to query.
    The Query tab on the Dashboard page.
  11. Provide the query values.
    In the panel, you can see the query values represented graphically.
  12. Click the Alert tab.
  13. Provide the rules and conditions for the alert.
    The Alert tab on the Dashboard page.
  14. In the Notification section, under Send to, click the plus icon (The plus icon.) and add the notification channel which you have created.
    The Notifications section on the Dashboard page.
  15. In the Tags section, add the following tags:
    • severity: Severity with which alert has to be created. This tag is optional.
    • count: The number of devices, hosts, or servers monitored by this alert rule. (This tag is mandatory otherwise the alerts will not close automatically in Lightstep Incident Response).
  16. Click Save.
    Alert rule is created.

What to do next

To access your alert rule, on the navigation pane, click the bell icon (The bell icon.) and then click Alerting > Alert Rules. You can check the state of the alert by clicking State history.