3 Modèles

Aperçu

Les modèles sont exportés avec de nombreux objets associés et relations entre objets.

L'exportation d'un modèle contient :

• Groupes de modèles liés
• Groupes d'hôtes liés (s'ils sont utilisés dans la configuration des prototypes d'hôte)
• Données du modèle
• Liaison avec d'autres modèles
• Liaison avec des groupes de modèles
• Éléments directement liés
• Déclencheurs directement liés
• Graphiques directement liés
• Tableaux de bord directement liés
• Règles de découverte directement liées avec tous les prototypes
• Scénarios web directement liés
• Mappages de valeurs

Exportation

Pour exporter des modèles, procédez comme suit :

1. Accédez à Collecte de données → Modèles.
2. Cochez les cases des modèles à exporter.
3. Cliquez sur Exporter sous la liste.

Selon le format sélectionné, les modèles sont exportés vers un fichier local avec un nom par défaut :

• zabbix_export_templates.yaml - en export YAML (option par défaut pour l’exportation) ;
• zabbix_export_templates.xml - en export XML ;
• zabbix_export_templates.json - en export JSON.

Importation

Pour importer des modèles, procédez comme suit :

1. Allez dans Collecte de données → Modèles.
2. Cliquez sur Importer dans le coin supérieur droit.
3. Sélectionnez le fichier d'importation.
4. Cliquez sur Importer dans le coin inférieur droit du formulaire de configuration.

Si vous cochez la case Options avancées, une liste détaillée de tous les éléments importables s'affichera ; cochez ou décochez chaque règle d'importation selon vos besoins.

Si vous cliquez sur la case à cocher de la ligne Tous, tous les éléments en dessous seront cochés/décochés.

Règles d'importation :

Sur l'écran suivant, vous pourrez afficher le contenu d'un modèle en cours d'importation. S'il s'agit d'un nouveau modèle, tous les éléments seront affichés en vert. Lors de la mise à jour d'un modèle existant, les nouveaux éléments du modèle seront mis en évidence en vert ; les éléments supprimés du modèle seront mis en évidence en rouge ; les éléments qui n'ont pas changé seront affichés sur un fond gris.

Le menu de gauche peut être utilisé pour parcourir la liste des modifications. La section Mis à jour met en évidence toutes les modifications apportées aux éléments existants du modèle. La section Ajouté répertorie les nouveaux éléments du modèle. Les éléments de chaque section sont regroupés par type d'élément ; cliquez sur la flèche grise pour développer ou réduire le groupe d'éléments.

Passez en revue les modifications du modèle, puis cliquez sur Importer pour lancer l'importation du modèle. Un message indiquant le succès ou l'échec de l'importation s'affichera dans l'interface web.

Format d'export

Lorsqu'un modèle est exporté, Zabbix génère un format structuré YAML, JSON ou XML. L'export inclut des éléments du modèle, tels que les métadonnées du modèle, les éléments de données, les macros, les déclencheurs, les tableaux de bord, et plus encore.

Chaque élément remplit un objectif spécifique et peut contenir des éléments imbriqués.

Les sections suivantes décrivent chaque élément du format d'export. Les exemples utilisent le modèle Linux by Zabbix agent.

Une ellipse (...) indique des éléments omis par souci de concision. La note (see table below) est utilisée lorsque l'élément est expliqué plus en détail dans les sections suivantes.

Métadonnées du modèle

zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (voir le tableau ci-dessous)
  triggers: (voir le tableau ci-dessous)
  graphs: (voir le tableau ci-dessous)

