How work reaches it
- Sentry sends an alert rule’s notification, signed with your integration’s client secret.
- PagerDuty sends
incident.triggered(investigated) andincident.resolved(a postmortem to draft), signed with your webhook subscription’s secret. - Your monitoring, such as Grafana alerting, sends an alert with an API key (Send an alert).
- A person hands one over on the DevOps page, or asks for a postmortem there.
What an investigation does
- Reads the evidence for the service the alert names: error rate and latency, recent log lines and recent deploys; for an alert from Sentry, the issue and its latest event — exception, release and stack frames; for one from PagerDuty, the incident and its timeline. Reads need no approval.
-
Numbers each piece of evidence (
E1,E2…), quoting what the tool reported. -
Names a likely cause and says how sure it is. Confidence comes from which structured signals
agree, never from what any text says:
Even “high” is written as a hypothesis, with what would confirm or rule it out.
- Says what it did not read — a tool that is not connected, a service with no data — so a missing tool is never mistaken for a clean bill.
- Asks your knowledge for the runbook, when an assistant is set.
- Proposes next steps, each waiting for your approval.
What it proposes
An approved rollback or restart is recorded and nothing is sent. No connection carries a fix
to your systems. Nothing here resolves a PagerDuty incident: only a note and an
acknowledgement, each approved by a person.
Postmortems
When PagerDuty reports an incident resolved — or when you choose Draft a postmortem beside an alert on the DevOps page — it drafts one:- Summary and impact: duration from the incident’s timeline, the peak error rate in the hour before the draft, urgency, and who was affected (left for you to fill in).
- Timeline in UTC: deploys, the error-rate rise, when Sentry first saw the error, and PagerDuty’s own log entries.
- Cause, with the same confidence statement, and the evidence.
- Action items for your team to agree.
Tools it can connect
Connect your tools has the steps for each.
Limits
- It never runs a fix, and never resolves an incident.
- The cause is a heuristic over structured signals. It says so, and says how sure it is.
- Metrics and logs cover the last hour before the investigation or draft.
- A Sentry issue is read only when Sentry sent the alert. An alert from elsewhere does not search Sentry.
- PagerDuty’s US service region only (
api.pagerduty.com); an EU account cannot be connected yet. - A self-hosted Sentry must be reachable from the internet over https; a private address is refused.