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

Incident lifecycle

The incident lifecycle covers the stages an incident moves through, from the moment it's triggered to when it's resolved.

Every incident on Spike moves through a defined set of stages. Understanding this flow helps you configure escalation policies, acknowledge timeouts, and alert channels to match how your team actually responds.

Incident lifecycle on Spike
The stages of an incident on Spike.

1. Incident creation

An incident is created when a connected integration sends a webhook to Spike. Before creating a new incident, Spike checks whether an open incident already exists for that integration.

  • If one exists, Spike logs the new event under the existing incident instead of creating a duplicate.

  • If no open incident exists, Spike creates a new one and starts the escalation process.

Only open incidents (triggered or acknowledged) are checked for duplicates. Resolved incidents are ignored.

2. Incident escalation

Once an incident is created, Spike works through the escalation policy attached to that integration. Alerts go out to the first set of responders in the policy. Spike waits for the duration configured in the escalation policy. If no one acknowledges or resolves the incident in that time, Spike moves to the next level and alerts the next set of responders.

Each integration can have its own escalation policy. This lets you set different alert priorities across services.

3. Incident acknowledgment

When a responder acknowledges the incident, Spike pauses the escalation policy and stops escalating alerts. You can set an acknowledge timeout for each integration: a time limit that moves the incident back to triggered and resumes alerting if it hasn't been resolved in time. You can also manually move an acknowledged incident back to triggered at any time.

4. Incident resolution

Once the issue is fixed, mark the incident as resolved. Spike stops all alerts and resets the escalation policy. If a new incident comes in for the same integration, the process starts again from the beginning.

See incident statuses for a full reference on each status.

Last updated