Betrieb & Monitoring
NetBox
NetBox ist eine quelloffene Quelle der Wahrheit (Source of Truth) für Netz- und Infrastrukturdokumentation und dient als Datenbasis für Automatisierung.
- IPAM + DCIM
- Source of Truth (Soll-Zustand)
- REST- und GraphQL-API
- Automatisierung (Ansible/Terraform)
- Apache 2.0
NetBox vereint IP-Adressverwaltung (IPAM) und Rechenzentrums-Dokumentation (DCIM) in einem Datenmodell und dient als Source of Truth für die Netz- und Infrastruktur. Es beschreibt den Soll-Zustand: wie das Netz aufgebaut sein soll, welche Adressen vergeben sind, welche Geräte wo stehen und wie sie verkabelt sind.
Dieser Artikel erklärt das Datenmodell, die wichtige Abgrenzung zwischen Soll-Zustand und Monitoring, die Schnittstellen für Automatisierung (REST, GraphQL, Webhooks, Ansible, Terraform), Änderungsverfolgung und Rechte, das Plugin-Ökosystem, Technik und Editionen sowie die typischen Fehler. Die laufende Überwachung des Ist-Zustands ist ein eigenes Thema und rechts verlinkt.
1. Ein Datenmodell für IPAM und DCIM
NetBox modelliert die Infrastruktur in zusammenhängenden Objektgruppen, statt sie auf Tabellenblätter zu verteilen:
- DCIM Standorte, Racks, Gerätetypen und Geräte, Module, Schnittstellen, Kabel, Stromversorgung.
- IPAM Aggregate, Präfixe, IP-Adressen und -Bereiche, VRFs, VLANs und VLAN-Gruppen, ASNs, Dienste.
- Circuits Provider, Leitungen und Anbindungen.
- Virtualization Cluster, virtuelle Maschinen und deren Schnittstellen.
- Tenancy/Contacts Mandanten und Ansprechpartner zur Zuordnung von Objekten.
IP gehört an die Schnittstelle
IP-Adressen werden in NetBox nicht direkt dem Gerät, sondern dessen Interface zugewiesen. Wer das umgeht, bricht später Automatisierungs-Skripte. Überlappende Adressräume (mehrere Kunden mit 192.168.0.0/24) gehören in getrennte VRFs.
2. Source of Truth, nicht Monitoring
NetBox hält den Soll-Zustand; es fragt keine Geräte live ab und kennt keinen Ping. Den Ist-Zustand (Erreichbarkeit, Auslastung, tatsächliche Konfiguration) liefern andere Werkzeuge: Monitoring für Verfügbarkeit und Leistung, Config-Management (Ansible, Terraform) für die Umsetzung des Solls auf den Geräten.
Die Lücke zwischen Soll (NetBox) und Ist (Netz) heißt Drift, und Dokumentation veraltet schnell. Der Wert von NetBox steht und fällt damit, dass es das führende System ist, aus dem Automatisierung gespeist wird, und nicht ein nachgelagertes Wiki, das niemand aktuell hält.
3. Schnittstellen und Automatisierung
NetBox ist auf Automatisierung ausgelegt. Die REST-API deckt alle Objekte ab, die GraphQL-API erlaubt gezielte, verschachtelte Abfragen, und Webhooks/Event Rules stoßen bei Änderungen externe Abläufe an. In der Praxis dient NetBox als dynamisches Ansible-Inventory (Plugin nb_inventory), als Quelle für Terraform und wird per pynetbox aus Python angesprochen. Config Contexts und Config Templates (Jinja2) erlauben sogar das Rendern von Gerätekonfigurationen direkt aus den Solldaten.
pynetbox: aktive Präfixe eines Standorts abfragen
import pynetbox
nb = pynetbox.api("https://netbox.example.com", token="<token>")
for p in nb.ipam.prefixes.filter(site="rz1", status="active"):
print(p.prefix, p.description)4. Änderungsverfolgung und Rechte
Jede Erstellung, Änderung und Löschung landet automatisch im Change Log, mit Vorher-/Nachher-Stand, Zeitstempel und auslösendem Nutzer. Ergänzend dokumentiert das Journaling menschliche Notizen am Objekt (das Warum). Das Rechtemodell ist objektbasiert: Berechtigungen lassen sich über JSON-Constraints feingranular einschränken (etwa nur auf reservierte Präfixe oder eigene Einträge).
5. Plugins und Erweiterbarkeit
NetBox lässt sich über Plugins (eigenständige Django-Apps) erweitern. Verbreitet und teils offiziell zertifiziert sind etwa Topology Views (grafische Topologie aus Geräten und Kabeln), Branching (git-ähnliche Änderungsstränge mit Review), sowie Plugins für BGP, DNS und Secrets. So wächst das Datenmodell mit den eigenen Anforderungen, ohne den Kern zu verändern.
6. Technik, Lizenz und Editionen
NetBox basiert auf Django/Python mit PostgreSQL (ausschließlich, kein MySQL/SQLite) und Redis; Deployment per Paket oder Docker-Compose. Der Kern steht unter Apache 2.0. Kommerziell bietet NetBox Labs NetBox Cloud (SaaS) und NetBox Enterprise (self-hosted mit Support). Ergänzend gibt es NetBox Discovery (Agent zum Einlesen des Ist-Zustands, Open Source) und das kommerzielle NetBox Assurance (automatische Drift-Erkennung); beide sind nicht Teil des NetBox-Kerns.
7. Best Practices und typische Fehler
- NetBox wirklich als SoT führen parallele Pflege in Tabellen erzeugt zwangsläufig Drift; NetBox muss die autoritative Quelle sein.
- Automatisierung erzwingt Pflege wenn Ansible/Terraform aus NetBox lesen, lohnt sich die Datenpflege von selbst.
- Sauber modellieren Gerätetypen-Vorlagen, VRFs und Interface-Zuweisungen früh richtig anlegen; Fehler kaskadieren später.
- Upgrades planen Breaking Changes treten in bestimmten Releases auf; Plugin-Kompatibilität und Terraform-Provider-Version dazu passend halten.
- PostgreSQL sichern ein Backup-Konzept für die Datenbank ist Pflicht.
8. Stärken und Grenzen
| Stärken | Grenzen |
|---|---|
| Ein kohärentes Modell für IPAM und DCIM, schließt Silos | Kein Monitoring/Discovery im Kern: zeigt nicht, ob ein Gerät läuft |
| REST- und GraphQL-API: tiefe Automatisierungs-Integration | Datenqualität hängt an Disziplin; ohne Pflege veraltet alles |
| Apache 2.0, kein Lock-in im Kern; aktives Ökosystem | Umfangreiches Datenmodell, spürbare Lernkurve |
| Config Contexts/Templates rendern Konfigurationen aus dem Soll | PostgreSQL-only, kein MySQL/SQLite |
| Vollständiges Änderungsprotokoll, objektbasierte Rechte | Breaking Changes bei bestimmten Upgrades, Plugins müssen nachziehen |
Häufige Fragen zu NetBox
Nein. NetBox hält den Soll-Zustand und fragt keine Geräte live ab. Verfügbarkeit und Leistung liefert ein Monitoring-System; NetBox kann dieses aber speisen, etwa indem es die Geräteliste exportiert.
Der Open-Source-Kern nicht; er bildet ab, was eingetragen wird. Den Abgleich mit dem Ist-Zustand (Discovery/Drift) decken separate, kommerzielle Zusatzprodukte oder eigene Skripte ab.
Auch der Autor ist nur ein Mensch, dem Fehler unterlaufen können. Wenn in diesem Beitrag etwas nicht stimmt oder unklar ist, freuen wir uns über einen kurzen Hinweis über das Kontaktformular unten, wir prüfen und korrigieren das.
Der nächste Schritt
NetBox im eigenen Haus richtig einsetzen?
Wir klären, ob und wie der Baustein zu Ihrer Infrastruktur passt, und sagen offen, wann sich der Aufwand lohnt und wann nicht.