The SOAP Method of Network Troubleshooting: Structured Analysis
- Doctor Network
- Just the Facts
- SOAP in the Real World
The road to wisdom?
Well it's plain
and simple to express:
and err again
I hope you've liked all the note taking involved in the last hour because the method of troubleshooting in this hour involves a great deal more of it.
Treating a complex problem usually involves a lot of note taking because you have to fill in the gaps where your understanding of the problem is incomplete. Up until now, you've treated problems the way you treat a multiple-choice testwith change analysis, divisive reasoning, and matching. Now, we're talking about a fill-in-the-blank test, and it gets a little bit harder; this is the hour in which you have to wade through the subjective, match it up with the objective, analyze your data, and plan on what to do next. In other words, this is the technique you want to refer to for tough problems. You can think of it as writing a journal much in the same way that adolescents do: time-consuming, but ultimately a good way to sort out some serious knots and figure out even the toughest of problems.
First, here's a little bit about SOAP notes. I first encountered SOAP notes while I was deciding not to be a doctor like my father. Although I had absolutely no interest in sticking needles into people or cutting them open, hanging around my father in his office taught me a lot about troubleshooting and diagnostics in general.
In a sense, medicine is much harder than computingthere are hardly any standards, the designer never released the data sheets (much less the full documentation), and the device you're trying to troubleshoot can sue you if you make a mistake. The medical profession has come up with all sorts of diagnostic methodologieswe as network troubleshooters can learn a great deal from the medical profession.
One of those diagnostic techniques is the SOAP method of note taking. On their patients' charts, some doctors write down (on separate lines) the letters S, O, A, and P, standing for Subjective, Objective, Analysis, and Plan, respectively. Therefore, if I went to see the doctor about my stomach, he might write
The subjective is what I say to the doctor, the objective is what the doctor sees, the analysis is what he deduces from his additional questions and reasoning, and the plan is what he will do to try to treat the problem, plus the next step. Doctors are used to not being able to get a black-and-white answer; however, if they have a plan, they are going in the right direction.
Going in the right direction is what the SOAP method is all about. Not every problem you run into as a troubleshooter is going to be solvable within that day or week particularly problems that are not show-stoppers (emergency room visits). In particular, problems that come and go (intermittent problems) are usually long-term and complex troubleshooting jobs. To be able to start to get a handle on a complex problem, you have to segregate the problem into its component partsthat is, the subjective report and the objective facts. It's particularly important to be able to separate the subjective outsomeone might be reporting something that has some bearing on the problem but perhaps is not pointing directly at the problem. Consider someone who's reporting chest painsis this person reporting a heart attack or a muscle problem? The report of pain in the chest is a subjective feelingthe active investigation that reveals a heart attack or muscle pain is the objective finding. The subjective is useful but can only be borne out by investigation.