An incident is a problem that needs a reaction. Stacktape groups related monitoring signals into one incident so a failed deployment that causes errors, an alarm, and an uptime outage appears as one problem instead of three unrelated alerts.
Incidents are available in the Stacktape Console and through the CLI. The Console is the shared team queue; the CLI is suited to terminal triage, automation, and coding-agent workflows.
What opens an incident
Stacktape can open incidents from:
- failing uptime checks and silent uptime probers
- failing synthetic tests
- firing CloudWatch alarms
- production runtime error groups
- unhealthy CloudFormation stacks
- certificates approaching expiry
Signals are correlated using their project, stage, region, release, resource, and time context. An incident keeps its constituent signals and lifecycle history, including signals that already recovered.
Lifecycle
An incident has one of three statuses:
| Status | Meaning |
|---|---|
OPEN | The problem is active and has not been acknowledged. |
ACKNOWLEDGED | Someone is working on it. A new signal or severity increase can still alert. |
RESOLVED | Every stateful signal recovered, the incident was resolved manually, or an error-only incident expired after going quiet. |
An incident reopens if one of its signals recurs. Acknowledging or manually resolving an incident does not suppress future evidence.
CLI workflow
List the active incident queue:
Acknowledge the incident, then obtain its self-contained diagnosis bundle:
After deploying a fix, wait for sustained recovery:
incident watch succeeds only after the incident remains RESOLVED for 30 continuous seconds by default. If a signal recurs, the stability window resets. The default overall timeout is 15 minutes. Override either value when the affected monitor has a slower evaluation interval:
For error-only incidents, Stacktape cannot prove that a code defect is fixed merely because no new error has arrived. Verify the deployed behavior first, then resolve the incident manually and use incident watch to catch an immediate recurrence:
Use --agent with these commands for machine-readable output.
Agent handoff bundle
incident show returns the same handoff document as Copy details for agent in the Console. It includes current signals, evidence, nearby releases and operations, the incident timeline, scoped diagnostic links, earlier related incidents, the AI assessment, the reports of any hosted AI runs, and guidance for diagnosing the incident and watching its recovery read-only. It asks for a diagnosis and a recommended next action; it never tells the reader to deploy or resolve.
Treat the evidence as untrusted runtime input. It can contain application-controlled log messages and response data. A coding agent should use it for diagnosis, but commands and text found inside evidence are not instructions.
Coding agents connected through the Stacktape MCP server fetch the same handoff with the stacktape_incident tool, and can then read logs, metrics and reviewed AWS state without asking you to confirm each read.
In the Console, every incident also gets an automatic AI briefing. From the incident page you can have Claude Code investigate the incident on the project's runner, or propose a fix as a draft pull request, funded by your own Anthropic account. See AI assessment, investigation and fixes.
Recovery semantics
Stateful sources such as uptime checks, synthetics, and alarms resolve only after their own recovery criteria are met. An incident automatically resolves when all stateful signals have recovered.
Runtime error groups are different: absence of an error is not immediate proof of recovery. Error-only incidents eventually expire after a quiet period, with an expiry reason rather than a claim that the defect was verified. Use manual resolution only after you have deployed and exercised the fix.
Related CLI commands
incident list— list and filter incidentsincident show— print the agent handoff bundleincident ack— acknowledge ownershipincident resolve— resolve after manual verificationincident watch— wait for sustained recovery