Importazione in massa di monitor via CSV

Se stai migrando da un altro strumento di monitoraggio dei siti web o hai 20 o più siti, aggiungerli manualmente è una perdita di tempo. L'importazione in blocco carica in una sola volta un file CSV (una tabella salvata come testo) e ne crea decine di monitor.

Preparazione del file CSV

Puoi preparare il CSV in Excel, Google Sheets o in un qualsiasi editor di testo. Salvalo nella codifica UTF-8 (supporto dei caratteri accentati). La prima riga contiene i nomi delle colonne, le righe successive i singoli monitor.

name,type,target,interval_minutes,expected_status,expected_keyword
"Pagina principale",http,https://www.miaazienda.it,5,200,"Benvenuto"
"API health",http,https://api.miaazienda.it/health,1,200,"\"status\":\"ok\""
"Server DB",tcp,db.miaazienda.it:5432,5,,
"Email MX",dns,miaazienda.it,30,,
"Certificato SSL",ssl,www.miaazienda.it,1440,,

Colonne

name - obbligatorio, max. 120 caratteri. Il nome che vedrai nella panoramica.
type - obbligatorio. Uno tra: http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - obbligatorio (tranne per il tipo heartbeat). URL, hostname o host:port a seconda del tipo di monitor.
interval_minutes - facoltativo, 5 per impostazione predefinita. Il minimo dipende dal tuo piano.
expected_status - facoltativo, si applica solo al monitor http. Il codice di risposta atteso (200 per impostazione predefinita).
expected_keyword - facoltativo. Nel tipo http verifica se la stringa è presente nel corpo della risposta; nel tipo dns verifica se è presente nel valore del record DNS.

Per i tipi LAN (lan_*) il monitor viene assegnato al tuo agente LAN esistente e come destinazione inserisci l'IP locale o l'hostname (ad esempio 192.168.1.10).

Procedura di importazione

Pagina di importazione in blocco dei monitor da CSV — La pagina di importazione mostra il formato di esempio e il risultato dopo il caricamento del file.

Nella dashboard fai clic su Importa CSV.
Nella pagina di importazione vedi il formato di esempio del CSV - prepara i tuoi monitor di conseguenza e salva il file come CSV (UTF-8).
Fai clic su Scegli file, carica il CSV e conferma con il pulsante Importa.
Al termine viene mostrato il numero di monitor creati e le eventuali righe saltate con il motivo (ad esempio tipo sconosciuto o limite del piano superato).

Attenzione al limite del piano: se l'importazione superasse il numero di monitor del tuo piano, si ferma al limite e le righe rimanenti vengono contrassegnate come saltate. Lo stato attuale (X / Y monitor) lo vedi in alto a sinistra nella dashboard.

Errori frequenti nel CSV

Tipo sconosciuto - un errore di battitura nella colonna type. Controlla l'elenco dei valori consentiti.
Destinazione mancante - tranne il tipo heartbeat, ogni monitor deve avere una destinazione.
Virgolette nella parola chiave - se expected_keyword contiene virgolette, vanno scritte con una barra rovesciata (il cosiddetto escaping): "\"status\":\"ok\"".
Punto e virgola invece della virgola - in alcuni paesi Excel salva il CSV con il punto e virgola. Al salvataggio scegli il formato "CSV UTF-8 (delimitato da virgole)".
File troppo grande - la dimensione massima del file CSV è 2 MB. Per una normale importazione di decine o centinaia di monitor è più che sufficiente.

Suggerimento: Dopo l'importazione tutti i monitor eseguono il primo controllo entro un minuto. Basta attendere e osservare la dashboard.