Skip to content

Escalation Guide

Purpose: Know when and how to escalate issues effectively.

When to Escalate

Escalation Criteria

Escalate When:

  1. Time Exceeded: Investigation taking longer than expected
  2. Expertise Needed: Issue requires expertise you don't have
  3. Business Impact: Issue affecting critical systems or users
  4. Resources Needed: Need additional resources or access
  5. Uncertainty: Unsure about next steps or solution

Don't Escalate Too Early

Try First:

  • Follow systematic debugging process
  • Use diagnostic tools
  • Check documentation
  • Review similar issues
  • Test hypotheses

Don't Escalate Too Late

Escalate Before:

  • Business impact increases
  • Too much time wasted
  • Customer satisfaction affected
  • Issue becomes critical

Escalation Process

Step 1: Prepare Escalation

Gather Information:

  • Problem description
  • Symptoms observed
  • Investigation done
  • Evidence collected
  • Hypotheses tested
  • What you've tried

Step 2: Document Issue

Create Issue Report:

  • Clear problem statement
  • Symptoms and observations
  • Investigation steps taken
  • Evidence and logs
  • Current hypothesis
  • What you need help with

Step 3: Choose Escalation Path

Escalation Levels:

  1. Team Lead: For guidance and direction
  2. Subject Matter Expert: For specific expertise
  3. Engineering Manager: For resource allocation
  4. On-Call Engineer: For urgent issues

Step 4: Communicate Effectively

Communication:

  • Be clear and concise
  • Provide context
  • Include evidence
  • Ask specific questions
  • Be open to guidance

Escalation Template

Issue Summary

Problem: [Clear, one-sentence description]

Impact: [Who/what is affected, severity]

Current Status: [What's happening now]

Investigation Done

Steps Taken:

  1. [Step 1]
  2. [Step 2]
  3. [Step 3]

Evidence Collected:

  • [Logs, events, metrics]
  • [Diagnostic output]
  • [Configuration checked]

Hypotheses Tested:

  • [Hypothesis 1] - [Result]
  • [Hypothesis 2] - [Result]
  • [Hypothesis 3] - [Result]

Current State

What Works:

  • [What's functioning]

What Doesn't Work:

  • [What's failing]

Error Messages:

  • [Key error messages]

What I Need

Help With:

  • [Specific question or guidance needed]

Resources Needed:

  • [Access, tools, information]

Timeline:

  • [When resolution needed]

Escalation Channels

Internal Escalation

Channels:

  • Slack: #engineering-support
  • Email: support@example.com
  • Ticket System: Create ticket
  • Phone: For urgent issues

External Escalation

For Customer Issues:

  • Follow customer escalation process
  • Notify customer of escalation
  • Provide status updates
  • Maintain communication

After Escalation

Stay Involved

Responsibilities:

  • Provide additional information
  • Test solutions
  • Document resolution
  • Learn from resolution

Document Resolution

Document:

  • Root cause
  • Resolution steps
  • Lessons learned
  • Prevention measures

Follow Up

Follow Up:

  • Verify resolution
  • Update runbooks
  • Share knowledge
  • Improve process

Escalation Best Practices

1. Be Prepared

Before Escalating:

  • Gather all information
  • Document investigation
  • Prepare clear summary
  • Know what you need

2. Be Specific

In Escalation:

  • Clear problem statement
  • Specific symptoms
  • Concrete evidence
  • Specific questions

3. Be Respectful

Communication:

  • Respect others' time
  • Be concise
  • Provide context
  • Be open to feedback

4. Learn and Improve

After Escalation:

  • Understand resolution
  • Learn from experience
  • Update knowledge
  • Improve skills

Common Escalation Scenarios

Scenario 1: Unknown Issue

Situation: Issue you've never seen before

Escalation:

  • Document investigation
  • Escalate to team lead or SME
  • Request guidance
  • Learn from resolution

Scenario 2: Complex Issue

Situation: Issue requires deep expertise

Escalation:

  • Escalate to subject matter expert
  • Provide all context
  • Request specific help
  • Learn from expert

Scenario 3: Urgent Issue

Situation: Critical business impact

Escalation:

  • Escalate immediately
  • Use urgent channel
  • Provide clear impact
  • Request priority

Scenario 4: Resource Constraint

Situation: Need additional resources

Escalation:

  • Escalate to manager
  • Explain resource need
  • Provide business case
  • Request allocation

Remember: Escalation is not failure—it's using resources effectively. Escalate when it's the right thing to do.

Released under the MIT License.