Bulk-Import von Monitoren via CSV | Hilfe & Anleitungen ePulz.io

Wenn Sie von einem anderen Website-Monitoring-Tool umsteigen oder 20 und mehr Seiten haben, ist das manuelle Hinzufügen Zeitverschwendung. Der Massenimport lädt eine CSV-Datei (eine als Text gespeicherte Tabelle) auf einmal hoch und erstellt daraus Dutzende Monitore.

CSV-Datei vorbereiten

Die CSV-Datei können Sie in Excel, Google Sheets oder einem beliebigen Texteditor erstellen. Speichern Sie sie in der Kodierung UTF-8 (Unterstützung von Sonderzeichen). Die erste Zeile enthält die Spaltennamen, die weiteren Zeilen die einzelnen Monitore.

name,type,target,interval_minutes,expected_status,expected_keyword
"Startseite",http,https://www.meine-firma.de,5,200,"Willkommen"
"API health",http,https://api.meine-firma.de/health,1,200,"\"status\":\"ok\""
"DB-Server",tcp,db.meine-firma.de:5432,5,,
"Email MX",dns,meine-firma.de,30,,
"SSL-Zertifikat",ssl,www.meine-firma.de,1440,,

Spalten

name - Pflicht, max. 120 Zeichen. Der Name, den Sie in der Übersicht sehen.
type - Pflicht. Einer von: http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - Pflicht (außer beim Typ heartbeat). URL, Hostname oder host:port je nach Monitortyp.
interval_minutes - optional, Standardwert 5. Das Minimum hängt vom Tarif ab.
expected_status - optional, gilt nur beim http-Monitor. Erwarteter Antwortcode (Standardwert 200).
expected_keyword - optional. Beim Typ http wird geprüft, ob die Zeichenkette im Antworttext vorkommt; beim Typ dns wird geprüft, ob sie im Wert des DNS-Eintrags vorkommt.

Bei LAN-Typen (lan_*) wird der Monitor Ihrem vorhandenen LAN-Agenten zugewiesen, und als Ziel geben Sie die lokale IP oder den Hostnamen an (zum Beispiel 192.168.1.10).

Ablauf des Imports

Seite für den CSV-Massenimport von Monitoren — Die Importseite zeigt das Beispielformat sowie das Ergebnis nach dem Hochladen der Datei.

Klicken Sie im Dashboard auf CSV importieren.
Auf der Importseite sehen Sie das CSV-Beispielformat - bereiten Sie Ihre Monitore danach vor und speichern Sie die Datei als CSV (UTF-8).
Klicken Sie auf Datei auswählen, laden Sie die CSV hoch und bestätigen Sie mit der Schaltfläche Importieren.
Nach Abschluss werden die Anzahl der erstellten Monitore und eventuell übersprungene Zeilen mit Grund angezeigt (zum Beispiel unbekannter Typ oder überschrittenes Tariflimit).

Achten Sie auf das Tariflimit: Würde der Import die Anzahl der Monitore in Ihrem Tarif überschreiten, stoppt er an der Grenze des Limits und die restlichen Zeilen werden als übersprungen markiert. Den aktuellen Stand (X / Y Monitore) sehen Sie oben links im Dashboard.

Häufige Fehler in der CSV

Unbekannter Typ - ein Tippfehler in der Spalte type. Prüfen Sie die Liste der zulässigen Werte.
Fehlendes target - außer beim Typ heartbeat muss jeder Monitor ein Ziel haben.
Anführungszeichen im Schlüsselwort - wenn expected_keyword Anführungszeichen enthält, müssen sie mit einem Backslash geschrieben (sogenannt escaped) werden: "\"status\":\"ok\"".
Semikolon statt Komma - in manchen Ländern speichert Excel CSV mit einem Semikolon. Wählen Sie beim Speichern das Format "CSV UTF-8 (durch Trennzeichen getrennt)".
Datei zu groß - die maximale Größe der CSV-Datei beträgt 2 MB. Für einen üblichen Import von Dutzenden bis Hunderten Monitoren reicht das reichlich.

Tipp: Nach dem Import führen alle Monitore innerhalb einer Minute ihre erste Prüfung durch. Warten Sie einfach und beobachten Sie das Dashboard.