Incident Management
Incident Management keeps the record and the roles on a single screen, from declaring an outage through resolving it to writing the retrospective. It handles state, severity, the commander, the timeline, and Slack integration, and pricing is determined by seats for the number of people who edit the record.
What it does
You declare an outage as an incident, give it a title, a severity, and an Incident Commander, and advance its state from Active to Stable to Resolved while stacking comments, graphs, and links on the timeline. It synchronizes with a Slack channel, and after resolution it generates a postmortem from a template so that statistics such as response time can be aggregated later.
When to use it
Use it when you want to end the situation where Slack scrolls past during every outage and by the next day nobody can trace who decided what. Typical operations are declaring the moment a monitor fires so the record starts immediately, deciding whom to call by severity, producing the retrospective document from the same record after resolution, and counting how many outages were closed per month and in how many minutes.
An everyday analogy
It is the whiteboard in a disaster response headquarters. The time of occurrence, the extent of the damage, the head of headquarters, and each team's assignments and reports are added to one board with timestamps, and people who are not in the room receive a copy of the same board. Once the situation settles, the contents of the board become the draft of the review report as-is. Without the board, the response is scattered across individual memories and private phone calls.
The Bottom Line - Keep Everything from Declaration to Retrospective on One Screen, and Pay per Person
Events and alerts are records of what happened to the system; an incident is a record of how people responded. Datadog Incident Management takes on the latter, keeping on a single screen everything from the time the outage was declared through who commanded, what was decided, when it settled, and what was learned. No installation is required to adopt it; it is usable from the moment you declare an incident (as of September 2026; source: Incident Management). Because it lives in the same place as monitors and dashboards, you can paste the graph you were looking at during the response straight into the record, and later reconstruct which graph you looked at when you made a decision. Pricing is determined not by the number of monitored hosts but by the number of people who edit the record, in other words the number of seats. Below we walk through, in order, how states progress, the fields filled in at declaration, the entry points for declaring, how the record accumulates, the division of labor with On-Call, how seats are counted, and how to run retrospectives.
States Progress in Three Stages: Active / Stable / Resolved
An incident has three states by default, and their meanings are defined in the official documentation. Active is the state in which others are being affected, Stable is the state in which the impact has stopped but the investigation is not finished, and Resolved is the state in which the impact has stopped and the investigation is also complete. You can add a state called Completed in the settings, and the description text for each state can be customized (as of September 2026; source: Describe an Incident). The key point is the separation of Active and Stable. Because you can name the intermediate state of no longer causing impact but the cause is not yet known, the split in which reporting to executives settles down once at Stable while the technical side continues investigating toward Resolved holds up in the record.
What You Fill In at Declaration Is Title, Severity, and Commander
The declaration modal has three central fields: the title (required), the severity (required), and the Incident Commander who leads the response. Severity has five levels by default, from SEV-1 (most severe) to SEV-5 (least severe), and the number of levels and their descriptions can be changed in the settings. The declaration fields can be extended in the settings, and items such as state, impact, root cause, detection method, and affected services can be updated later. You can define and use your own responder roles to organize the response team (as of September 2026; source: Declare an Incident and Incident Management). Since the severity description text is something the organization decides, here we show only the skeleton for deciding it.
| Aspect to Decide | Question | Example of What to Write in the Description |
|---|---|---|
| Extent of impact | All users, some features, or internal only? | SEV-1 = the primary user flow is down for all users |
| Persistence of impact | Is it still ongoing, is there a workaround? | SEV-3 = a workaround exists and users can accomplish their goal |
| Who to call | How far up do you call at that severity? | SEV-1 and SEV-2 page the team through On-Call |
Deciding just one rule for when you are unsure about severity makes declaration faster. A rule that assumes you can lower it later, such as when in doubt, declare one level higher and lower it at the point you move to Stable.
Where Can You Declare From?
There is more than one entry point for declaring. The official documentation lists declaration from the incident list screen, monitors, security signals, leaked secrets, cases, graphs, Synthetic tests, the Datadog clipboard, On-Call pages, Slack, Google Chat, and handoff notifications (as of September 2026; source: Declare an Incident). The two used most often in practice are monitors and Slack.
| Entry Point | Behavior |
|---|---|
| Monitor (manual) | Declare with Declare incident on the monitor screen, and that monitor is attached to the incident as a signal. It can also be added to an existing incident |
| Monitor (automatic) | Selecting Add Incident in the monitor's notification settings declares automatically on transition to warn / alert / no data. Field values are inherited from the monitor's tags |
| Slack | If the Datadog Slack integration is enabled, type /datadog incident in any channel to declare. The declarer who has connected Slack and Datadog becomes the default Incident Commander, and a dedicated incident channel is created |
| Graph / Synthetic test / On-Call page | Declare directly from the screen you were viewing, and what you were viewing is attached to the record |
The reason there are so many entry points is that a delay in declaring translates directly into a gap in the record. With a we will register it formally later approach, the decisions of the first 30 minutes are not preserved. Automatic declaration from monitors is a means of having the machine fill in those 30 minutes. However, attaching automatic declaration to every monitor buries the record in noise, so limiting it to monitors that merit high severity is the sensible course.
The Timeline and Slack Gather the Record in One Place
The body of the record is the timeline. Comments, graphs, and links are stacked with timestamps, and changes to state and severity are also preserved here. When you declare from Slack, a dedicated incident channel is created, and messages in that channel are synchronized to the timeline. Notifications to stakeholders can be configured, so you can keep interested parties informed of the progress of the response (as of September 2026; source: Incident Management and Declare an Incident).
| Integration | Relationship to the Incident |
|---|---|
| Status Pages | Create a public or private status page and connect it to the incident |
| On-Call | Escalate a page to an incident. Page a team manually or automatically from the incident |
| Notebooks | Drafting and reviewing postmortems |
| Workflow Automation | Build and run automated processing related to the incident |
| Incident Analytics | Aggregate time to resolution and user impact from past incidents, and track them with graph widgets on dashboards |
What matters here is that you do not have to give up Slack. The conversation of the response stays in Slack, and the authoritative record lives on the incident timeline. With these two layers, the work of scrolling up and down Slack the next day to trace who decided what disappears.
On-Call Pages, Incident Management Records and Closes
On-Call and Incident Management sit on the same Incident Response branch and are divided by role. On-Call is the feature that decides which on-duty person to page right now and delivers the page; Incident Management is the feature that preserves what happened after the page and how it was closed. The touchpoints run in both directions: you can escalate an On-Call page to an incident, and you can page a team manually or automatically from within an incident (as of September 2026; source: Incident Management).
- A monitor fires → On-Call delivers a page to the on-duty responder (paging)
- The responder acknowledges the page and judges that there is impact → escalates the page to an incident (declaration). State is Active (impact continues)
- Incident Management records state, severity, commander, and timeline → pages another team through On-Call if needed
- Impact stops (a workaround or rollback took effect) but investigation remains → Stable
- Investigation also complete → Resolved. The optional Completed state added in settings can be used as the milestone for having finished the retrospective too
- Generate a postmortem from the Post-Incident tab (retrospective)
Either one works on its own. An organization whose paging already runs on existing tools and is missing only the record can start with Incident Management; conversely, an organization whose record is adequately kept in Slack and spreadsheets but whose night-time paging is manual will naturally start with On-Call. If you use both, the bundled SKU in the next section comes into play.
Pricing Is per Seat - Count Only the People Who Edit the Record
The official documentation enumerates which operations require a seat and which do not. This distinction is the same whether in the Datadog UI or through the Slack or Microsoft Teams integration (as of September 2026; source: Incident Response Billing).
- Requires a seat: modifying an incident (updating severity, etc.) / deleting / adding comments, graphs, or links to the timeline / assigning tasks (the assignee does not need one) / assigning responders to custom roles (the assignee also needs one)
- Does not require a seat: creating an incident / viewing / joining the channel / commenting in Slack (including messages synchronized to the timeline)
| SKU | Billing unit | Contract forms | Bundling and cautions |
|---|---|---|---|
| Incident Management standalone | Seat / month | Annual / monthly / on-demand | Incident management only |
| On-Call standalone | Seat / month | Same as above | On-call only |
| Incident Response bundle | Seat / month | Same as above | Includes both. For a person who uses both, it is set at a lower unit price than the sum of the two standalone SKUs |
Reading it takes one line. If the same person both receives pages and edits the record, the bundle that includes both comes in lower than adding the two standalone SKUs, and people who do only one of the two get the corresponding standalone SKU. For where this sits within the overall pricing, see how to read the pricing structure. This article explains how billing works. For current unit prices and plans, refer to Datadog's official pricing page.
The Minimum Rules for Running Retrospectives
A postmortem is a structured document of what happened, why it happened, and what will be done to prevent recurrence. After Resolved, when you select a template on the Post-Incident tab and generate one, the incident data is poured in and a document is created in the configured destination such as Notebooks or Confluence and linked to the incident (as of September 2026; source: Postmortems). Generation is a single operation, but whether retrospectives actually run is determined by the rules before and after it.
- At declaration: do not leave title, severity, or commander empty. A record moved to Resolved with them empty is not material for a retrospective
- During response: the moment a decision changes (rollback, revised scope of impact), leave one line on the timeline. Do not leave it only in the Slack conversation
- After Resolved: set a deadline (for example, 3 business days) to generate the postmortem, and turn recurrence-prevention work into tasks with named owners
- Monthly: look at counts and time to resolution in Incident Analytics, and review whether the severity descriptions match reality
The second one is the most effective. The quality of a postmortem is determined not by writing skill but by the number of decision lines left during the response. If your organization operates SLOs, you can also prioritize retrospectives starting from the outages that consumed the most error budget. Whereas Error Tracking tracks bundles of the same error, what Incident Management tracks is the human response to a single outage. Read them apart: the cause side is Error Tracking, and the decision side is the incident timeline.
Things to watch out for
- This article is based on the official documentation as of September 2026. State names, severity levels, declaration entry points, and the definition of operations that require a seat may change, so confirm the official documentation before configuring.
- This article explains how billing works. For current unit prices and plans, refer to Datadog's official pricing page. The SKU structure is based on the official pricing page as of August 2026.
- The severity (SEV-1 through SEV-5) description text is configured by each organization, and the examples in this article are not official definitions.