이 페이지는 아직 한국어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Overview

A postmortem is a structured document that captures what happened during an incident, why it happened, and what actions to take to prevent recurrence. Generating a postmortem after an incident helps your team:

  • Document root cause and impact for future reference
  • Drive accountability for remediation work
  • Build organizational knowledge to reduce the frequency and severity of future incidents

Datadog automatically populates postmortems with incident data using templates you define. You can generate postmortems directly to Datadog Notebooks, Confluence, or Google Drive.

Permissions

  • To generate a postmortem, you need the Incidents Write permission.
  • To view a generated postmortem in Datadog Notebooks, you need the Notebooks Read permission.
For private incidents, postmortems generated in Datadog Notebooks are accessible to any user with Notebooks read permission, regardless of whether they have access to the private incident. Take this into consideration when generating postmortems for incidents that contain sensitive data.

Generate a postmortem

The Post-Incident tab with options to generate a new postmortem or attach an existing one

After an incident is resolved, a Generate post-mortem button appears on the incident. You can also generate a postmortem at any time from the incident’s Post-Incident tab.

To generate a postmortem:

  1. Open the incident and go to the Post-Incident tab.
  2. Click Generate new post-mortem.
  3. Select a postmortem template. A preview of the template appears on the right.
  4. Click Generate. Datadog creates the postmortem in the destination configured in the template and links it to the incident.

After generating a postmortem, click the link in the Post-Incident tab to open it in the configured destination.

Configure postmortem templates

A Postmortem editor with the Datadog Notebook selected as the Save Location

Postmortem templates define the structure of generated postmortems and control where they are saved. To create or edit templates, go to Incident Management Settings > Post-Mortem Templates.

Save location

Use the Save Location dropdown in the template editor to select where the generated document is saved:

OptionRequirements
Datadog NotebooksNo additional setup required.
ConfluenceRequires the Confluence integration. Configure your Confluence account in the integration settings before selecting it as a destination.
Google DriveRequires the Google Drive integration. Configure your Google account in the integration settings before selecting it as a destination.

Template variables

Templates support variables that populate with incident data when the postmortem is generated. Variables allow you to include relevant incident context automatically without copying it manually. For a full list of available variables, see the Incident Variables reference.

Standard variables pull directly from incident fields:

VariableDescription
{{incident.title}}The incident title
{{incident.state}}The current incident state (for example: active, stable, resolved)
{{incident.severity}}The incident severity level
{{incident.commander}}The incident commander’s name, or their email or handle if no name is set

Any custom property fields you have defined are also available as variables.

The incident card variable ({{incident.card}}) embeds a summary card that reflects incident fields in real time. When incident fields change, the card in the postmortem updates automatically, reducing the need to switch between the two. Note: The incident card is only supported in Datadog Notebooks.

AI variables use Bits AI to generate suggested content based on incident data. When you generate a postmortem that includes an AI variable, Datadog provides a suggested value that you can accept, edit, or reject before it is saved. The {{incident.ai_summary}} variable, for example, generates a suggested summary of what occurred during the incident.

Attach an existing postmortem

If a postmortem for an incident already exists outside of Datadog, or was created before the incident was opened, you can link it directly from the Post-Incident tab without generating a new one. The linked postmortem can be any URL—a Datadog Notebook, a Confluence page, a Google Doc, or any external document.

To attach an existing postmortem, open the Post-Incident tab and use the Attach existing post-mortem option to add the link.

Remove a postmortem

To remove a postmortem from an incident, open the Post-Incident tab, find the postmortem entry, and select the option to remove it. Removing the link does not delete the underlying document.

Further reading