Set up
Your URL is in the Pagerless app under Other tools, with the key filled in:
https://events.pagerless.dev/v1/hooks/sentry/<your ingest key>Open Settings, Developer settings, Internal integration
In Sentry.
Create an internal integration with your Pagerless URL as the webhook.
Turn on Alert Rule Action and Issue webhooks.
Save the integration's client secret in Pagerless; unsigned deliveries are refused from then on.
Add the integration as an action on your alert rules.
What happens
| When | Pagerless |
|---|---|
| Fires | Issue alerts, and metric alerts at critical or warning |
| Clears | The issue resolved, or the metric alert resolved |
| How loud | Fatal wakes; error and warning tell; info and debug log |
| Proof it's you | Sentry-Hook-Signature HMAC with the client secret, required once saved. |
Keep Sentry for debugging; let Pagerless decide who to wake and how. See Pagerless vs Sentry alerts.
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.