Exportation/importation CSV

L'exportation/importation CSV est utilisée pour les tâches suivantes :

  • Manipulation de masse - ajout de dispositifs, de groupes, de tâches et d'instances de modèles
  • Manipulation de masse - mise à jour des dispositifs et des tâches (seuils, noms, intervalles, paramètres des tâches)
  • Manipulation de masse - suppression de tâches
  • Fonctionnalité des modèles
  • Inventaire détaillé, y compris les seuils

L'exportation/importation CSV ne prend en compte que deux niveaux de groupe au-dessus d'un appareil. Les appareils et les travaux situés dans des structures arborescentes plus profondes ne seront exportés qu'avec deux groupes au-dessus.

Pour utiliser la fonction d'exportation, naviguez jusqu'à /root/Configurations et sélectionnez la fonction appropriée dans le menu ou cliquez sur l'icône d'exportation CSV :

L'importation et l'exportation sont exécutées en tant qu'utilisateur qui initie l'action ou qui édite l'objet Scheduler (exportation uniquement). Lors de l'importation d'un fichier CSV, celui-ci doit avoir le même format que lorsqu'il a été créé par la fonction d'exportation.

Chaque colonne possède une balise (en lettres majuscules) dans la ligne d'en-tête pour identifier le type de la colonne. Les balises décrites dans la section suivante sont définies.

CSV - balises de groupe

BaliseDescription
NOM_GROUPE_1Nom du groupe sous le parent d'importation/d'exportation
NOM_DE_GROUPE_2Nom du groupe en dessous de GROUP_NAME_1 (au-dessus des appareils)

CSV - balises de l'appareil

ÉtiquetteDescription de la balise
DEVICE_NAMENom de l'appareil. Cette balise ne doit pas être vide pour les opérations d'ajout/mise à jour.
DEVICE_TYPEType de dispositif. Clés possibles : firewall, firewall_pix, gateway, host, ids_ips, interface, other, proxy, printer, router, server, ssl, switch, vpn, wlan
ADRESSE_DU_DISPOSITIFNom DNS ou adresse IP de l'appareil
DEVICE_SUBNET_MASKMasque de sous-réseau de l'appareil

CSV - balises de travail

ÉtiquetteDescription
JOB_NAMENom du travail. Cette balise ne doit pas être vide pour les opérations d'ajout/mise à jour.
JOB_TYPE

Type de travail. Cet élément ne peut pas être modifié.

Clés possibles pour l'opération d'ajout : dhcp, remote_disk, dns, dns_query, fetchfile, http, ping, imap, remote_nwinterface, parsefile, pop3, remote_process, shell, smtp, snmp, sql, tcp, buslay

JOB_AGENTNom de connexion du collecteur qui exécutera le travail.
JOB_INTERVAL

Intervalle en secondes.

Valeurs possibles : 5, 10, 20, 30, 40, 50, 60 (1 minute), 120 (2 minutes), 180 (3 minutes), 240 (4 minutes), 300 (5 minutes), 360 (6 minutes), 600 (10 minutes), 1800 (30 minutes), 3600 (1 heure), 7200 (2 heures), 21600 (6 heures), 43200 (12 heures), 86400 (1 jour), 604800 (7 jours)

JOB_EXECUTIONValeurs possibles : démarré, arrêté
JOB_PARAMETERS

Chaîne contenant tous les paramètres nécessaires à l'exécution d'un travail. Veuillez noter que \r doit être encodé comme $!r!$ et \n comme $!n!$.

Exemple pour un job ICMP : interval_mode=0&packets=10&bytes=56&icmpid_random=0

JOB_ALARM_LIMITS

Chaîne de limite d'alarme.

Exemple pour un job ICMP : WarningCond=Or&Warning1=error_code;<>;0;1;&MajorCond=Or&Major1=packetloss;%3d;100;1 ;

CSV - Balises PID

Il existe plusieurs balises PID qui contiennent des propriétés et des propriétés personnalisées attribuées aux objets. Ces colonnes sont créées si le contenu standard ou complet est spécifié dans l'exportation.

Exemple : PID Serial No

CSV - autres balises

ÉtiquetteDescription
TEMPLATE_NAMENom du modèle auquel un appareil ou une instance de travail est lié(e)
TYPEType d'objet (groupe, appareil, tâche), non modifiable
IDIdentifiant de l'objet pour l'opération de mise à jour/suppression
COMMANDE

Valeurs possibles :

