Sommaire
Export/import de configuration
Vue d'ensemble
La fonctionnalité d'export/import de Zabbix permet d'échanger diverses entités de configuration entre un système Zabbix et un autre.
Cas d'utilisation typiques de cette fonctionnalité :
- partager des modèles ou des cartes réseau - les utilisateurs de Zabbix peuvent partager leurs paramètres de configuration
- téléverser un modèle vers Zabbix Community templates. Ensuite, d'autres peuvent télécharger le modèle et importer le fichier dans Zabbix.
- s'intégrer à des outils tiers - les formats universels YAML, XML et JSON rendent possible l'intégration ainsi que l'import/export de données avec des outils et applications tiers
Ce qui peut être exporté/importé
Les objets pouvant être exportés/importés sont :
- Groupes d'hôtes (via l'API Zabbix uniquement)
- Groupes de modèles (via l'API Zabbix uniquement)
- Modèles
- Hôtes
- Cartes réseau
- Types de médias
- Images
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 YAML, XML et JSON.
Détails sur l'export
- Tous les éléments pris en charge sont exportés dans un seul fichier.
- Les entités de hôte et de 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. Toute modification apportée à ces entités au niveau d'un 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'export ; lors de l'import, toutes les entités provenant 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 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/le modèle exporté contient des entités prenant en charge les délais d'attente, les valeurs de délai d'attente seront exportées si ces entités ont leurs propres délais d'attente configurés.
Détails sur l'import
- L'import s'arrête à la première erreur.
- Lors de la mise à jour d'images existantes pendant l'import d'images, le champ "imagetype" est ignoré, c'est-à-dire qu'il est impossible de modifier le type d'image via l'import.
- Lors de l'import d'hôtes/modèles avec l'option "Delete missing", les macros d'hôte/modèle absentes du fichier d'import seront supprimées de l'hôte/modèle après l'import.
- 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'attente configurés, ils seront appliqués ; sinon, les délais d'attente du proxy/global seront appliqués.
- L'import prend en charge YAML, XML et JSON, le fichier d'import doit avoir une extension de fichier 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'import prend en charge les fichiers de configuration uniquement en encodage UTF-8 (avec ou sans BOM) ; les autres encodages (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) entraîneront une erreur de conversion lors de l'import.
Format de base YAML
Le format d'export YAML contient les nœuds suivants :
- Nœud racine pour l'export YAML de Zabbix
- Version d'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 pour les documents XML
- Balise racine pour l'export XML de Zabbix
- Version d'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 d'export
{
"zabbix_export": {
"version": "8.0"
}
}
Les autres objets dépendent des objets exportés.