For the complete documentation index, see llms.txt. This page is also available as Markdown.

Postmortems

A postmortem is a document ilert drafts from the incident and you finish, keeps beside it, and can publish to your status pages.

When the impact has ended, the question changes from what is broken to why did this happen and what stops it happening again. Answering it normally means someone spending an afternoon reconstructing a timeline out of chat scrollback, alert emails, and memory.

A postmortem in ilert starts from what the incident already knows. ilert AI reads the timeline, the linked alerts, the correlated deployment events, and — if you let it — the incident channel, and drafts a document with five sections:

  1. Key information

  2. Timeline

  3. Impact

  4. Root cause analysis

  5. Action items

The draft is a starting point, not an answer. What follows is yours to edit.

Beta. The generation dialog is marked BETA, and its behaviour may still change.

Generate one

The offer appears in two places, and they produce the same thing:

  • on the Before you resolve checklist, as Generate a postmortem with AI now;

  • on a resolved incident that has no postmortem yet, as a Next step · Wrap up banner offering Generate with AI.

A resolved ilert incident with a Next step, Wrap up banner reading Generate the postmortem — ilert AI drafts it from the timeline, linked alerts and correlated deploys — beside a Generate with AI button.
The prompt arrives when the incident is over, which is when anyone has the attention for it.

The banner knows when not to ask: it stays away from a SEV4 or SEV5 incident that lasted 30 minutes or less. You can still generate one — nobody is stopped, they are just not nagged about a short, minor incident.

Either opens a dialog that asks what to read.

The Generate postmortem using ilert AI dialog: the five sections it will produce, a checklist of alerts to take into account, a collapsed option to paste a chat transcript, and optional Impact, Root cause and Action items fields.
Sections that have nothing to offer are hidden: no linked channel, no channel question.
Choice
Why it matters

Which alerts to take into account

Only alerts linked to the incident are offered. Including them is what produces technically specific action items rather than generic ones

Which chat channels to analyze

The ilert bot reads the incident channel and pulls out what mattered. You can also paste a transcript from anywhere else — timestamps and usernames in any raw shape are parsed

Deployments

The deployments correlated with the incident, so "we shipped the auth change 20 minutes before" ends up in the timeline

Impact, root cause, action items

Three optional free-text fields. What you write here is weighted more heavily than what the AI infers, so use them for what you already know

Generation is queued rather than instant — the sources have to be fetched, paginated, and read — so the document appears a moment later.

Edit it

When the document is ready, a card appears on the incident with its number, status and owner, and Open postmortem takes you into it.

A postmortem card on an ilert incident, showing the word Postmortem with a DRAFT lozenge, the postmortem number and its owner, and an Open postmortem button at the right.
The card stays on the incident, so the write-up is always one click from the record it describes.

A postmortem is an ordinary document with a title and sections, edited in ilert. Markdown works, there is a formatting toolbar, and changes save themselves as you type: the header shows Saving… and then Saved.

Add section puts a new one at the end. Sections can be renamed and deleted; deleting one is confirmed first, because it is not undoable.

Above the body sits a key-information block ilert fills in from the incident and keeps in step: Incident, Severity, Duration, Occurred, Responders, Affected services.

A Preview panel runs down the right-hand side showing the rendered document as you edit it, with a download button in its corner for taking a copy elsewhere.

Statuses

Status
Means

AI draft

Generated and untouched

Draft

Somebody has worked on it

In review

Waiting on someone to read it

Published

Final

The Status control reads Draft while the document is still an AI draft. What tells them apart is the purple AI draft badge beside the title, which disappears once somebody moves the document along.

Every postmortem in the account is listed under Postmortems — in the sidebar under Catalog, and as a tab beside Incidents. Each row carries its linked incident, severity, owner, status and creation date, and the list filters by status, owner and severity. It is the view to open when you want to know what has actually been written up, rather than what people meant to write up.

The ilert Postmortems list, a tab beside Incidents, with Search, Status, Owner and Severity filters above rows showing the postmortem number and title, its incident, severity, owner, status and creation date.
One row per postmortem, each pointing back at the incident it came from.

Publish it

Publishing is a separate decision from finishing the document, and it has two settings.

Setting
Effect

Internal only

The default. Visible to your organization in the Postmortems list, and nowhere else

Also on status pages

Surfaces the postmortem as a post-incident report on the status pages this incident appeared on

The Publishing section of an ilert postmortem: a note that it is available once the postmortem is Published, with Internal only selected and Also on status pages as the alternative.
Internal only is the default, and the section says up front that neither setting does anything yet.

Choosing status pages then asks for a Status page visibility scope: public and private pages, or private pages only — which is how you give a post-incident report to named customers without putting it on the open internet.

Neither option is available until the postmortem's status is Published. Up to that point it is internal whatever the publishing settings say.

Last updated

Was this helpful?