Zum Inhalt springen
VerfügbarImport aus NetBox: durchgängig getestet mit einer laufenden NetBox-4.7-Demoinstanz (24 Standorte). Zwei-Wege-Synchronisierung und ein NetBox-Plugin stehen auf der Roadmap.

NetBox, in 3D

DC Sim liest einen NetBox-Standort über die NetBox-API mit einem Read-only-Token und überführt ihn in die Blätter der Vorlage: Racks, Geräte, Kabel, Einspeisungen und VLANs. Sie sehen denselben Importbericht und dieselben Prüfungen wie beim Excel-Upload und danach den Standort als 3D-Zwilling, in dem Sie Knoten für Knoten Ausfälle durchspielen können. NetBox bleibt Ihre maßgebliche Datenquelle; es wird nichts zurückgeschrieben.

⋯ → Connect NetBox
URLhttpshttps://[your-netbox]/api/
Read-only API tokennie im Browser sichtbar••••••••••••••••••••
4.7.3 · 24 sites · 42 racks · 72 devices · 108 cables
Demo-Instanz · getestet
So funktioniert der Connector

Verbinden, prüfen, importieren.

  1. 01

    Verbinden

    Öffnen Sie ⋯ → Connect, fügen Sie die URL und ein Read-only-Token ein und klicken Sie auf Test. Der Test zeigt die Version und alles, was er lesen kann.

  2. 02

    Vorschau

    Das Ergebnis erscheint als Blätter der Vorlage, mit demselben Importbericht und denselben Prüfungen wie ein Excel-Upload.

  3. 03

    Import

    Bestätigen Sie, und der Zwilling wird erstellt oder aktualisiert. Eine erneute Synchronisierung zeigt genau, was sich geändert hat.

Das geöffnete Menü von DC Sim über der 3D-Ansicht eines Kühlgeräts, mit dem Eintrag „Connect NetBox or Zabbix: inventory, readings and alarms“.
NetBox oder Zabbix über das Menü ⋯ anbinden.simulierte Daten

Was Sie bekommen

  • Ebene Fläche: jedes Rack des Standorts in seiner Reihe, mit belegten HE und kW im Verhältnis zum Rack-Budget. Die Prüfliste beim Import ergänzt, was NetBox nicht abbildet: zu schwere Racks, PDUs oder Schutzschalter über 80 %, Geräte mit nur einem Netzkabel oder mit beiden Netzteilen an derselben Einspeisung, Phasensymmetrie.
  • Ebene Strom: Unterverteilungen, Einspeisungen und PDUs werden zum Einlinienschaltbild mit den Farben für A und B. Klicken Sie auf eine Einspeisung, drücken Sie Fail und sehen Sie, welche Racks dunkel werden und welche Dienste ausfallen.
  • Ebenen Verkabelung und Netzwerk: NetBox-Kabel werden in 3D über rückseitige Kabelmanager, Kabeltrassen oder unter dem Doppelboden geführt; jeden Kabelweg können Sie nachverfolgen. Die Netzwerktopologie entsteht aus denselben Kabeln; lassen Sie einen Switch ausfallen und sehen Sie, wer dann jeden Pfad verliert.

So binden Sie NetBox an

  1. Erstellen Sie in NetBox ein API-Token für einen Benutzer mit reinen Leserechten.
  2. Öffnen Sie in DC Sim ⋯ → Connect NetBox or Zabbix, wählen Sie NetBox, fügen Sie URL und Token ein und drücken Sie Test. Der Test zeigt die NetBox-Version und alle Standorte mit ihren Racks und Geräten, die größten zuerst.
  3. Wählen Sie den Standort. Preview (Vorschau) zeigt ihn als Blätter der Vorlage (Racks, Devices, Cables, Power, Networks), mit demselben Importbericht und denselben Prüfungen wie beim Excel-Upload.
  4. Import. Synchronisieren Sie später erneut, erhalten Sie eine Änderungsliste, bevor etwas übernommen wird.

Innerhalb Ihres eigenen Netzwerks läuft derselbe Connector im Agenten von DC Sim, der Verbindungen nur nach außen aufbaut.

Was wir auslesen

