Hôtes

Vue d'ensemble

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

L'export d'hôte contient :

• Groupes d'hôtes liés
• Données de l'hôte
• Liaison de modèle
• Liaison de groupe d'hôtes
• Interfaces de l'hôte
• Éléments directement liés
• Déclencheurs directement liés
• Règles de découverte directement liées avec tous les prototypes
• Scénarios web directement liés
• Macros de l'hôte
• Données d'inventaire de l'hôte
• Correspondances de valeurs
• 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 avec un nom par défaut :

• zabbix_export_hosts.yaml - en export YAML (option d'export par défaut) ;
• zabbix_export_hosts.xml - en export XML ;
• zabbix_export_hosts.json - en export 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 de la ligne Tous, tous les éléments situés en dessous seront cochés/décochés.

Règles d'importation :

Un message de réussite ou d'échec de l'importation s'affichera dans l'interface.

Format d'export

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

Chaque élément a 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 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 à la suppression, qui les supprime).

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 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: (see table below)
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.1
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'Mot de passe de l'utilisateur MySQL.'
        (...)
      valuemaps: (see table below)
  (...)

Interfaces d'hôte

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

Éléments d'hôte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Utilisation du cache binlog sur disque'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Nombre de transactions qui ont utilisé un cache disque temporaire parce qu''elles ne pouvaient pas tenir dans le cache du journal binaire standard, étant plus volumineuses que `binlog_cache_size`.'
          preprocessing: (see table below)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: cache
        (...)
        - name: 'Utilisation du pool de tampons'
          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 les pages utilisées et le nombre total de pages dans le pool de tampons.'
          tags:
            - tag: component
              value: memory
          triggers: (see table below)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Nombre de secondes pendant lesquelles le serveur est en fonctionnement.'
          preprocessing: (see table below)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (see table below)
        (...)

Étapes de prétraitement de la valeur de l'élément de l'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 n'a reçu aucune donnée pour les éléments au cours des 30 dernières 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: 'Le temps de fonctionnement de MySQL est inférieur à 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 bas niveau de l'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 remplacement de règle de découverte bas niveau de hôte

Scénarios web de l'hôte

Étapes du scénario web de l'hôte

Graphiques de l'hôte

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (see table below)
    (...)

Éléments du graphique de l'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
    (...)

Cartes de valeurs de l'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.