Objective: teach a new engineer a repeatable, evidence-driven troubleshooting workflow: reproduce, gather data, isolate, fix, verify, and document. The exercise is 5 escalating steps; each step includes artifacts you expect the trainee to produce.Step 1 — Reproduce & Observe (easy)- Scenario: Customer reports “API returns 500 intermittently.”- Task: Reproduce locally or via staging and capture logs/metrics.- Synthetic log example:text
2025-11-01T14:23:12.345Z ERROR request_id=abc123 service=orders handler=CreateOrder status=500 err="db timeout" latency_ms=1203
- Expected artifact: a short incident note describing how/when you reproduced the error and a screenshot or log excerpt.Step 2 — Triage & Hypothesis (medium)- Add metrics: elevated DB latency, CPU normal, error rate spike at 14:20.- Task: Correlate logs + metrics to form hypotheses (e.g., DB connection pool exhausted, slow query).- Expected artifact: a prioritized hypothesis list with evidence (log lines, graph snippets) and next test plan.Step 3 — Isolate Root Cause (harder)- Add deeper logs: occasional "too many connections" and slow query traces.text
2025-11-01T14:20:58.001Z WARN service=db_connector pool_size=50 active=50 waiting=12 err="connection timeout"
- Task: Run targeted tests (simulate load, run EXPLAIN on query).- Expected artifact: RCA document stating root cause (e.g., unbounded fan-out creating connection storm + missing index) and reproduction steps.Step 4 — Implement Mitigation (advanced)- Task: Propose and implement temporary mitigation (circuit breaker, connection pool tuning, query tuning) in staging and validate.- Expected artifact: PR or runbook patch showing configuration changes, test results (error rate down, latency improved).Step 5 — Permanent Fix & Learning (leadership)- Task: Design permanent fix and preventive measures: schema/index change, rate limiting, alerts, SLO revision, and postmortem.- Expected artifact: Architecture note describing design changes, deployment plan, monitoring/alert thresholds, and updated runbook + short postmortem with action items and owners.Coaching tips:- Ask the engineer to narrate decisions and show evidence at each step.- Evaluate: clarity of hypotheses, testability, evidence linking cause→effect, risk assessment for mitigations, and quality of documentation.- Success = reproducible fix, measurable improvement in metrics, and updated runbook to prevent recurrence.