Modèles

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        Il s'agit d'un modèle Linux officiel. Il nécessite Zabbix agent 8.0 ou une version plus récente. (...)
      wizard_ready: 'YES'
      readme: |
        ## Aperçu

        Il s'agit d'un modèle Linux officiel. Il nécessite Zabbix agent 8.0 ou une version plus récente. (...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Operating systems'
      items: (voir le tableau ci-dessous)
      discovery_rules: (voir le tableau ci-dessous)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Délai après lequel l''agent est considéré comme indisponible. Fonctionne uniquement pour les agents joignables depuis le serveur/proxy Zabbix (mode passif).'
          config: (voir le tableau ci-dessous)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Seuil critique d''utilisation du processeur exprimé en %.'
          config: (voir le tableau ci-dessous)
        (...)
      dashboards: (voir le tableau ci-dessous)
      valuemaps: (voir le tableau ci-dessous)
    (...)

Éléments de modèle

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Zabbix agent ping'
          key: agent.ping
          description: 'L''agent renvoie toujours "1" pour cet élément. Peut être utilisé en combinaison avec `nodata()` pour la vérification de disponibilité.'
          valuemap:
            name: 'Zabbix agent ping status'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Number of installed packages'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (voir le tableau ci-dessous)
          tags:
            - tag: component
              value: os
          triggers: (voir le tableau ci-dessous)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Memory utilization'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: 'Le pourcentage de mémoire utilisée est calculé comme `100-pavailable`.'
          preprocessing: (voir le tableau ci-dessous)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (voir le tableau ci-dessous)
        (...)

Étapes de prétraitement des valeurs d’élément de modèle

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.length()
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 12h
          (...)

Déclencheurs d’élément de modèle

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux : le nombre de paquets installés a changé'
              priority: WARNING
              manual_close: 'YES'
              tags:
                - tag: scope
                  value: notice
        (...)
        - uuid: 403cebed115441369e94d35d070ca7b8
          (...)
          triggers:
            - uuid: cfd395b1cde74ef18a5e5f840bd5142a
              expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
              name: 'Linux : utilisation élevée de la mémoire'
              event_name: 'Linux : utilisation élevée de la mémoire (>{$MEMORY.UTIL.MAX}% pendant 5m)'
              priority: AVERAGE
              description: 'Le système manque de mémoire libre.'
              dependencies:
                - name: 'Linux : manque de mémoire disponible'
                  expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
              tags:
                - tag: scope
                  value: capacity
                - tag: scope
                  value: performance
        (...)

Règles de découverte de bas niveau de template

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Découverte des interfaces réseau'
          key: net.if.discovery
          delay: 1h
          filter: (voir le tableau ci-dessous)
          description: 'La découverte des interfaces réseau.'
          item_prototypes: (voir le tableau ci-dessous)
          trigger_prototypes: (voir le tableau ci-dessous)
          graph_prototypes: (voir le tableau ci-dessous)
        (...)

Filtres des règles de découverte de bas niveau de template

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.MATCHES}'
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)
        - uuid: 2bbdc79f082d4c618e01bec625e9c90a
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.MATCHES}'
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
              - macro: '{#DEVTYPE}'
                value: disk
          (...)

Opérations de substitution de règle de découverte de bas niveau de modèle

Scénarios web de modèle

Étapes du scénario web

Configuration des macros de modèle

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Secondes depuis la dernière détection de l’agent Zabbix'
            description: 'Délai après lequel l’agent est considéré comme indisponible.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Seuils
            label: 'Seuil d’utilisation du processeur exprimé'
            description: 'Seuil critique d’utilisation du processeur exprimé en %. Dans la plage de 0 à 100 inclus.'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: 'Contrôle des interfaces'
            description: 'Déclencher un trigger lorsque l’état opérationnel de l’interface passe à "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Tableaux de bord de modèle

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (voir le tableau ci-dessous)
        (...)

Widgets de tableau de bord de modèle

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Systèmes de fichiers
          pages:
            - name: Vue d'ensemble
              widgets:
                - type: graphprototype
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '3'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})] : graphique d''utilisation de l''espace (par rapport au total)'
                    - type: STRING
                      name: reference
                      value: AAAEB
                - type: graphprototype
                  'y': '5'
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '1'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})] : graphique d''utilisation de l''espace, en % (par rapport au maximum disponible)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

Mappages de valeurs de modèle

zabbix_export:
  (...)
  templates:
    (...)
      valuemaps:
        - uuid: 8c048c6cca8248f2860c208e8db0f59e
          name: ifOperStatus
          mappings:
            - value: '0'
              newvalue: unknown
            - value: '1'
              newvalue: notpresent
            - value: '2'
              newvalue: down
            - value: '3'
              newvalue: lowerlayerdown
            - value: '4'
              newvalue: testing
            - value: '5'
              newvalue: dormant
            - value: '6'
              newvalue: up
        (...)

Notes de bas de page

¹ Les valeurs entières de l’API entre parenthèses, par exemple ENABLED (0), sont mentionnées uniquement à titre de référence. Pour plus d’informations, consultez la page de l’objet API liée dans l’entrée du tableau ou à la fin de chaque section.