Exportation/importation CSV

L'export/import CSV est utilisé pour les tâches suivantes : 

  • Manipulation en masse - ajout d'équipements, de groupes, de jobs et d'instances de modèles
  • Manipulation en masse - mise à jour d'équipements et de jobs (seuils, noms, intervalles, paramètres de job)
  • Manipulation en masse - suppression de jobs
  • Fonctionnalité de modèle
  • Inventaire détaillé incluant les seuils

L'export/import CSV ne prend en compte que deux niveaux de groupes au-dessus d'un équipement. Les équipements et les jobs situés dans des arborescences plus profondes ne seront exportés qu'avec deux groupes au-dessus.

 

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

L'import et l'export sont exécutés en tant que l'utilisateur qui lance l'action ou modifie l'objet du planificateur (export uniquement). Lors de l'import d'un fichier CSV, celui-ci doit avoir le même format que lors de sa création par la fonction d'export.

Chaque colonne comporte une balise (en lettres majuscules) dans la ligne d'en-tête afin d'identifier le type de la colonne. Les balises présentées dans la section suivante sont définies.

CSV - balises de groupe

 

BaliseDescription
GROUP_NAME_1Nom du groupe sous le parent d'import/export
GROUP_NAME_2Nom du groupe sous GROUP_NAME_1 (au-dessus des équipements)              

CSV - balises d'équipement

BaliseDescription
DEVICE_NAMENom de l'équipement. Cette balise ne doit pas être vide pour une opération add/update
DEVICE_TYPEType de l'équipement. Clés possibles : firewall, firewall_pix, gateway, host, ids_ips, interface, other, proxy, printer, router, server, ssl, switch, vpn, wlan
DEVICE_ADDRESSNom DNS ou adresse IP de l'équipement
DEVICE_SUBNET_MASKMasque de sous-réseau de l'équipement

 

CSV - balises de job

BaliseDescription
JOB_NAMENom du job. Cette balise ne doit pas être vide pour une opération add/update
JOB_TYPE

Type du job. Cet élément ne peut pas être modifié.

Clés possibles pour l'opération add : 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 job
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 : started, stopped
JOB_PARAMETERS

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

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

JOB_ALARM_LIMITS

Chaîne des limites 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 diverses balises PID qui contiennent les propriétés et les propriétés personnalisées attribuées aux objets. Ces colonnes sont créées si un contenu Standard ou Full est spécifié lors de l'export.

Exemple : PID Serial No

CSV - autres balises

BaliseDescription
TEMPLATE_NAMENom du modèle auquel une instance d'équipement ou de job est liée
TYPEType d'objet (group, device, job), ne peut pas être modifié
IDID d'objet pour une opération update/delete
COMMAND

Valeurs possibles :

ignore : La ligne est ignorée (comme si elle était supprimée du fichier CSV)

use : Si ce n'est pas add/update, utilisé comme parent sous lequel ajouter (nécessaire pour les jobs et les modèles)

add : Ajouter l'objet (pour les jobs : un équipement doit être défini avec la commande add, use ou update)

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

delete : Seuls les jobs peuvent être supprimés

CSV - export

Pour créer un objet d'export, accédez à /root/Configurations et sélectionnez Add CSV Export :


Exemple de configuration :

 

PropriétéDescription
NameNom de la configuration d'export
Column separatorChoisissez l'un des séparateurs suivants : , ; | : ou tab
Below groupPoint d'entrée de l'arborescence d'objets. Les objets situés sous ce groupe sont exportés. Parcourez jusqu'au groupe contenant les équipements à exporter 
Content

Permet de sélectionner la quantité de données à exporter. Les balises GROUP_NAME_1 et GROUP_NAME_2 ne sont exportées que si des groupes sont sélectionnés dans la configuration. Les balises d'équipement ne sont exportées que si des équipements sont sélectionnés. Les balises de job ne sont exportées que si des jobs sont sélectionnés. Si seuls des jobs sont exportés, la balise DEVICE_NAME est ajoutée à titre d'information.

