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
| Balise | Description |
|---|---|
| GROUP_NAME_1 | Nom du groupe sous le parent d'import/export |
| GROUP_NAME_2 | Nom du groupe sous GROUP_NAME_1 (au-dessus des équipements) |
CSV - balises d'équipement
| Balise | Description |
|---|---|
| DEVICE_NAME | Nom de l'équipement. Cette balise ne doit pas être vide pour une opération add/update |
| DEVICE_TYPE | Type de l'équipement. Clés possibles : firewall, firewall_pix, gateway, host, ids_ips, interface, other, proxy, printer, router, server, ssl, switch, vpn, wlan |
| DEVICE_ADDRESS | Nom DNS ou adresse IP de l'équipement |
| DEVICE_SUBNET_MASK | Masque de sous-réseau de l'équipement |
CSV - balises de job
| Balise | Description |
|---|---|
| JOB_NAME | Nom 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_AGENT | Nom 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_EXECUTION | Valeurs 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
| Balise | Description |
|---|---|
| TEMPLATE_NAME | Nom du modèle auquel une instance d'équipement ou de job est liée |
| TYPE | Type d'objet (group, device, job), ne peut pas être modifié |
| ID | ID 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 |
|---|---|
| Name | Nom de la configuration d'export |
| Column separator | Choisissez l'un des séparateurs suivants : , ; | : ou tab |
| Below group | Point 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 |
| Groups | En cochant cette case, le fichier contiendra également le nom du groupe contenant les objets, ainsi que le nom du groupe parent associé |
| Devices, Jobs | Dans 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 |
|---|---|
| Name | Nom de la configuration d'import CSV |
| Column separator | Choisissez l'un des séparateurs suivants : , ; | : ou tab, selon le séparateur utilisé dans le fichier à importer |
| Below group | Point 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 |
| File | Le 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 File | Zone 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













