IT Workplace Skills

Troubleshooting Methodically

A repeatable approach to diagnosing faults: define the problem, gather facts, form hypotheses, test one change at a time, then verify, document and learn.

On this page
  1. Why a method helps
  2. 1. Define the problem
  3. 2. Gather information
  4. 3. Narrow the scope
  5. 4. Form hypotheses
  6. 5. Test one change at a time
  7. 6. Verify the fix
  8. 7. Document and share
  9. Habits that help
  10. A short example

Why a method helps

When something breaks, the pull is toward doing something immediately: restart it, reinstall it, change a setting. Sometimes that works. When it does not, you may be left with a system that is both broken and different from before, and no idea what helped.

A method slows you down slightly at the start but usually speeds you up overall. It also makes your work explainable, which matters when you hand a problem to someone else or need to describe what you did. The steps below are a general pattern, not a rigid procedure. Adapt them to the situation.

1. Define the problem

Start by stating what is wrong in specific terms. “The network is slow” is vague. “Loading the internal website takes about a minute from the second floor, but not from the first” is something you can investigate.

Useful questions include:

  • What exactly is happening, and what did you expect to happen?
  • When did it start? Did it ever work?
  • Who or what is affected: one user, one device, a group, everyone?
  • Is it constant or intermittent?
  • What changed recently? Updates, new equipment, settings, a different location?

Ask for exact error messages and, if possible, screenshots. Users tend to paraphrase, and the exact wording often contains the clue. Listen carefully, because the first description is sometimes incomplete or mistaken.

2. Gather information

Before changing anything, collect facts. Look at the device, the service and the surrounding systems. Check:

  • Basic status: is it powered, connected, running?
  • Recent changes, including change records, which is one reason recording changes matters.
  • System logs, which often show errors with timestamps. Reading logs to find out what went wrong becomes easier with practice.
  • Whether other people or devices show the same fault.

Try to reproduce the problem. If you can make it happen on demand, testing becomes much simpler. If it only happens occasionally, note the patterns: times of day, particular actions, particular locations.

3. Narrow the scope

Divide the problem into smaller parts. This is sometimes called “divide and conquer.” If a user cannot reach a website, you could ask whether other sites work, whether the same site works from another device, and whether it works on another network. Each answer removes a large part of the search space.

Comparing a working case with a failing one is powerful. What differs between the machine that works and the one that does not? The difference is often the cause.

Many fault-finding tasks follow a layered idea. For network problems you can move from the physical connection, to addressing, to name lookup, to the application. Knowing how DNS lookups work, for instance, lets you tell a name-resolution problem from a connection problem. A fuller walkthrough is available under network troubleshooting.

4. Form hypotheses

Based on what you have learned, list the plausible causes. Rank them by how likely they are and how easy they are to check. Cheap, quick tests of likely causes usually come first, while expensive or risky tests wait.

Be willing to hold more than one idea at once. Fixing on your first guess is a well-known trap: you start looking only for evidence that supports it. Ask what you would expect to see if your hypothesis were true, and what you would expect if it were false.

5. Test one change at a time

This is the part most often skipped. If you change three things and the problem disappears, you do not know which one fixed it, and you may have introduced new problems along the way.

Make one change, observe the result, and either keep it or undo it. Before you start, note the original state so you can go back. In a business setting, anything beyond trivial changes may need a formal request and approval, so check your organization’s rules before making modifications to shared systems.

Take care with actions that can lose data. Deleting, reformatting or reinstalling should wait until you know that a good backup exists, ideally one you have confirmed through restore testing, and until you are sure nothing less drastic will work.

6. Verify the fix

When something seems to work, confirm it properly. Ask the user to repeat the original action. Check that related functions still work, and that the fix holds after a restart or after some time has passed. For intermittent faults, a single success proves little, so keep watching for a while.

Also consider whether you have fixed the cause or only a symptom. Clearing a full disk may get a service running, but if logs are filling it every week, the problem will return.

7. Document and share

Write down what the problem was, how you found it and what resolved it. Even a few lines in the ticket help the next person, who may be you in six months. Where a problem is likely to recur, turn the notes into a proper article in the knowledge base. Good documentation compounds: each solved problem makes the next one faster.

If appropriate, tell the affected user what happened in plain terms and what, if anything, they can do to avoid it.

Habits that help

  • Stay curious, not emotional. Frustration clouds judgment. If you are stuck, take a short break or explain the problem aloud to a colleague. Describing it often reveals what you have overlooked.
  • Check the simple things. Cables, power, restarts, and whether the issue is already known are not beneath you. Experienced engineers check these routinely.
  • Do not assume. “It can’t be the network” is a statement to test, not accept.
  • Know when to escalate. If you have spent a reasonable time without progress, or if the issue affects many people, bring in help and share your notes so they can start where you stopped.
  • Keep a lab for practice. Rehearsing on a spare environment builds speed and confidence without risk to real users.

A short example

Suppose a user reports that a shared printer is not working. You ask what happens and learn that print jobs queue but never print, and only from one laptop. That narrows the scope: the printer works for others, so the fault probably lies with the laptop or its connection to the printer.

Your hypotheses: the laptop has lost its network connection to the printer, the printer driver is damaged, or the print queue is stuck. You check the connection first because it is quick. It is fine. You clear the stuck queue, one change, and test a page. It prints. You verify with a second document, note the cause in the ticket and mention that stuck queues sometimes follow a laptop going to sleep mid-job. That is a modest, repeatable process, and it applies to far bigger problems too.

The complete guide to it workplace skills

Soft Skills Every IT Professional Needs
Read the guide

Keep exploring

Guides from other topics

All topics →