14. Exportation/importation de la configuration

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 déposez le sur share.zabbix.com. Ensuite, d’autres pourront télécharger le modèle l'importe dans Zabbix.
• intégration avec des outils tiers - les formats universels YAML, XML et JSON permettent 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 réseau
• Les types de media
• Les images

Format d'exportation

Les données peuvent être exportées à l'aide de l'interface Web Zabbix ou de l'API Zabbix. Les formats d'exportation pris en charge sont YAML, XML and JSON.

Détails sur l'exportation

• Tous les éléments pris en charge sont exportés dans un fichier.
• Les entités d'hôte et de modèle (éléments, déclencheurs, graphiques, règles de découverte) héritées de 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'importation

• 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 "imagetype" est ignoré, c'est-à-dire qu'il est impossible de modifier le type d'image via l'importation.
• Lorsque vous importez des hôtes ou des modèles à l'aide de l'option "Supprimer les manquants", les macros d'hôtes ou de modèles non présentes dans le fichier importé seront également supprimées.
• 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 graphiques 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 YAML, XML et JSON, le fichier d'importation doit avoir une extension de fichier correcte : .yaml and .yml pour YAML, .xml pour XML et .json pour JSON.
• Voir les informations de compatibilité sur les versions XML supportées.

Format de base YAML

zabbix_export:
         version: '6.0'
         date: '2020-04-22T06:20:11Z'

zabbix_export:

Nœud racine pour l'exportation Zabbix YAML.

version: '6.0'

Version de l'exportation.

date: '2020-04-22T06:20:11Z'

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

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

Format XML

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>6.0</version>
           <date>2020-04-22T06: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'exportation XML Zabbix.

<version>6.0</version>

Version de l'exportation.

<date>2020-04-22T06: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.

Format JSON

{
           "zabbix_export": {
               "version": "6.0",
               "date": "2020-04-22T06:20:11Z"
           }
       }

  "zabbix_export":

Nœud racine pour l'exportation Zabbix JSON.

      "version": "6.0"

Version de l'exportation.

      "date": "2020-04-22T06:20:11Z"

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

Les autres nœuds dépendent des objets exportés.