4 Hôtes

Vue d'ensemble

Les hôtes sont exportés avec de nombreux objets liés et relations entre objets.

L'export d'hôte contient :

• Les groupes d'hôtes liés
• Les données de l'hôte
• La liaison au modèle
• La liaison au groupe d'hôtes
• Les interfaces de l'hôte
• Les éléments directement liés
• Les déclencheurs directement liés
• Les règles de découverte directement liées avec tous les prototypes
• Les scénarios web directement liés
• Les macros d'hôte
• Les données d'inventaire de l'hôte
• Les correspondances de valeurs
• Les graphiques liés

Exportation

Pour exporter des hôtes, procédez comme suit :

1. Accédez à Collecte de données → Hôtes.
2. Cochez les cases des hôtes à exporter.
3. Cliquez sur Exporter sous la liste.

Selon le format sélectionné, les hôtes sont exportés vers un fichier local portant un nom par défaut :

• zabbix_export_hosts.yaml - pour l’exportation au format YAML (option par défaut pour l’exportation) ;
• zabbix_export_hosts.xml - pour l’exportation au format XML ;
• zabbix_export_hosts.json - pour l’exportation au format JSON.

Importation

Pour importer des hôtes, procédez comme suit :

1. Accédez à Collecte de données → Hôtes.
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 les 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 :

Un message indiquant le succès ou l'échec de l'importation sera affiché dans l'interface web.

Format d'exportation

Lorsqu'un hôte est exporté, Zabbix génère un format structuré YAML, JSON ou XML. L'exportation inclut des éléments de l'hôte, tels que les métadonnées de l'hôte, les éléments de données, les macros, les déclencheurs, 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'exportation. Les exemples utilisent un hôte avec le modèle MySQL by Zabbix agent 2. À des fins de démonstration des éléments, le modèle est dissocié après la création de l'hôte. La dissociation conserve tous les éléments dans la configuration (contrairement à la dissociation et à l'effacement, qui les suppriment).

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 de l'hôte

zabbix_export:
  version: '8.0'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (voir le tableau ci-dessous)
  graphs: (voir le tableau ci-dessous)

Hôtes

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (voir le tableau ci-dessous)
      items: (voir le tableau ci-dessous)
      discovery_rules: (voir le tableau ci-dessous)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.0
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'Mot de passe de l’utilisateur MySQL.'
        (...)
      valuemaps: (voir le tableau ci-dessous)
  (...)

Interfaces d'hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      interfaces:
        - ip: 192.0.2.0
          interface_ref: if1
      (...)

Éléments d'hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Utilisation du disque du cache binlog'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Nombre de transactions ayant utilisé un cache disque temporaire parce qu’elles ne pouvaient pas tenir dans le cache normal du journal binaire, car elles étaient plus grandes que `binlog_cache_size`.'
          preprocessing: (voir le tableau ci-dessous)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: cache
        (...)
        - name: 'Utilisation du buffer pool'
          type: CALCULATED
          key: mysql.buffer_pool_utilization
          value_type: FLOAT
          units: '%'
          params: |
            ( last(//mysql.innodb_buffer_pool_pages_total) - 
            last(//mysql.innodb_buffer_pool_pages_free) ) / 
            ( last(//mysql.innodb_buffer_pool_pages_total) + 
            ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * 
            ( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
          description: 'Rapport entre le nombre de pages utilisées et le nombre total de pages dans le buffer pool.'
          tags:
            - tag: component
              value: memory
          triggers: (voir le tableau ci-dessous)
        (...)
        - name: Temps de fonctionnement
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Nombre de secondes pendant lesquelles le serveur a été en fonctionnement.'
          preprocessing: (voir le tableau ci-dessous)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (voir le tableau ci-dessous)
        (...)

Étapes de prétraitement de la valeur d’un élément d’hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.Binlog_cache_disk_use
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 6h
          (...)

Déclencheurs d'élément d'hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: Uptime
          (...)
          triggers:
            - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
              name: 'MySQL: Failed to fetch info data'
              event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
              priority: INFO
              description: 'Zabbix has not received any data for items for the last 30 minutes.'
              dependencies:
                - name: 'MySQL: Service is down'
                  expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
              tags:
                - tag: scope
                  value: availability
            - expression: 'last(/MySQL server/mysql.uptime)<10m'
              name: 'MySQL: Service has been restarted'
              event_name: 'MySQL: Service has been restarted (uptime < 10m)'
              priority: INFO
              description: 'MySQL uptime is less than 10 minutes.'
              tags:
                - tag: scope
                  value: notice
        (...)

Règles de découverte de bas niveau de l'hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          delay: 1h
          filter: (see table below)
          description: 'Scanning databases in DBMS.'
          interface_ref: if1
          item_prototypes:
            - name: 'Size of database {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Database size.'
              preprocessing:
                - type: DISCARD_UNCHANGED_HEARTBEAT
                  parameters:
                    - 1h
              interface_ref: if1
              tags:
                - tag: component
                  value: storage
                - tag: database
                  value: '{#DATABASE}'
          lld_macro_paths:
            - lld_macro: '{#DATABASE}'
              path: $.Database
          preprocessing:
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 1d
        (...)

Filtres de règle de découverte de bas niveau d’hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.MATCHES}'
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)

Opérations de substitution de règle de découverte de bas niveau d’hôte

Scénarios web d'hôte

Étapes du scénario web

Graphiques d'hôte

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (voir le tableau ci-dessous)
    (...)

Éléments de graphique d’hôte

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items:
        - drawtype: GRADIENT_LINE
          color: 199C0D
          item:
            host: 'MySQL server'
            key: mysql.bytes_received.rate
        - sortorder: '1'
          drawtype: GRADIENT_LINE
          color: F63100
          item:
            host: 'MySQL server'
            key: mysql.bytes_sent.rate
    (...)

Correspondances de valeurs d'hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: Example value map
          mappings:
            - value: '1'
              newvalue: Example value
  (...)

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.