Diagnostics

The Technology Diagnostics Playbook

Most outages are resolved by following a method, not by having a hunch. This playbook lays out the diagnostic methodology used by experienced operators — isolating variables, prioritizing tests, and documenting along the way.

Technology Diagnostics Playbook: Methodology & Workflows · A practical methodology for diagnosing technology problems: how to isolate, prioritize, and resolve issues across networks, websites, and infrastructure. · /guides/technology-diagnostics

The diagnostic loop

  1. Observe — capture the symptom precisely (URL, time, region, user, error).
  2. Hypothesize — what's the cheapest test that would prove or disprove a likely cause?
  3. Test — run it, record the result.
  4. Decide — is the hypothesis confirmed, ruled out, or inconclusive?
  5. Repeat until the root cause is isolated.

Issue prioritization

When multiple things break at once: triage by blast radius first (how many users affected), then by reversibility (a failed deploy you can roll back is lower priority than data corruption that's spreading), then by stakeholder visibility. Communicate priority decisions explicitly so the team isn't fighting over what's next.

Network diagnostics workflow

  1. Confirm the destination is reachable (ping, server status).
  2. Trace the route to find which hop introduces problems.
  3. Check DNS — many "network" problems are name-resolution problems.
  4. Measure packet loss and jitter on the affected path.
  5. Compare from a known-good network to isolate local vs upstream.

Website diagnostics workflow

  1. Uptime check from multiple regions — is it down for everyone or just some?
  2. SSL and DNS validation — most surprise outages live here.
  3. Origin response time and status — does the server respond and how fast?
  4. Front-end audit — is the page rendering slowly or breaking client-side?
  5. Recent changes — what shipped in the last 24 hours?

Infrastructure diagnostics workflow

  1. Verify health checks across all components in the dependency graph.
  2. Inspect logs and metrics for the affected service and its immediate dependencies.
  3. Check provider status pages and recent maintenance windows.
  4. Test failover paths — does the redundancy you paid for actually work?
  5. Document the timeline as you go for the post-mortem.
Recommended next steps

Diagnostic workflow

  1. 1
    Start with status

    Confirm what's up and what's down from outside your network.

    Server status
  2. 2
    Check DNS and SSL

    Rule out the most common preventable causes.

    DNS lookup
  3. 3
    Trace the path

    Locate which hop is responsible.

    Ping & traceroute
  4. 4
    Save the workflow

    Capture what worked so you can reuse it next time.

    Open history

Frequently asked questions

What makes a good diagnostic methodology?

Three things: isolate variables one at a time, work from the cheapest test to the most expensive, and document each step so you can resume or hand off without re-doing work.

Where should I start when something breaks?

Always start by confirming the symptom — exactly what fails, for whom, and when. Half of all 'bugs' turn out to be misreported once you reproduce them precisely.

How do I prioritize multiple issues?

Sort by impact × frequency × reversibility. A rare issue with no workaround can outrank a daily annoyance. Always handle problems that block recovery first.

Should I follow a checklist or improvise?

Checklists for routine diagnostics (DNS errors, SSL expiry, slow page load). Improvise only after the checklist hasn't solved it — and add what you learned back to the checklist.

When is it time to escalate?

Escalate when (a) you've ruled out everything within your scope, (b) the issue is causing measurable business impact, or (c) you need access or change rights you don't have.

Continue reading

Educational guide. Diagnostic checks run entirely in your browser.