14. Configuration export/import

Aperçu

La fonctionnalité d'exportation/importation de Zabbix permet d'échanger diverses entités de configuration entre un système Zabbix et un autre.

Cas d'utilisation typiques pour cette fonctionnalité :

• partager des modèles ou des cartes réseau - les utilisateurs de Zabbix peuvent partager leurs paramètres de configuration
• partager des scénarios Web sur share.zabbix.com - exportez un modèle avec les scénarios Web et téléchargez-le sur share.zabbix.com. Ensuite, d’autres peuvent télécharger le modèle et importer le code XML dans Zabbix.
• intégration avec des outils tiers - le format universel XML permet l'intégration et l'importation/exportation de données avec des outils et des applications tiers

Que peut-on exporter/importer ?

Les objets pouvant être exportés/importés sont :

• Les groupes d'hôtes (via l'API Zabbix uniquement)
• Les modèles
• Les hôtes
• Les cartes de réseau
• Les images
• Les écrans
• Les tables de correspondances de valeurs

Format d'export

Les données peuvent être exportées à l'aide de l'interface Web Zabbix ou de l'API Zabbix. Les formats d'export pris en charge sont les suivants :

• XML - dans l'interface web
• XML ou JSON - dans l'API Zabbix

Détails sur l'export

• Tous les éléments pris en charge sont exportés dans un fichier.
• Les entités hôte et modèle (éléments, déclencheurs, graphiques, règles de découverte) héritées des modèles liés ne sont pas exportées. Toutes les modifications apportées à ces entités au niveau de l'hôte (telles que la modification de l'intervalle de l'élément, la modification de l''expression régulière ou les prototypes ajoutés à la règle de découverte de bas niveau) seront perdues lors de l'exportation. Lors de l'importation, toutes les entités des modèles liés sont recréées comme sur le modèle lié d'origine.
• Les entités créées par la découverte de bas niveau et les entités qui en dépendent ne sont pas exportées. Par exemple, un déclencheur créé pour un élément généré par une règle LLD ne sera pas exporté.

Détails sur l'import

• L'importation s'arrête à la première erreur.
• Lors de la mise à jour d'images existantes lors de l'importation d'images, le champ "type d'image" est ignoré, c'est-à-dire qu'il est impossible de modifier le type d'image via l'import.
• Lorsque vous importez des hôtes ou des modèles à l'aide de l'option «Supprimer les éléments manquants», les macros hôtes ou modèles non présents dans le fichier XML importé seront également supprimés.
• Les tags vides pour les éléments, déclencheurs, graphiques, applications hôte ou modèle, règles de découvertes, prototypes d'éléments, prototypes de déclencheurs, prototypes de graphes n'ont pas de sens, c'est-à-dire qu'ils sont identiques à ceux manquants. Les autres tags, par exemple, les applications des éléments, ont un sens, c’est-à-dire que les tags vides signifient qu’il n’y a pas d’applications pour l'élément, que les tags manquants empêchent de mettre à jour les applications.
• L'importation prend en charge XML et JSON, le fichier d'import doit avoir une extension de fichier correcte : .xml pour XML et .json pour JSON.
• Voir les informations de compatibilité sur les versions XML supportées.

Format de base XML

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>4.0</version>
           <date>2016-10-04T06:20:11Z</date>
       </zabbix_export>

<?xml version="1.0" encoding="UTF-8"?>

En-tête par défaut pour les documents XML.

<zabbix_export>

Elément racine pour l'export XML Zabbix.

<version>4.0</version>

Version d'export.

<date>2016-10-04T06:20:11Z</date>

Date à laquelle l'exportation a été créée au format long ISO 8601.

Les autres tags dépendent des objets exportés.