# Alert to runbook revision records | SourceX

Canonical: https://refer.sourcex.si/guides/chain-alert-to-runbook-revision
Last updated: 2026-11-04

A company connects alert-to-runbook-revision records by tying each Datadog monitor alert to the PagerDuty incident it opened, the responder's notes and postmortem, and the Confluence runbook version that changed because of it. The links are monitor IDs, incident numbers, timestamps and page version comments. A referral partner can describe which links exist, for which years, and who owns them, without opening an alert or a runbook. The trail usually breaks when an alert clears before the underlying fault is fixed.

## The business task: turning an incident into a better runbook

An engineering team gets paged, stabilizes a service, works out what really went wrong and rewrites the instructions so the next responder does better. The record of that loop, from signal to response to corrected procedure, shows how experienced people diagnose a live problem and what they learned from it. That kind of operational judgment is thin in public data, which is why [what data is missing from AI training](/questions/what-data-is-missing-from-ai-training) puts incident and procedure histories near the top of the list.

The loop is spread across three tools. Datadog holds monitors and their alert and recovery events. PagerDuty holds incidents and a log of what happened to each one: integration event data, who was notified and how, who acknowledged and resolved it, automatic actions, reassignments and notes. Confluence holds the postmortem and the runbook, and its page history lists each version's date, author and comment, with any two versions open to comparison.

## How can a company connect alert-to-runbook-revision records across systems?

It connects them in three hops: monitor to incident by the integration's link, incident to postmortem by the incident number written into the page, and postmortem to runbook by the version comment or a link. The first hop is usually automatic. The other two depend on team habit.

| Hop | From | To | Join that exists by design | Join that depends on people |
|---|---|---|---|---|
| 1 | Datadog monitor alert | PagerDuty incident | Integration handle in the monitor notification | Which monitor fired, if several share a service |
| 2 | PagerDuty incident | Confluence postmortem | None in Confluence by default | Incident number typed into the page |
| 3 | Postmortem | Runbook page version | None | Link or comment on the runbook edit |
| 4 | Runbook version | Later incident | None | Responder notes that cite the step used |

Hop 4 is the one most teams forget. It is the evidence that the revised runbook actually worked, and it only exists if a responder on a later incident wrote down which step they followed.

### One joined timeline (Illustrative)

The timeline below follows one fault at a fictional 400-person software company, as drawn in the graphic above. Every value is Illustrative.

| When | System | Event | What joins it to the previous row |
|---|---|---|---|
| Night 1, 02:10 | Datadog | Latency monitor alerts on the payments API | Monitor ID |
| Night 1, 02:11 | PagerDuty | Incident #1 opens and pages the on-call engineer | Integration handle in the alert message |
| Night 1, 02:27 | Datadog and PagerDuty | Latency drops; the recovery resolves incident #1 after 17 minutes | Recovery notification |
| Night 2, 01:52 | PagerDuty | Same monitor fires again; incident #2 opens | Nothing links it to #1 |
| Day 3 | Confluence | Postmortem names a connection pool leak and cites #1 and #2 | Incident numbers typed into the page |
| Day 6 | Confluence | Runbook moves from v14 to v15, version comment cites the postmortem | Version comment |
| Day 6 | Platform team | Fix deployed; the fault, open since night 1, ends | Deploy note in the postmortem |
| Day 9 | PagerDuty | Incident #3 resolved using the new v15 step, noted by the responder | Responder note citing v15 |

Read top to bottom, the chain says something no single tool says: one fault lasted about six days, the alert clock showed 17 minutes, and the runbook change was validated three days after it was made.

## What breaks when an alert clears before the problem is fixed

The first hop works so smoothly that it can hide the fault. Datadog's documentation says that when a PagerDuty handle is included in a monitor's recovery message, the recovery automatically resolves the linked incident. So a symptom that dips below its threshold closes the incident even if the cause is still there.

When the symptom returns, PagerDuty treats it as new. Its Events API documentation says a new trigger event with the same deduplication key as a resolved incident does not reopen it. The second page becomes incident #2, with no field pointing back to #1. In the incident system alone, one long fault looks like two short, unrelated ones.

Only people repair that: a postmortem that lists both incident numbers, and a runbook version comment that cites the postmortem. When a partner asks a sponsor about this chain, the useful questions are plain ones. Do postmortems name every related incident? Do runbook edits say why they were made? Since roughly when? The answers decide how much of the history can be joined, and none of them requires reading a page.

## Who should a partner introduce, and what stays unknown?

The SRE lead or platform engineering manager can describe the chain; the CEO has to authorize a licensing discussion, usually with the CTO, COO or general counsel advising, because incident notes and runbooks can mention customers, vendors and security controls. The [incident and on-call field guide](/guides/a-partner-field-guide-to-finding-companies-with-incident-and-on-call-records), the [introduction checklist for incident records](/resources/a-company-introduction-checklist-for-incident-and-on-call-records) and the [SOPs and runbooks guide](/guides/a-partner-field-guide-to-finding-companies-with-sops-and-runbooks) cover who to approach. For page version histories more broadly, see the [document revision histories guide](/guides/a-partner-field-guide-to-finding-companies-with-document-revision-histories); for exports, the [PagerDuty incident export page](/systems/pagerduty-export-incidents) and the [Confluence page](/systems/confluence).

The company baseline: 50+ full-time employees at peak (contractors excluded), documented operating history, rights to license, and an authorized contact. Companies in the U.S., Canada and the EU qualify, as do companies in the UK, Australia, New Zealand, India, Singapore, South Africa, Latin America, the UAE and Saudi Arabia when at least 70% of the data is in English.

Unknown until SourceX reviews it under the company's own agreement: whether the company's rights cover the records, what must be removed for security reasons, how complete each hop is, and whether a buyer wants the result. Partners never ask for or handle raw incident data or runbook text. SourceX does not claim a connector for every tool named here, and a partner should not promise one. More record locations are in the [systems hub](/systems).

## Go deeper on alert-to-runbook-revision records

- [What one tool's export of this chain leaves out](/guides/alert-to-runbook-revision-missing-context): the same Illustrative incident read before and after its surrounding context is added.
- [Alert-to-runbook-revision metadata packet](/resources/alert-to-runbook-revision-metadata-packet): the counts, date ranges, systems and owners a partner can share, with a filled Illustrative packet.
- [Alert-to-runbook-revision completeness checklist](/resources/alert-to-runbook-revision-completeness-checklist): a pass, partial or fail scorecard for judging whether the records are complete enough to discuss.

## Next step

> **Refer a company. No cap on rewards.** Default reward on a company's first qualifying transaction: the greater of $50,000 plus 5% and 15% of Actual Supplier Payout, with no cap; further qualifying transactions first agreed within 12 months of the first Closing pay 15%. Eligibility and payment conditions apply, including the USD 100,000 Minimum Transaction, and a signed Schedule A or addendum can differ. A lead, meeting or signature alone does not trigger payment.

If an engineering team you advise can show, at the metadata level, that its incidents lead to recorded runbook changes and an officer will take the call, [register as a partner](/register), check the company against [who qualifies](/who-qualifies), and read the [terms](/terms) before you submit.

## Sources

- https://docs.datadoghq.com/integrations/pagerduty/
- https://developer.pagerduty.com/docs/88922dc5e1ad1-overview-v2-webhooks
- https://developer.pagerduty.com/docs/trigger-events
- https://support.atlassian.com/confluence-cloud/docs/create-edit-and-publish-a-page/
- https://refer.sourcex.si/terms