Basic : 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

Full : comprend le contenu de base ainsi que DEVICE_SUBNET_MASK, DEVICE_SYSLOG_SOURCE, DEVICE_SYSLOG_LEVEL, DEVICE_WEB_LINK, DEVICE_REMOTE_ACCESS, plus toutes les balises PID

GroupsEn cochant cette case, le fichier contiendra également le nom du groupe contenant les objets, ainsi que le nom du groupe parent associé
Devices, JobsDans cette section, le nombre d'entrées dans le fichier CSV peut être réduit en définissant un filtre comme indiqué dans l'exemple de configuration ci-dessus


Pour générer un fichier d'export, accédez au nouvel objet, cliquez sur Generate et appuyez sur le bouton Generate dans le panneau de droite :

Après la génération, ouvrez le fichier CSV avec Internet Explorer, Firefox, Excel ou tout 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'export CSV :


CSV - import 

Accédez à /root/Configurations et sélectionnez Add CSV Import :

Configuration :


PropriétéDescription
NameNom de la configuration d'import CSV
Column separatorChoisissez l'un des séparateurs suivants : , ; | : ou tab, selon le séparateur utilisé dans le fichier à importer
Below groupPoint d'entrée de l'arborescence d'objets sous lequel ajouter des objets. Pour les commandes update, delete et use, les valeurs type et id dans le fichier CSV sont utilisées et cette entrée de configuration est ignorée
FileLe 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
Upload FileZone permettant de téléverser les fichiers d'import CSV préparés

Avant le démarrage d'un import, une vérification de cohérence du fichier est effectuée et peut être lancée manuellement en appuyant sur Check. Un aperçu statistique s'affiche sur la page d'import. Le fichier journal contient plus d'informations pour chaque ligne traitée.

CSV - exemple d'import

Un fichier CSV précédemment exporté peut servir de modèle pour l'import. De nouveaux équipements, jobs et instances de modèle d'équipement ou de job peuvent être ajoutés à l'aide de la configuration présentée ci-dessous. Après l'export, toutes les commandes sont définies par défaut sur ignore.

Dans l'exemple suivant, deux équipements avec deux jobs chacun doivent être ajoutés sous le groupe existant Region Zurich situé sous le groupe Devices. La colonne ID a été conservée à partir des objets exportés pour identifier les groupes existants. La colonne command a été modifiée de ignore à use pour les groupes et à add pour les nouveaux équipements et jobs :

 

Utilisez n'importe quel objet d'import existant ou créez-en un nouveau avec Add CSV Import. Le même objet d'import peut être utilisé pour différentes tâches d'import. Plusieurs objets d'import peuvent être créés pour de futures procédures d'import automatisées. 

Cliquez sur Import pour ouvrir la configuration d'import :

 

Faites glisser et 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 Result Details et corrigez les erreurs dans le fichier d'import :

 

Si la vérification a réussi, vérifiez les objets répertoriés dans la section Result Details et cliquez sur Import :

 

Une fois l'import terminé, les détails des résultats s'affichent à nouveau :

 

Les objets obtenus devraient maintenant apparaître sous le chemin d'arborescence d'entrée sélectionné :

CSV - import avec modèles

Lors de l'utilisation de l'import CSV, la colonne TEMPLATE_NAME du fichier CSV source peut être utilisée pour créer des instances de modèles existants. Notez les points suivants concernant les imports 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'import vérifie s'il existe exactement un modèle de niveau supérieur du type approprié, sinon il signale une erreur
  • Les modèles sont pris en charge pour les groupes, les équipements et les jobs
  • Les nouveaux objets sont créés en tant qu'instances à partir du modèle
  • Les groupes et les équipements sont ajoutés sous le parent actuel
  • Les jobs sont ajoutés sous l'équipement actuel (le dernier ajouté ou défini par la commande « use »)
  • Il n'est pas possible d'ajouter un groupe sous un équipement