Config Parsing: Dokumentation aus Cisco/Juniper/Arista Configs generieren

Config Parsing – also das strukturierte Auslesen von Informationen aus Cisco-, Juniper- und Arista-Konfigurationen – ist einer der effizientesten Wege, um Netzwerkdokumentation automatisch zu erzeugen und als Living Documentation aktuell zu halten. Während SNMP und Telemetry vor allem den Ist-Zustand (Status, Metriken, Nachbarschaften) liefern, steckt der eigentliche Architektur-Intent häufig in den Konfigurationen: VRFs, Routing-Policies, BGP-Sessions,…

Dokumentation aus Telemetrie: Topologie und Pfade automatisiert ableiten

Dokumentation aus Telemetrie ist für moderne Netzwerkteams einer der größten Hebel, um Topologien und Pfade nicht nur einmalig zu zeichnen, sondern kontinuierlich aus der Realität abzuleiten. Während klassische Netzwerkdiagramme häufig nach einem Projekt entstehen und danach langsam veralten, liefern Telemetriequellen wie Streaming Telemetry (z. B. gNMI/gRPC), Nachbarschaftsprotokolle (LLDP), Routing-States (BGP/OSPF/IS-IS) und Flow-Telemetrie (IPFIX/NetFlow/sFlow) einen laufenden…

Infrastructure Graphs: Network Graph Datenmodell für Visualisierung

Infrastructure Graphs sind der pragmatische nächste Schritt nach klassischen Netzwerkdiagrammen, Tabellen und CMDB-Listen: Statt „ein Bild pro Zeitpunkt“ modellieren Sie Ihre Infrastruktur als Network Graph – also als Graph-Datenmodell aus Knoten (Nodes) und Kanten (Edges), das Topologie, Abhängigkeiten und Pfade maschinenlesbar beschreibt und daraus beliebige Visualisierungen ableiten kann. Genau das löst ein wiederkehrendes Problem im…

Diagramm-Lesbarkeit erhöhen: Layout-Regeln für große Topologien

Die Diagramm-Lesbarkeit erhöhen ist in großen Netzwerken kein „Design-Thema“, sondern ein echter Betriebshebel. Sobald Topologien wachsen – mehrere Standorte, Datacenter, Cloud-Regionen, Overlays, Security-Zonen, Provider-Links – kippen viele Diagramme in unlesbare Spaghetti: Linien kreuzen sich, Labels überdecken sich, es gibt keine visuellen Hierarchien und niemand erkennt in 30 Sekunden, was wichtig ist. Das Ergebnis ist teuer:…

Dokumentation mit Nornir/Ansible: Inventar und Facts automatisch pflegen

Dokumentation mit Nornir/Ansible ist eine der pragmatischsten Methoden, um Netzwerk-Inventar und Device-Facts nicht nur einmalig zu erfassen, sondern dauerhaft aktuell zu halten. In vielen Teams entsteht Dokumentationsdrift, weil Veränderungen schneller passieren als manuelle Updates in Wiki, Excel oder Diagrammen. Genau hier setzen Automatisierungs-Frameworks an: Nornir (Python-basiert, flexibel, parallel) und Ansible (deklarativ, verbreitet, rollen- und playbookorientiert)…

Namenskonventionen im Diagramm: Geräte, Interfaces, Links konsistent benennen

Saubere Namenskonventionen im Diagramm sind einer der größten Hebel, um Netzwerkdiagramme dauerhaft verständlich, wartbar und betriebssicher zu halten. In kleinen Umgebungen kann man vieles „aus dem Kopf“ lesen: Der Switch heißt eben „Core“, der Uplink „Uplink1“ und das Interface „Port 49“. In großen Topologien bricht dieses Vorgehen zuverlässig zusammen. Spätestens wenn mehrere Standorte, mehrere Teams,…

CI Checks für Dokumentation: Broken Links, veraltete Diagrams, Linting

CI Checks für Dokumentation sind der schnellste Weg, um Dokumentation verlässlich, aktuell und „mergebar“ zu machen – ohne dass Teams in Review-Meetings über tote Links, widersprüchliche Diagramme oder Formatierungschaos diskutieren müssen. In vielen Netzwerkteams gilt Dokumentation noch als Nebenprodukt: Ein Diagramm wird erstellt, ein Wiki-Artikel ergänzt, ein Runbook geschrieben – und danach beginnt der Drift.…

“One Diagram per Question”: Diagramme nach Use Case statt nach Technik

Das Prinzip “One Diagram per Question” klingt simpel, löst aber eines der größten Probleme in der Netzwerktechnik: Diagramme werden nach Technik gezeichnet, nicht nach Use Case. Ergebnis: Ein einziges „Masterdiagramm“ soll gleichzeitig Verkabelung, VLANs, Routing, Security-Zonen, Overlays, Provider, WLAN, Load Balancer und Applikationsflüsse erklären – und endet als Spaghetti-Plan, den niemand mehr pflegt. In großen…

Diagram-as-Code: Mermaid, PlantUML und Graphviz im Netzwerk

Diagram-as-Code bringt Netzwerkteams aus der „Screenshot-Falle“: Statt schwer reviewbarer Visio- oder PNG-Dateien entstehen Diagramme als Text, versioniert in Git, prüfbar per CI und reproduzierbar gerendert. Für den Betrieb ist das ein echter Qualitätssprung. Änderungen an Topologie, Segmentierung, Security-Zonen oder Pfaden lassen sich wie Konfigurationsänderungen behandeln: mit Pull Requests, Diffs, Reviews und klarer Historie („was hat…

Change-Dokumentation: RFCs, Risk Assessments und Rollback-Pläne

Eine saubere Change-Dokumentation ist im Netzwerk- und IT-Betrieb weit mehr als ein Pflichtformular: Sie ist ein Sicherheitsnetz, das Ausfälle verhindert, Entscheidungen nachvollziehbar macht und im Ernstfall Zeit spart. In vielen Organisationen scheitern Changes nicht an fehlendem Know-how, sondern an fehlender Struktur: unklare Ziele, unvollständige Impact-Analysen, ungetestete Annahmen und Rollback-Pläne, die nur auf dem Papier existieren.…