Import en masse de moniteurs via CSV

Si vous migrez depuis un autre outil de surveillance de sites web ou si vous avez 20 sites ou plus, les ajouter à la main est une perte de temps. L'import en masse téléverse en une seule fois un fichier CSV (un tableau enregistré sous forme de texte) et en crée des dizaines de moniteurs.

Préparation du fichier CSV

Vous pouvez préparer le CSV dans Excel, Google Sheets ou n'importe quel éditeur de texte. Enregistrez-le en encodage UTF-8 (prise en charge des accents). La première ligne contient les noms des colonnes, les lignes suivantes les différents moniteurs.

name,type,target,interval_minutes,expected_status,expected_keyword
"Page d'accueil",http,https://www.monentreprise.fr,5,200,"Bienvenue"
"API health",http,https://api.monentreprise.fr/health,1,200,"\"status\":\"ok\""
"Serveur DB",tcp,db.monentreprise.fr:5432,5,,
"Email MX",dns,monentreprise.fr,30,,
"Certificat SSL",ssl,www.monentreprise.fr,1440,,

Colonnes

name - obligatoire, max. 120 caractères. Le nom que vous verrez dans la vue d'ensemble.
type - obligatoire. L'un de : http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - obligatoire (sauf pour le type heartbeat). URL, nom d'hôte ou host:port selon le type de moniteur.
interval_minutes - facultatif, 5 par défaut. Le minimum dépend de votre forfait.
expected_status - facultatif, s'applique uniquement au moniteur http. Le code de réponse attendu (200 par défaut).
expected_keyword - facultatif. Pour le type http, il vérifie si la chaîne se trouve dans le corps de la réponse ; pour le type dns, il vérifie si elle se trouve dans la valeur de l'enregistrement DNS.

Pour les types LAN (lan_*), le moniteur est rattaché à votre agent LAN existant et vous saisissez comme cible l'IP locale ou le nom d'hôte (par exemple 192.168.1.10).

Procédure d'import

Page d'import CSV en masse des moniteurs — La page d'import affiche le format d'exemple ainsi que le résultat après le téléversement du fichier.

Dans le tableau de bord, cliquez sur Importer un CSV.
Sur la page d'import, vous voyez le format d'exemple du CSV - préparez vos moniteurs en conséquence et enregistrez le fichier au format CSV (UTF-8).
Cliquez sur Choisir un fichier, téléversez le CSV et confirmez avec le bouton Importer.
Une fois terminé, le nombre de moniteurs créés s'affiche ainsi que les éventuelles lignes ignorées avec la raison (par exemple un type inconnu ou une limite de forfait dépassée).

Attention à la limite du forfait : si l'import dépassait le nombre de moniteurs de votre forfait, il s'arrête à la limite et les lignes restantes sont marquées comme ignorées. Vous voyez l'état actuel (X / Y moniteurs) en haut à gauche du tableau de bord.

Erreurs fréquentes dans le CSV

Type inconnu - une faute de frappe dans la colonne type. Vérifiez la liste des valeurs autorisées.
Cible manquante - sauf pour le type heartbeat, chaque moniteur doit avoir une cible.
Guillemets dans le mot-clé - si expected_keyword contient des guillemets, il faut les écrire avec une barre oblique inverse (ce qu'on appelle l'échappement) : "\"status\":\"ok\"".
Point-virgule au lieu d'une virgule - dans certains pays, Excel enregistre le CSV avec un point-virgule. Lors de l'enregistrement, choisissez le format "CSV UTF-8 (séparateur : virgule)".
Fichier trop volumineux - la taille maximale du fichier CSV est de 2 Mo. Pour un import classique de dizaines à centaines de moniteurs, c'est largement suffisant.

Astuce : Après l'import, tous les moniteurs lancent leur première vérification en moins d'une minute. Il suffit d'attendre et de surveiller le tableau de bord.