4 Host

Panoramica

Gli host vengono esportati insieme a molti oggetti correlati e alle relative relazioni tra oggetti.

L'esportazione degli host contiene:

• Gruppi di host collegati
• Dati dell'host
• Collegamento ai template
• Collegamento ai gruppi di host
• Interfacce dell'host
• Item collegati direttamente
• Trigger collegati direttamente
• Regole di discovery collegate direttamente con tutti i prototipi
• Scenari web collegati direttamente
• Macro dell'host
• Dati di inventario dell'host
• Mappe dei valori
• Grafici collegati

Esportazione

Per esportare gli host, procedere come segue:

1. Andare su Raccolta dati → Host.
2. Selezionare le caselle di controllo degli host da esportare.
3. Fare clic su Esporta sotto l'elenco.

A seconda del formato selezionato, gli host vengono esportati in un file locale con un nome predefinito:

• zabbix_export_hosts.yaml - nell'esportazione YAML (opzione predefinita per l'esportazione);
• zabbix_export_hosts.xml - nell'esportazione XML;
• zabbix_export_hosts.json - nell'esportazione JSON.

Importazione

Per importare host, procedere come segue:

1. Andare su Raccolta dati → Host.
2. Fare clic su Importa nell'angolo in alto a destra.
3. Selezionare il file di importazione.
4. Fare clic su Importa nell'angolo in basso a destra del modulo di configurazione.

Se si seleziona la casella di controllo Opzioni avanzate, verrà visualizzato un elenco dettagliato di tutti gli elementi importabili: selezionare o deselezionare ogni regola di importazione secondo necessità.

Se si fa clic sulla casella di controllo nella riga Tutto, tutti gli elementi sottostanti verranno selezionati/deselezionati.

Regole di importazione:

Nel frontend verrà visualizzato un messaggio di esito positivo o negativo dell'importazione.

Formato di esportazione

Quando un host viene esportato, Zabbix genera un formato strutturato YAML, JSON o XML. L'esportazione include elementi dell'host, come metadati dell'host, item, macro, trigger e altro.

Ogni elemento ha uno scopo specifico e può contenere elementi nidificati.

Le sezioni seguenti descrivono ciascun elemento nel formato di esportazione. Gli esempi utilizzano un host con il template MySQL by Zabbix agent 2. Ai fini della dimostrazione degli elementi, il template viene scollegato dopo la creazione dell'host. Lo scollegamento mantiene tutti gli elementi nella configurazione (a differenza dello scollegamento con rimozione, che li elimina).

I puntini di sospensione (...) indicano elementi omessi per brevità. La nota (see table below) viene utilizzata quando l'elemento è spiegato più in dettaglio nelle sezioni successive.

Metadati dell'host

zabbix_export:
  version: '7.4'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (see table below)
  graphs: (see table below)

Host

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: 'Password dell'utente MySQL.'
        (...)
      valuemaps: (see table below)
  (...)

Interfacce host

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

Item del host

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Numero di transazioni che hanno utilizzato una cache temporanea su disco perché non potevano rientrare nella cache del binary log standard, essendo più grandi di `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: 'Buffer pool utilization'
          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: 'Rapporto tra le pagine utilizzate e il totale delle pagine nel buffer pool.'
          tags:
            - tag: component
              value: memory
          triggers: (see table below)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Numero di secondi in cui il server è stato attivo.'
          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)
        (...)

Passaggi di preprocessing del valore di item del host

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
          (...)

Trigger degli item del host

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
        (...)

Regole di low-level discovery del host

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          delay: 1h
          filter: (vedere la tabella sotto)
          description: 'Scansione dei database nel DBMS.'
          interface_ref: if1
          item_prototypes:
            - name: 'Dimensione del database {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Dimensione del database.'
              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
        (...)

Filtri delle regole di low-level discovery del host

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
          (...)

Operazioni di override della regola di low-level discovery del host

Scenari web del host

Passi dello scenario web del host

Grafici host

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (vedere la tabella sotto)
    (...)

Elementi del grafico dell'host

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
    (...)

Mappe di valori del host

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

Note a piè di pagina

¹ I valori interi dell'API tra parentesi, ad esempio ENABLED (0), sono indicati solo come riferimento. Per ulteriori informazioni, vedere la pagina dell'oggetto API collegata nella voce della tabella o alla fine di ciascuna sezione.