> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squasher.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana Alerting

> Turn Grafana webhook contact-point notifications into Squasher incidents.

The Grafana Alerting connector accepts Grafana's default webhook payload. It
correlates each alert independently and preserves Grafana labels, annotations,
dashboard links, panel links, and values for incident triage.

## Connect Grafana

<Steps>
  <Step title="Create the Squasher source">
    Create a **Grafana Alerting** source under **Settings → Integrations**. Copy the generated
    endpoint and secret.
  </Step>

  <Step title="Create a webhook contact point">
    In Grafana, open **Alerting → Contact points**, add a contact point, and choose **Webhook**. Set
    the URL to the Squasher endpoint and the HTTP method to `POST`.
  </Step>

  <Step title="Add authentication">
    Set **Authentication Header Scheme** to `Bearer` and **Authentication Header Credentials** to
    the Squasher secret. Do not place the secret in the URL.
  </Step>

  <Step title="Enable recovery notifications">
    Leave **Disable resolved message** off. Save the contact point and assign it to the relevant
    notification policy.
  </Step>

  <Step title="Send a test">
    Use Grafana's contact-point test, then verify a real firing and recovery pair from an alert
    rule.
  </Step>
</Steps>

## Incident behavior

* Each alert fingerprint is its stable alert key; grouped requests do not collapse
  unrelated alerts into one incident.
* `firing` opens or updates an incident and `resolved` resolves it.
* Grafana's title and message provide batch context. Per-alert labels and annotations
  provide the incident details.
* Dashboard, panel, silence, and generator URLs are retained when present.

## Troubleshooting

If a contact-point test succeeds but a rule does not notify, verify that the
notification policy selects the rule's labels. If incidents never resolve, make
sure resolved messages are enabled. Rotate the Squasher secret if it was exposed;
the old value remains valid for 24 hours while you update and verify the contact point.

Related: [Inbound alert connectors](/integrations/alert-connectors),
[Alert Connectors API](/api-reference/alert-connectors).