Modèles

Vue d'ensemble

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

L'export du modèle contient :

• Groupes de modèles liés
• Groupes d'hôtes liés (si utilisés dans la configuration de prototype d'hôte)
• Données du modèle
• Liaison à d'autres modèles
• Liaison à 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
• Correspondances 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 pour exporter au format YAML par défaut, ou cliquez sur la flèche pour sélectionner un autre format d'exportation.

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 ;
• 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. Accédez à Collecte de données > Modèles.
2. Cliquez sur Importer dans le coin supérieur droit.
3. Sélectionnez le fichier d’importation.
4. Cochez les cases correspondant aux règles d’importation que vous souhaitez appliquer (voir ci-dessous).
5. 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 pouvant être importés s’affiche. Cochez ou décochez chaque règle d’importation selon vos besoins.

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

Règles d’importation :

L’écran suivant vous permet d’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 seront mis en évidence en rouge et les éléments qui n’ont pas changé seront affichés sur un arrière-plan gris.

Le menu situé à gauche permet de 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és 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.

Vérifiez les modifications apportées au modèle, puis cliquez sur Importer pour effectuer l’importation du modèle. Un message indiquant la réussite ou l’échec de l’importation s’affichera dans l’interface.

Format d'export

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

Chaque élément remplit une fonction spécifique et peut contenir des éléments imbriqués.

Les sections suivantes décrivent chaque élément dans le 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 (voir le tableau ci-dessous) 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: (see table below)
  triggers: (see table below)
  graphs: (see table below)

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: |
        ## Vue d'ensemble

        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: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Délai d''expiration après lequel l''agent est considéré comme indisponible. Fonctionne uniquement pour les agents joignables depuis le serveur/proxy Zabbix (mode passif).'
          config: (see table below)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Seuil critique d''utilisation du CPU exprimé en %.'
          config: (see table below)
        (...)
      dashboards: (see table below)
      valuemaps: (see table below)
    (...)

Éléments du modèle

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Ping de l’agent Zabbix'
          key: agent.ping
          description: 'L’agent renvoie toujours « 1 » pour cet élément. Peut être utilisé avec `nodata()` pour vérifier la disponibilité.'
          valuemap:
            name: 'État du ping de l’agent Zabbix'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Nombre de paquets installés'
          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: 'Utilisation de la mémoire'
          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 de la valeur de l'élément du 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 mémoire élevée'
              event_name: 'Linux: Utilisation mémoire élevée (>{$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 du modèle

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Network interface discovery'
          key: net.if.discovery
          delay: 1h
          filter: (see table below)
          description: 'The discovery of network interfaces.'
          item_prototypes: (see table below)
          trigger_prototypes: (see table below)
          graph_prototypes: (see table below)
        (...)

Filtres de règle de découverte bas niveau du modèle

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 remplacement de règle de découverte de bas niveau du modèle

Modèles de scénarios web

É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: Thresholds
            label: 'Seuil d utilisation CPU exprimé'
            description: 'Seuil critique d utilisation CPU 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 déclencheur lorsque l état opérationnel de l interface change à "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: (see table below)
        (...)

Widgets du tableau de bord du modèle

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              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})]: Space utilization chart (relative to 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})]: Space usage graph, in % (relative to max available)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

Modèles de correspondance de valeurs

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.