ignore: la ligne est ignorée (comme si elle était supprimée d'un fichier csv)

utiliser: S'il ne s'agit pas d'une opération d'ajout ou de mise à jour, la ligne est utilisée en tant que parent pour l'ajout d'autres éléments (nécessaire pour les travaux et les modèles).

add: Ajouter un objet (pour les travaux : un dispositif doit être défini à l'aide de la commande add, use ou update)

update: Mise à jour de la configuration (les types de travaux ne peuvent pas être modifiés)

delete (supprimer): Seuls les travaux peuvent être supprimés

CSV - exportation

Pour créer un objet d'exportation, naviguez vers /root/Configurations et sélectionnez Add CSV Export :


Exemple de configuration :

PropriétéDescription de l'objet
NomNom de la configuration d'exportation
Séparateur de colonneChoisissez l'une des options suivantes : , ; | : ou tabulation
Groupe inférieurPoint d'entrée de l'arbre des objets. Les objets situés en dessous de ce groupe sont exportés. Naviguez jusqu'au groupe contenant les dispositifs à exporter
Contenu

Permet de sélectionner la quantité de données à exporter. Les balises NOM_GROUPE_1 et NOM_GROUPE_2 ne sont exportées que si des groupes sont sélectionnés dans la configuration. Les balises de périphérique ne sont exportées que si des périphériques sont sélectionnés. Les balises job ne sont exportées que si des jobs sont sélectionnés. Si seuls des travaux sont exportés, la balise DEVICE_NAME est ajoutée à titre d'information.

Basique : comprend : GROUP_NAME_1, GROUP_NAME_2, DEVICE_NAME, DEVICE_TYPE, DEVICE_ADDRESS, JOB_NAME, JOB_TYPE, JOB_AGENT, JOB_INTERVAL, JOB_EXECUTION, JOB_PARAMETERS, JOB_ALARM_LIMITS, TEMPLATE_NAME, TYPE, ID, COMMAND

Complet : comprend le contenu de base et DEVICE_SUBNET_MASK, DEVICE_SYSLOG_SOURCE, DEVICE_SYSLOG_LEVEL, DEVICE_WEB_LINK, DEVICE_REMOTE_ACCESS, ainsi que toutes les balisesPID.

GroupesEn cochant cette case, le fichier contiendra également le nom du groupe qui contient les objets, ainsi que le nom du groupe affilié au groupe.
Appareils, emploisDans cette section, la quantité d'entrées dans le fichier CSV peut être réduite en définissant un filtre comme indiqué dans l'exemple de configuration ci-dessus.


Pour générer un fichier d'exportation, naviguez jusqu'au nouvel objet, cliquez sur Générer et appuyez sur le bouton Générer dans le panneau de droite :

Après la génération, ouvrez le fichier CSV avec Internet Explorer, Firefox, Excel ou tout autre tableur, ou enregistrez-le localement. Modifiez les paramètres si vous le souhaitez ou laissez-les tels quels.

Exemple de sortie d'un fichier d'exportation CSV :


CSV - importation

Naviguez jusqu'à /root/Configurations et sélectionnez Ajouter une importation CSV:

Configuration :


PropriétéDescription de la propriété
NomNom de la configuration d'importation CSV
Séparateur de colonnesChoisissez entre , ; | : ou tabulation, en fonction du séparateur utilisé dans le fichier à importer.
Groupe inférieurPoint d'entrée de l'arbre des objets pour ajouter des objets en dessous. Pour les commandes de mise à jour, de suppression et d' utilisation, le type et l'identifiant du fichier CSV sont utilisés et cette entrée de configuration est ignorée.
FichierLe fichier CSV à importer. Les entrées vides sont effacées. Les entrées inexistantes ne sont pas modifiées pour les objets existants et sont laissées vides pour les objets ajoutés.
Fichier de téléchargementZone de téléchargement des fichiers d'importation CSV préparés

Avant de lancer une importation, un contrôle de cohérence du fichier est effectué ; il peut être lancé manuellement en appuyant sur Vérifier. Un aperçu statistique est affiché sur la page d'importation. Le fichier journal contient plus d'informations pour chaque ligne traitée.

CSV - exemple d'importation

Un fichier CSV précédemment exporté peut être utilisé comme modèle pour l'importation. De nouveaux appareils, tâches et instances de modèles d'appareils ou de tâches peuvent être ajoutés à l'aide de la configuration présentée ci-dessous. Après l'exportation, toutes les commandes sont par défaut ignorées.

Dans l'exemple suivant, deux appareils avec deux tâches chacun doivent être ajoutés sous le groupe existant Région Zurich sous le groupe Appareils. La colonne ID a été laissée dans les objets exportés pour identifier les groupes existants. La colonne de commande a été modifiée, passant d'ignorer à utiliser pour les groupes et à ajouter pour les nouveaux périphériques et les nouveaux travaux :

Utilisez n'importe quel objet d'importation existant ou créez-en un nouveau à l'aide de la commande Ajouter une importation CSV. Le même objet d'importation peut être utilisé pour différentes tâches d'importation. Plusieurs objets d'importation peuvent être créés pour de futures procédures d'importation automatisées.

Cliquez sur Importer pour ouvrir la configuration de l'importation :

Glissez-déposez le fichier CSV préparé dans la zone Upload File et cliquez sur Check:

Si la vérification échoue, ouvrez le fichier journal fourni sous la section Détails du résultat et corrigez les erreurs dans le fichier d'importation :

Si la vérification a réussi, vérifiez les objets répertoriés dans la section Détails du résultat et cliquez sur Importer:

Une fois l'importation terminée, les détails du résultat s'affichent à nouveau :

Les objets résultants devraient maintenant apparaître sous le chemin d'accès sélectionné :

CSV - importation avec des modèles

Lors de l'importation CSV, la colonne TEMPLATE_NAME du fichier CSV source peut être utilisée pour créer des instances de modèles existants. Notez ce qui suit à propos des importations de modèles :

  • La colonne TEMPLATE_NAME n'est interprétée que si la commande add est utilisée pour la ligne correspondante.
  • L'importation vérifie s'il existe exactement un modèle de premier niveau du type approprié, sinon elle indique une erreur.
  • Les modèles sont pris en charge pour les groupes, les dispositifs et les travaux.
  • Les nouveaux objets sont créés en tant qu'instances à partir du modèle.
  • Les groupes et les appareils sont ajoutés sous le parent actuel
  • Les travaux sont ajoutés sous le dispositif actuel (le dernier ajouté ou défini par la commande "use").
  • Il n'est pas possible d'ajouter un groupe sous un appareil.