Netzwerkinfrastruktur-Dokumentation: der Praxis-Leitfaden für IT-Teams
Netzwerkinfrastruktur-Dokumentation ist die strukturierte Erfassung aller Komponenten, Verbindungen und Konfigurationen eines Netzwerks, von Standorten, Racks und Verkabelung bis zu IP-Plänen, VLANs und Routing. Sie umfasst zwei Ebenen: die physische (Hardware und Kabelwege) und die logische (Adressierung, Segmentierung, Dienste). Erst beide zusammen ergeben das vollständige Bild. Dieser Leitfaden zeigt dir den Weg dorthin in sechs Schritten.
Vier Gründe, die sich messen lassen.
Netzwerkdokumentation ist kein Selbstzweck. Sie zahlt auf vier Ziele ein, die du im Betrieb direkt spürst.
Kürzere Störungsbehebung (MTTR)
Wer sofort weiß, welches Gerät an welchem Port hängt und welches VLAN betroffen ist, grenzt Fehler schneller ein und verkürzt die Zeit bis zur Wiederherstellung.
Audit- und Zertifizierungsfähigkeit
ISO 27001, BSI IT-Grundschutz und NIS-2 verlangen Nachweise. Eine gepflegte Netzdokumentation ist die Grundlage, auf der Auditoren prüfen, statt zu raten.
Wissenssicherung
Verlässt die eine Person das Team, die das Netz im Kopf hatte, bleibt ohne Doku eine Lücke. Dokumentiertes Wissen macht dich unabhängig von Einzelpersonen.
Planungssicherheit
Migrationen, Ausbau, Segmentierung: Jede Planung steht und fällt mit verlässlichen Bestandsdaten. Wer den Ist-Zustand kennt, plant fundiert statt auf Verdacht.
Physisch und logisch: beide Ebenen zählen.
Eine vollständige Netzwerkdokumentation besteht aus zwei Ebenen. Die physische beschreibt, was du anfassen kannst. Die logische beschreibt, wie das Netz konfiguriert ist. Fehlt eine der beiden, bleibt das Bild unvollständig.
Hardware, Standorte, Kabelwege
Die physische Dokumentation beantwortet die Frage: Was steht wo, und wie ist es verbunden?
- Standorte und RäumeGebäude, Etagen, Technikräume, Rechenzentren
- Racks und GeräteRack-Positionen, Switches, Router, Firewalls, Server mit Modell und Seriennummer
- Verkabelung Port zu PortPatchfelder, Kabeltypen und -kategorien, durchgängige Verbindungen
- Strom und UmgebungStromzuführung, USV, relevante Umgebungsbedingungen
Adressierung, Segmentierung, Dienste
Die logische Dokumentation beantwortet die Frage: Wie ist das Netz konfiguriert, und wie fließt der Verkehr?
- IP-AdresspläneSubnetze, Präfixe, vergebene Adressen, IPv4 und IPv6
- VLANs und SegmentierungVLAN-IDs, Zuordnungen, Sicherheitszonen
- Routing und GatewaysRouting-Protokolle, statische Routen, Redundanzen
- DNS, DHCP und KonfigurationenZonen, Scopes, Gerätekonfigurationen, Firmware-Stände
In sechs Schritten zur Netzwerkdokumentation.
Der häufigste Fehler ist, einfach loszudokumentieren. Bewährt hat sich ein Vorgehen in sechs Schritten: erst Rahmen und Struktur, dann Erfassung, dann Betrieb.
Scope festlegen
Definiere, was die Doku abdecken soll und für wen sie da ist.
- Standorte, Netze, Systeme eingrenzen
- Compliance-Anforderungen klären (ISO 27001, NIS-2)
- Zielgruppen und Detailtiefe festlegen
Inventarisierung
Sammle, was es schon gibt, bevor du neu erfasst.
- Excel-Listen, Visio-Pläne, alte Doku sichten
- Konfig-Backups und Monitoring auswerten
- Discovery-Scans als Realitätsabgleich
Datenmodell und Konventionen
Lege fest, wie dokumentiert wird, bevor Daten fließen.
- Namenskonventionen für Geräte, Ports, VLANs
- Struktur für physische und logische Ebene
- Ein zentraler Ablageort statt Datei-Silos
Ersterfassung
Befülle die Doku systematisch, Bereich für Bereich.
- Physisch: Racks, Geräte, Verkabelung
- Logisch: IP-Pläne, VLANs, DNS/DHCP
- Importe bereinigen, Duplikate auflösen
Verifikation
Prüfe die Doku gegen die Realität, nicht gegen sich selbst.
- Stichproben vor Ort und auf der CLI
- Soll-Ist-Abgleich je Standort
- Vier-Augen-Review, Lücken notieren
Pflegeprozess aufsetzen
Ohne Pflegeprozess veraltet jede Doku. Verankere sie im Alltag.
- Doku-Update als Pflichtschritt im Change
- Regelmäßige Reviews mit Ownership
- Automatischer Abgleich per Discovery
Diese Daten gehören in deine Doku.
Acht Datenkategorien bilden den Kern jeder Netzwerkdokumentation. Arbeite sie der Reihe nach ab, dann entsteht ein konsistentes Gesamtbild statt einer Sammlung von Einzellisten.
-
01 · Geräte
Hardware-Inventar
Hersteller, Modell, Seriennummer, Firmware-Stand, Standort und Rack-Position. Jedes aktive Gerät bekommt einen eindeutigen, konventionskonformen Namen.
-
02 · Ports
Ports und Interfaces
Belegung, Beschreibung, Geschwindigkeit und Status je Port. Freie Ports sind genauso wichtig wie belegte, sie sind deine Ausbaureserve.
-
03 · Kabel
Verkabelung
Port-zu-Port-Verbindungen über Patchfelder hinweg, Kabeltyp und Kategorie. Ziel: Jede Strecke ist von Ende zu Ende nachvollziehbar.
-
04 · IP/VLAN
IP-Adressen und VLANs
Subnetze und Präfixe, vergebene Adressen, VLAN-IDs mit Zuordnung, Routing. IPv6 von Anfang an mitdenken, nachrüsten ist teurer.
-
05 · DNS/DHCP
DNS und DHCP
Zonen und Records, DHCP-Scopes und Reservierungen, zuständige Server. Diese Dienste sind bei Störungen die häufigsten Verdächtigen.
-
06 · WAN
WAN-Anschlüsse und Circuits
Provider, Bandbreiten, Anschluss- und Circuit-IDs, Vertragslaufzeiten und Störungs-Hotlines. Im Ernstfall zählt jede Minute bis zur Provider-Meldung.
-
07 · Zugänge
Zugänge und Rechte
Management-Zugänge, Rollen und Berechtigungen. Zugangsdaten gehören in einen Passwort-Safe, niemals im Klartext in die Dokumentation.
-
08 · Verantwortliche
Ownership und Eskalation
Wer verantwortet welches System, welchen Standort, welche Datenkategorie? Plus Stellvertretung und Eskalationswege. Ohne Ownership veraltet alles davor.
Was ISO 27001, NIS-2 und BSI verlangen.
Keines der drei Regelwerke schreibt ein bestimmtes Tool vor. Alle drei setzen aber voraus, dass du dein Netz kennst und das nachweisen kannst. Die Netzdokumentation ist dafür die Grundlage.
Doku, die aktuell bleibt.
Eine Dokumentation, die nur bei Projektende gepflegt wird, ist nach wenigen Monaten wertlos. Der Unterschied zwischen Doku und verlässlicher Doku ist der Pflegeprozess.
- Ins Change-Management integrieren Kein Change gilt als abgeschlossen, bevor die Dokumentation aktualisiert ist. Das Doku-Update wird Pflichtschritt im Ticket, nicht freiwillige Kür.
- Regelmäßige Reviews einplanen Feste Termine, an denen Verantwortliche ihren Bereich stichprobenartig gegen die Realität prüfen. Kleine, häufige Reviews schlagen die jährliche Großinventur.
- Automatische Discovery als Abgleich Discovery-Werkzeuge lesen den Ist-Zustand aus dem Netz und vergleichen ihn mit dem dokumentierten Soll. Abweichungen (Drift) fallen sofort auf, nicht erst im Audit.
- Versioniert, zugriffsgeregelt, erreichbar Änderungen müssen nachvollziehbar sein, der Zugriff geregelt, und alle Verantwortlichen müssen die Doku erreichen. Ein Datei-Silo auf einem Team-Laufwerk erfüllt keines dieser Kriterien.
Woran Netzwerkdokumentation in der Praxis scheitert.
Drei Muster sehen wir immer wieder, unabhängig von Branche und Unternehmensgröße. Alle drei sind vermeidbar.
Excel- und Visio-Inseln
Drei Excel-Listen, zwei Visio-Pläne, ein Wiki, und alle sagen etwas anderes. Ohne zentrale Quelle mit Validierung fallen doppelte IPs und Widersprüche erst auf, wenn etwas ausfällt.
Einmal-Doku ohne Pflegeprozess
Zum Projektabschluss wird sauber dokumentiert, danach nie wieder. Ab dem ersten undokumentierten Change ist die Doku nicht mehr verlässlich.
Fehlende Ownership
Alle nutzen die Dokumentation, niemand verantwortet sie. Ohne benannte Owner je Bereich gibt es weder Reviews noch Konsequenz im Change-Prozess. Ownership ist die billigste Versicherung gegen Verfall.
Womit dokumentieren?
Erst der Prozess, dann das Tool. Wenn Scope, Datenmodell und Pflegeprozess stehen, brauchst du ein Werkzeug mit zentralem Datenmodell, Validierung, Rechteverwaltung und API. Im Open-Source-Bereich hat sich dafür NetBox etabliert (Apache-2.0-Lizenz, seit 2016, REST- und GraphQL-API), das IPAM und DCIM in einer Source of Truth vereint. Den ausführlichen Tool-Vergleich führen wir bewusst auf einer eigenen Seite.
Netzwerkdoku in Kurzantworten.
Was andere zum Thema Netzwerkdokumentation wissen wollen.
Wir bringen deine Netzwerkdokumentation auf NetBox.
Im kostenfreien Erstgespräch klären wir, wo du stehst und wie deine Doku zur Source of Truth wird. Kein Vertrieb, Praktiker zu Praktiker.