Bulk import monitors via CSV | Help en handleidingen ePulz.io

Als u overstapt van een andere tool voor websitemonitoring of als u 20 of meer sites hebt, is ze handmatig toevoegen tijdverspilling. Bulkimport uploadt in één keer een CSV-bestand (een als tekst opgeslagen tabel) en maakt daar tientallen monitors van.

Het CSV-bestand voorbereiden

Het CSV-bestand maakt u in Excel, Google Sheets of in een willekeurige teksteditor. Sla het op in UTF-8-codering (ondersteuning van accenttekens). De eerste rij bevat de kolomnamen, de volgende rijen de afzonderlijke monitors.

name,type,target,interval_minutes,expected_status,expected_keyword
"Startpagina",http,https://www.mijnbedrijf.nl,5,200,"Welkom"
"API health",http,https://api.mijnbedrijf.nl/health,1,200,"\"status\":\"ok\""
"DB-server",tcp,db.mijnbedrijf.nl:5432,5,,
"Email MX",dns,mijnbedrijf.nl,30,,
"SSL-certificaat",ssl,www.mijnbedrijf.nl,1440,,

Kolommen

name - verplicht, max. 120 tekens. De naam die u in het overzicht ziet.
type - verplicht. Een van: http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - verplicht (behalve bij het type heartbeat). URL, hostnaam of host:port afhankelijk van het monitortype.
interval_minutes - optioneel, standaard 5. Het minimum hangt af van uw abonnement.
expected_status - optioneel, geldt alleen bij de http-monitor. De verwachte responscode (standaard 200).
expected_keyword - optioneel. Bij het type http controleert het of de tekenreeks in de body van de respons voorkomt; bij het type dns controleert het of die in de waarde van het DNS-record voorkomt.

Bij LAN-types (lan_*) wordt de monitor aan uw bestaande LAN-agent toegewezen en voert u als doel het lokale IP-adres of de hostnaam in (bijvoorbeeld 192.168.1.10).

Importprocedure

Pagina voor de bulk-CSV-import van monitors — De importpagina toont het voorbeeldformaat en het resultaat na het uploaden van het bestand.

Klik in het dashboard op CSV importeren.
Op de importpagina ziet u het voorbeeld-CSV-formaat - bereid uw monitors daarop voor en sla het bestand op als CSV (UTF-8).
Klik op Bestand kiezen, upload de CSV en bevestig met de knop Importeren.
Na afloop verschijnt het aantal aangemaakte monitors en eventuele overgeslagen rijen met de reden (bijvoorbeeld een onbekend type of een overschreden abonnementslimiet).

Let op de abonnementslimiet: als de import het aantal monitors in uw abonnement zou overschrijden, stopt hij bij de limietgrens en worden de resterende rijen als overgeslagen gemarkeerd. De huidige stand (X / Y monitors) ziet u linksboven in het dashboard.

Veelvoorkomende fouten in de CSV

Onbekend type - een typfout in de kolom type. Controleer de lijst met toegestane waarden.
Ontbrekend doel - behalve bij het type heartbeat moet elke monitor een doel hebben.
Aanhalingstekens in het trefwoord - als expected_keyword aanhalingstekens bevat, moeten ze met een backslash worden geschreven (zogenaamd escapen): "\"status\":\"ok\"".
Puntkomma in plaats van komma - in sommige landen slaat Excel CSV op met een puntkomma. Kies bij het opslaan het formaat "CSV UTF-8 (gescheiden door komma's)".
Bestand te groot - de maximale grootte van het CSV-bestand is 2 MB. Voor een normale import van tientallen tot honderden monitors is dat ruim voldoende.

Tip: Na de import voeren alle monitors hun eerste controle binnen een minuut uit. U hoeft alleen te wachten en het dashboard in de gaten te houden.