Network diagram tips: 18 rules for drawings that stay true
Rules that hold for any network, from a small office to a school district, a store chain, a bank or a plant. Each comes with the reason behind it, and many with an example from one of the ten sample sites in the series. Print them, argue about them, then fix one this week.
Every rule works by hand. If you keep your network in NetBox, even the free edition, the free NetDiagrams tool draws them for you.
A diagram is a promise about the network: date it, source it and check it, or it is only a picture.
An undated drawing can't tell the reader whether it shows this year's network or the one from before the last refresh. Put a date, a revision and the source of record in the title block, and re-check it on a schedule.
Rule 2
Draw one page per audience
One page per audience. Nobody needs every fact; everybody needs their facts.
The owner, the auditor, the outside vendor and the technician on call each ask different questions. A set of pages that share one skeleton answers all of them; one crowded page answers none of them.
Rule 3
Write the overview in the owner's words
The overview says what is protected, what connects and what is changing, in words the person in charge uses.
The plant manager, the principal, the branch manager or the general manager signs the insurance questionnaire, and none of them reads VLAN IDs. Name the zones in plain words, show where outsiders can and can't reach, and keep the technical detail for the pages behind it.
Stack zones in the same order on every page, most trusted and most sensitive at one end, outsiders at the other.
When every page uses the same order, a reader finds a system at the same height on every sheet. Use the order your industry already speaks: Purdue levels in a plant, the cardholder data environment in a store, the teller line and wire room in a bank. Give the DMZ its own band, because that is where outside traffic is supposed to stop.
Every routed subnet in exactly one zone, with its gateway and VRF. Boundaries are devices, drawn across the line.
A subnet that sits in two zones, or in none, is a segmentation question nobody has answered. Draw the firewall or router that separates zones on the boundary itself, so the reader can see what guards each edge.
Every drawn link carries the label on the real cable, its speed and its trunked VLANs.
If the label on the drawing matches the label on the cable, a technician can trace a fault without a flashlight and a guess. Speed and trunked VLANs on the link answer the next two questions before anyone asks.
"Fiber" is not a media type. Record the media, the optic and the patch port.
Single-mode or multimode, which optic, and which patch panel port decide whether a spare in the drawer will work. Write them down once, on the faceplate view, and nobody has to pull the optic to find out.
Draw every member of every pair, stack and ring, so the failure mode is visible before 3 a.m.
A single box labeled "core" hides the question that matters during an outage: what still works when one member fails? Draw both firewalls, every stack member and the whole ring, then sketch what happens when each one breaks.
Every SSID has a VLAN and a zone. Every radio bridge is drawn as a radio bridge.
Wireless is where segmentation quietly leaks, because an SSID looks like a cloud on most drawings. Guest, staff, student, handheld and payment SSIDs each belong to one zone. Tie each to its VLAN, and draw point-to-point bridges as links with two ends.
Draw flows from initiator to responder, and draw the important denials, not just the permits.
Direction decides the firewall rule, so an arrow without a direction is half an answer. Showing the paths you deliberately block, such as guest Wi-Fi to the payment terminals or the internet straight to the controllers, tells the reader the design was intentional.
Every pair of zones gets an answer in the register. Silence is not a policy.
A flow register lists each permitted conversation with its source, destination, port and reason. A zone matrix then answers every pair, including "denied", so an auditor never has to infer intent from a missing row.
One standard and one naming pattern at every site, with consistent site prefixes. Circuits are lines with IDs, not clouds.
When every store, school, branch or plant is drawn and named the same way, an engineer who knows one site can read them all. Give WAN circuits their IDs on the drawing so the carrier ticket and the diagram point at the same line.
Facts live in the source of record. The drawing reads them; it doesn't remember them.
IP addresses typed into shapes go stale the first time someone changes a device. Keep devices, cables and VLANs in a source of record such as NetBox, and let the drawing be a view of it.
Drift is normal. Measure it on a schedule and turn each difference into a fix.
Every drawing drifts from the network; the question is whether you find out before an auditor does. Compare the drawing with the source of record on a fixed day each month and treat each difference as a ticket.
Rule 15
Share the view, not the secrets
Share the view the reader needs. Hide management IPs, circuit IDs and VLAN tables before it leaves the building.
A vendor needs to know where their system plugs in, not your management addressing. Keep sensitive detail on layers you can hide, and check what's visible before a drawing goes outside.
Rule 16
Start this week with zones and cables
An imperfect drawing this week beats a perfect one next year. Start with zones and cables.
Zones and cables answer most of the questions people actually ask. Draw those first, from a walkdown if you have to, and let the rest of the detail follow.
Draw what you have. Mark what you don't. Keep the plan to fix it on the page.
A gap you mark is a task; a gap you hide is a surprise. Draw unknown links dashed, note who can answer each question, and keep the list of gaps on the drawing until it's empty.
The register says what should happen. The firewall decides what does. Compare them.
A flow register is a statement of intent. Check it against the firewall rules that are actually loaded, because a rule nobody remembers adding is still a rule.
Test any drawing
Five questions to ask any network diagram
Which zone is this in?
Who routes it?
Which device guards its edge?
When was this checked?
Where is the record?
If the drawing can't answer, the drawing has work to do. Score your diagram for the 20-question version.
The long version
Every rule, worked through for your kind of site
Each book takes these rules through one industry's zones, systems and auditors, with a full sample site, worked examples and the mistakes to avoid.