# Grafana to Pagerless

> Paste one URL into Grafana. Pagerless decides who to wake, explains it in plain words and closes the problem when Grafana says it's fixed.

URL: https://pagerless.dev/integrations/grafana
Updated: 2026-10-22

## Set up

Your URL is in the Pagerless app under Other tools, with the key filled in:

```text
https://events.pagerless.dev/v1/hooks/grafana/<your ingest key>
```

1. **Open Alerting, Contact points, Webhook** In Grafana.
2. **Create a Webhook contact point with your Pagerless URL.** 
3. **Optional: set the HMAC secret to your ingest key.** 
4. **Use the contact point in a notification policy.** 

## What happens

| When | Pagerless |
| --- | --- |
| Fires | Firing alerts (unified alerting), or state alerting (legacy) |
| Clears | Resolved, or ok (legacy) |
| How loud | The `severity` label (legacy: the severity tag) |
| Proof it's you | Optional HMAC signature (`X-Grafana-Alerting-Signature`), checked when sent. |

## Choosing who gets woken

| Rule | Example |
| --- | --- |
| Name rules on the URL | `?wake=prod-*&log=*-staging` (globs, case-insensitive) |
| The tool's own severity | critical, p1, sev1, fatal wake; error, warning tell; info, low log |
| A default on the URL | `?level=wake` (or tell, log). Without one: tell. |

`?service=` and `?env=` set the service and environment shown on the problem.