← Back to Insights

Debugging workflows

Escalate an Incident When Progress Stalls

Written by:Better SoftwareBetter Software TeamUpdated 7 min read
Escalate an Incident When Progress Stalls

Quick Answer

Engineers should escalate a production incident when their investigation stalls, the impact grows beyond the first assessment, or a predefined timebox expires. Escalation moves ownership to a broader or more senior group and limits prolonged degradation. A ten-step process sets a timebox, checks system health and access, assesses impact trajectory and documents every attempt. Clear runbooks, thresholds and escalation paths shorten incidents.

Engineers should escalate a production incident when their investigation reaches a standstill, the incident's impact increases beyond initial assessment, or predefined time limits for independent investigation expire. Escalation transfers ownership to a broader or more senior group. This ensures efficient resource allocation and minimizes prolonged system degradation.

Why Investigations Stall Without Escalation

Engineers investigate incidents within specific knowledge and context boundaries. Stalling occurs when these boundaries are met. The problem might involve an unfamiliar system component or cross-team dependencies. Escalation mechanisms are organizational safety nets. They prevent individual engineers from becoming bottlenecks. Incidents often reveal systemic weaknesses or unknown unknowns. These require diverse perspectives for resolution. Failing to escalate can prolong outages. It also increases the cognitive load on the initial responder. Uncontrolled incident growth can also impact more users or services. This necessitates a quicker, coordinated response than a single engineer can provide.

A Timeboxed Process for Deciding to Escalate

  1. Define initial investigation scope. Understand the reported symptom and its immediate blast radius. Identify the team most likely to own the affected component.
  2. Set an initial timebox for investigation. Allocate a specific, short period for independent diagnosis. This prevents long, unproductive digging without initial progress.
  3. Check immediate system health. Review dashboards for critical services. Look for obvious errors in logs. Confirm basic connectivity and resource utilization.
  4. Verify personal access and authorization. Ensure necessary permissions for debugging logs, metrics, or internal tools exist. Lack of access is a direct escalation trigger.
  5. Identify missing information or tools. Document what data or diagnostic tools are unavailable. This can be a reason to escalate for tool access or environmental insight.
  6. Assess impact trajectory. Determine if the incident is stable, worsening, or improving. Worsening impact demands faster escalation. Keep an eye on core metrics for production health.
  7. Evaluate knowledge gaps. Recognize when the problem extends beyond your team's expertise. Problems in shared infrastructure or external dependencies require escalation.
  8. Initiate communication with relevant teams. If the problem involves another team's domain, inform them proactively. This might be a horizontal escalation.
  9. Document all attempted actions and findings. Log everything for context. This context is crucial for the escalating team. This includes failed attempts and false leads.
  10. Trigger formal escalation. If the timebox expires without a clear path to resolution, or if impact widens, initiate the defined escalation protocol. Include all documented context. This reduces context switching costs for the next responders.

We would write the escalation protocol into product engineering practice for every production service.

A Practical Example With an Authentication Service

A Level 1 on-call engineer receives an alert for elevated latency from the authentication service. The service is critical for user logins. The engineer begins investigation. They check the authentication service's dashboard and logs. CPU utilization is high, but no obvious error messages appear. Database connection counts are normal. They spend time reviewing recent deployments. No related changes are found. The latency remains high. Login failures start appearing in the logs from dependent services. The engineer attempts to restart the authentication service instance. Latency briefly drops then returns. The problem persists for a while longer. The engineer lacks deep knowledge of the underlying message queue architecture used for authentication requests. They also do not have immediate access to message queue health dashboards. After a timeboxed investigation and seeing user login failures increasing, the engineer escalates. They contact the Level 2 on-call, who specializes in infrastructure and message queuing. The Level 1 engineer states the situation plainly. "Authentication service latency is high, CPU is high but no errors. Restarting didn't help. Login failures are growing. I suspect a message queue issue but lack visibility there." The Level 2 engineer then takes over. They quickly identify a saturated queue draining slowly due to a misconfigured worker pool in an unrelated service. The issue is resolved within minutes.

How to Reduce Escalation Delays

Organizations can reduce the need for specific escalation decisions. Establish clear runbooks for common incident types. Define explicit thresholds for automatic escalation. Instrument systems to identify potential resource exhaustion earlier. Implement an incident commander role for complex, multi-team incidents. Conduct thorough post-incident reviews to refine escalation policies. Improve cross-team training on system dependencies. This helps engineers recognize production issues with high prevention ROI. Ensure all engineers have consistent access to monitoring and logging tools. Automate diagnostic data collection for incidents. This reduces manual investigation time.

What Teams Usually Do Instead of Escalating

Teams frequently fall into non-escalation traps. An engineer might continue investigating alone for too long. They may believe they can find the solution independently. This leads to prolonged incident duration and increased impact. They might lack confidence in escalating. Some teams have an unclear escalation matrix. This results in confusion and delays rather than prompt action. Another common pattern is 'pinging' individuals directly instead of using formal channels. This bypasses the on-call rotation and can disturb engineers not on duty. It also relies on individual availability, which is not guaranteed. Some teams avoid escalation to avoid involving senior staff. This can stem from fear of judgment or appearing incompetent. However, delaying escalation causes more severe issues. It leads to more critical incidents and increased pressure. This ultimately costs more in time and resources.

Key Takeaways on Incident Escalation

  • Escalate when investigation progress stalls.
  • Set and adhere to a strict investigation timebox.
  • Escalate if the incident impact widens.
  • Document all findings before handing off.
  • Clear escalation paths reduce incident duration.

See how Better Software helps teams run reliable production systems.

Frequently Asked Questions

When Should an Engineer Escalate a Production Incident?

We escalate when the investigation reaches a standstill, when the impact grows beyond the initial assessment, or when the predefined time limit for independent investigation expires. Escalation transfers ownership to a broader or more senior group, which ensures efficient resource allocation and minimizes prolonged system degradation.

Why Do Investigations Stall?

We see engineers investigating within specific knowledge and context boundaries. Stalling happens when the problem involves an unfamiliar component, cross-team dependencies or missing access. Incidents also reveal unknown unknowns that need diverse perspectives, and failing to escalate prolongs outages and raises the load on the first responder.

What Should You Document Before Escalating?

We log every attempted action and finding, including failed attempts and false leads, along with the symptom, the blast radius and what information or tools were unavailable. That context reduces context switching costs for the next responders and lets the escalating team start from evidence.

What Mistakes Do Teams Make With Escalation?

We see engineers investigating alone for too long, unclear escalation matrices, and pinging individuals directly instead of using the on-call rotation. Some avoid escalating from fear of judgment. Delay causes more severe incidents and more pressure, and it ultimately costs more time and resources.

How Can Organizations Make Escalation Easier?

We establish clear runbooks for common incident types and explicit thresholds for automatic escalation. We add an incident commander role for complex multi-team incidents, refine policies through post-incident reviews, train across system dependencies, and automate diagnostic data collection to cut manual investigation time.

About the author

Better Software

Better Software Team

Product and engineering team

Better Software Team is the product and engineering team at Better Software. We build new software products and improve existing applications and systems, with deeper experience in healthcare, finance and energy.