12 Export/import de 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
  • téléchargez un modèle sur les modèles de la communauté Zabbix. Ensuite, d'autres peuvent télécharger le modèle et importer le fichier 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 :

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 seul 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. Toute modification apportée à ces entités au niveau de l’hôte (comme un intervalle d’élément modifié, une expression régulière modifiée ou des prototypes ajoutés à la règle de découverte de bas niveau) sera perdue lors de l’exportation ; lors de l’importation, toutes les entités des modèles liés sont recréées comme dans le modèle lié d’origine.
  • Les entités créées par la découverte de bas niveau ainsi que toutes 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é.
  • Lorsque l’hôte/modèle exporté contient des entités prenant en charge les délais d’expiration, les valeurs de délai d’expiration seront exportées si ces entités ont leurs propres délais d’expiration configurés.

Détails sur l'importation

  • L'importation s'arrête à la première erreur.
  • Lors de la mise à jour d'images existantes pendant 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.
  • Lors de l'importation d'hôtes/modèles avec l'option "Delete missing", les macros d'hôte/modèle qui ne sont pas présentes dans le fichier d'importation seront supprimées de l'hôte/modèle après l'importation.
  • Les balises vides pour les éléments, déclencheurs, graphiques, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes n'ont aucune signification, c'est-à-dire que c'est comme si elles étaient absentes.
  • Si les entités de l'hôte/modèle importé ont leurs propres délais d'expiration configurés, ils seront appliqués ; sinon, les délais d'expiration du proxy/globaux seront appliqués.
  • L'importation prend en charge YAML, XML et JSON ; le fichier d'importation doit avoir une extension correcte : .yaml et .yml pour YAML, .xml pour XML et .json pour JSON. Voir les informations de compatibilité concernant les versions XML prises en charge.
  • L'importation prend en charge uniquement les fichiers de configuration encodés en UTF-8 (avec ou sans BOM) ; les autres encodages (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) entraîneront une erreur de conversion lors de l'importation.

Format de base YAML

Le format d’export YAML contient les nœuds suivants :

  • Nœud racine pour l’export YAML de Zabbix
  • Version de l’export
zabbix_export:
  version: '8.0'

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

Format XML

Le format d’export XML contient les balises suivantes :

  • En-tête par défaut des documents XML
  • Balise racine pour l’export XML de Zabbix
  • Version de l’export
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
    <version>8.0</version>
</zabbix_export>

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

Format JSON

Le format d’export JSON contient les objets suivants :

  • Objet racine pour l’export JSON de Zabbix
  • Version de l’export
{
    "zabbix_export": {
        "version": "8.0"
    }
}

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