NetBoxVorlage von DC SimHinweise
Racks: Name, Location, Höhe, BreiteRacks: rack, row, height_u, width_indie Location wird zur Reihe; Breite 10 zeichnet ein Minirack
Geräte: Name, Rack, Position, Gerätetyp, Rolle, Seriennummer, MandantDevices: name, rack, u, model, role, serial, ownerGerätetypen werden mit dem Katalog abgeglichen; ein Gerät ohne Rack bleibt an seiner Location als Gerät außerhalb eines Racks erhalten; Blades wandern mit ihrem Chassis mit
benutzerdefinierte Felder warranty_end, runsDevices: warranty_end, runssofern Sie sie pflegen
Verteiler (Power Panels) und Einspeisungen (Power Feeds), primär und redundantPower: Verteiler mit Schutzschaltern je Einspeisung, A und BEinspeisungen ohne Nennwert werden im Bericht markiert
PDUs und die Feed Legs (Phasen) ihrer AusgängePower-Zeilen, gespeist von der verkabelten Einspeisung; Cables: phaseLast je Phase und Phasensymmetrie
Kabel: beide Enden, Typ, Länge und Einheit, Farbe, BeschriftungCables: Gerät und Port an beiden Enden (from/to), type, media, length_m, color, labelLängen werden in Meter umgerechnet; Provider-Circuits werden ausgelassen und aufgelistet
VLANs und PräfixeNetworks: vlan, name, purpose, subnet

Die Gerätetyp-Bibliothek der NetBox-Community steht unter der Lizenz CC0 und wird derzeit in den Gerätekatalog von DC Sim übernommen. So erhalten immer mehr Gerätetypen eine echte Höhe in HE, ein Gewicht und eine Leistungsaufnahme; alles, was sich nicht zuordnen lässt, wird zu einem einfachen Quader mit dem Vermerk „später identifizieren“.

Später

VorhabenStatus
Schnittstellengeschwindigkeiten aus NetBox auslesen (heute: aus Portnamen und dem Katalog)Roadmap
Zwei-Wege-Synchronisierung: einen Entwurf aus DC Sim als geplante Objekte zurück in NetBox übertragenRoadmap
Ein NetBox-Plugin: „Open in DC Sim“ an einem Rack oder GerätRoadmap

Keine eingehenden Verbindungen

Für eine NetBox-Instanz innerhalb Ihres Netzwerks läuft der Connector in einem kleinen Agenten, der eine einzige ausgehende WebSocket-Verbindung aufbaut und nie auf einem Port auf eingehende Verbindungen wartet; bricht die Verbindung ab, werden die Daten-Batches auf der Festplatte zwischengespeichert und in der richtigen Reihenfolge nachgeliefert. Das Token bleibt in der Konfiguration des Agenten. DC Sim schreibt nie in NetBox.

Häufige Fragen
Welche NetBox-Versionen werden unterstützt?

NetBox 3.x und 4.x über die REST-API. Getestet wurde mit NetBox 4.7, sowohl mit dem älteren als auch mit dem neueren Token-Format.

Welche Zugangsdaten werden benötigt?

Ein NetBox-API-Token für einen Benutzer mit reinen Leserechten. Das Token wird nur an NetBox gesendet; es wird nie im Browser angezeigt oder in einem Bericht gespeichert.

Ändert DC Sim etwas in NetBox?

Nein. DC Sim liest nur. Einen Entwurf als geplante Objekte zurück nach NetBox zu übertragen, steht auf der Roadmap und wird nur per Opt-in aktiviert.

Meine NetBox-Instanz hat viele Standorte. Was passiert dann?

Der Test listet die Standorte auf, die größten zuerst, mit der Anzahl ihrer Racks und Geräte. Sie importieren jeweils einen Standort, denn ein ganzer Standortverbund ist kein einzelner Raum.

Kann ich stattdessen weiterhin einen CSV-Export verwenden?

Ja. Auch die CSV-Exporte von NetBox selbst lassen sich den Blättern der Vorlage zuordnen; Spaltenüberschriften werden auch über Synonyme erkannt.

Eine Excel-Datei. Ihr Raum in 3D.

Laden Sie die Import-Vorlage (v1.4, elf Tabellenblätter, nur das Blatt Devices ist Pflicht) und das ausgefüllte Beispiel aus unserer Demohalle herunter. Kein Formular, keine E-Mail-Adresse nötig, keine Makros in den Dateien.

Füllen Sie das Blatt Devices aus und senden Sie es mit Ihrer Anfrage für eine Vorführung; wir importieren es während des Gesprächs. Wozu jedes Blatt dient

Weitere Integrationen