Monitore aus CSV importieren
Organisationsadministratoren können mehrere Monitore auf einmal aus einer CSV-Datei anlegen. Öffnen Sie in der Monitor-Liste das Dropdown Erstellen und wählen Sie CSV importieren, um den Import-Assistenten zu öffnen.
Der Assistent führt Sie durch drei Schritte: Hochladen, Spalten zuordnen und Ergebnisse.
CSV-Format
Die erste Zeile muss eine Kopfzeile mit Spaltennamen sein – im nächsten Schritt werden diese Namen den Monitorfeldern zugeordnet (die Zuordnung lässt sich von Hand anpassen). Speichern Sie die Datei als UTF-8 und halten Sie sich an die üblichen CSV-Regeln (RFC 4180): Werte mit Komma trennen und jeden Wert, der selbst ein Komma enthält, in doppelte Anführungszeichen setzen.
Einige Werte verhalten sich so, dass es sich lohnt, sie vorab zu kennen:
escalationPolicyverweist per Name oder numerischer id auf eine bestehende Eskalationsrichtlinie. Ein Name muss exakt übereinstimmen – legen Sie die Richtlinie also vor dem Import an.incidentMessageTemplateist der literale Vorfallstext, keine Referenz auf eine gespeicherte Vorlage.- Bei S7 Tag und OPC UA Node verknüpfen Sie den Monitor auf eine von zwei Arten mit seinem übergeordneten Endpoint-Monitor. Entweder setzen Sie
endpointauf denselben Wert wie der übergeordnete S7- bzw. OPC-UA-Endpoint, oder Sie setzenparentMonitorauf den Namen oder die numerische id des übergeordneten Monitors. Der übergeordnete Monitor kann weiter oben in derselben Datei stehen oder bereits existieren – Sie können untergeordnete Monitore also auch einzeln importieren, ohne den übergeordneten erneut zu importieren. Stimmt ein Name mit mehr als einem Monitor überein, wird die Zeile abgewiesen; verwenden Sie zur Eindeutigkeit die numerische id.
Als funktionierende Vorlage nutzen Sie im Upload-Schritt Beispiel-CSV herunterladen: Sie enthält alle unterstützten Spalten und je eine Beispielzeile pro Monitor-Typ.
Schritt 1 — Hochladen
Ziehen Sie eine CSV-Datei in die Ablagefläche oder klicken Sie, um eine Datei auszuwählen. Eine Vorschautabelle zeigt die ersten Zeilen, damit Sie prüfen können, ob die Datei korrekt gelesen wurde; mit Ersetzen tauschen Sie die Datei aus. Klicken Sie auf Weiter oder auf Abbrechen, um den Assistenten zu schließen.
Schritt 2 — Spalten zuordnen
Ordnen Sie jedem Monitorfeld eine Spalte aus Ihrer CSV zu. Der Assistent erkennt passende Spaltennamen automatisch und befüllt die Zuordnung nach Möglichkeit vor. Für jedes Feld können Sie:
- die CSV-Spalte wählen, deren Werte verwendet werden,
- mit Fixer Wert… einen Wert für alle Zeilen festlegen (praktisch für gemeinsame Einstellungen wie die Eskalationsrichtlinie) oder
- das Feld Nicht zugeordnet lassen – nur bei optionalen Feldern erlaubt.
Welche Felder erforderlich sind, hängt von den in der Datei erkannten Monitor-Typen ab. Die Tabelle listet jede Spalte, wann sie erforderlich ist und welche Werte sie akzeptiert.
| Spalte | Erforderlich für | Gültige Werte / Format |
|---|---|---|
monitorType | Alle | s7_endpoint, s7_tag, opcua_endpoint, opcua_node, cve |
name | Alle | Freitext |
escalationPolicy | Alle | Name (exakt) oder numerische id einer bestehenden Eskalationsrichtlinie |
incidentMessageTemplate | Optional | Freitext (die Nachricht selbst) |
endpoint | S7 Endpoint, S7 Tag, OPC UA Endpoint, OPC UA Node | Host/IP oder opc.tcp://…. Bei S7 Tag und OPC UA Node Verknüpfung mit dem Endpoint-Monitor gleichen endpoints |
parentMonitor | Optional (S7 Tag, OPC UA Node) | Name oder numerische id des übergeordneten Endpoint-Monitors (Alternative zur Zuordnung über endpoint) |
rack | S7 Endpoint | Ganzzahl (z. B. 0) |
slot | S7 Endpoint | Ganzzahl (z. B. 1) |
address | S7 Tag | S7-Adresse (z. B. DB1.DBW0) |
dataType | Optional (S7 Tag) | bit, byte, word, dword, int, dint, real |
opcuaNodeId | OPC UA Node | Node-ID (z. B. ns=2;s=ProductionCounter) |
securityMode | Optional (OPC UA Endpoint) | none, sign, sign_and_encrypt (leer → none) |
securityPolicy | Optional (OPC UA Endpoint) | none, basic256, basic256sha256 (leer → none) |
aggregation | S7 Tag, OPC UA Node | min, max, sum, avg, count |
operation | S7 Tag, OPC UA Node | eq, neq, gt, gte, lt, lte |
operand | S7 Tag, OPC UA Node | Zahl |
duration | S7 Tag, OPC UA Node | Sekunden (Zahl) |
frequency | S7 Tag, OPC UA Node | Sekunden (Zahl) |
vendor | CVE | Gerätehersteller, z. B. Siemens |
orderCode | CVE | Bestellnummer / MLFB des Geräts, z. B. 6ES7516-3AN00-0AB0 |
firmware | Optional (CVE) | Firmware-Version, z. B. V2.9.2 (leer → passt auf alle Firmware-Versionen) |
Heartbeat-Monitore können nicht per CSV-Import angelegt werden.
TIP
aggregation, operation, operand, duration und frequency bilden zusammen die Prüfbedingung eines Monitors. Für S7-Tag- und OPC-UA-Node-Monitore sind sie als Gruppe erforderlich.
TIP
CVE-Monitore (cve) gleichen veröffentlichte Sicherheitsmeldungen über vendor + orderCode (+ optional firmware) mit einem Gerät ab. Sie haben keinen Endpunkt, kein Rack/Slot und keine Prüfbedingung – die einzigen CVE-spezifischen Spalten sind vendor, orderCode und firmware. Siehe CVE-Monitore zur Funktionsweise des Abgleichs.
Wenn alle erforderlichen Felder zugeordnet sind, klicken Sie auf Import starten. Um den Assistenten zu schließen und Ihre Arbeit zu verwerfen, klicken Sie auf Abbrechen; um die Zuordnungen zu behalten und später fortzufahren, schließen Sie den Bereich stattdessen mit der Schaltfläche × in der Kopfzeile – der Assistent setzt dort fort, wo Sie aufgehört haben.
Schritt 3 — Ergebnisse
Eine Zusammenfassung zeigt, wie viele Zeilen erfolgreich importiert wurden und wie viele fehlgeschlagen sind. Jede fehlgeschlagene Zeile wird mit der verursachenden Fehlermeldung aufgeführt. Klicken Sie auf Fehlgeschlagene Zeilen herunterladen, um nur diese Zeilen als CSV zu exportieren, sie zu korrigieren und die Datei erneut zu importieren.
Verwandte Themen
- Monitore — Monitor-Typen, Konfiguration und Auswertung