Host

Panoramica

Gli host vengono esportati con molti oggetti correlati e relazioni tra oggetti.

L'esportazione dell'host contiene:

• [host group] collegati (/manual/config/xml_export_import/hostgroups)
• 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 (/manual/config/xml_export_import/hosts#host-graphs)

Esportazione

Per esportare gli host, procedere come segue:

1. Andare in Data collection > Hosts.
2. Selezionare le caselle di controllo degli host da esportare.
3. Fare clic su Export 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 gli host, procedere come segue:

1. Andare in 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 Tutti, tutti gli elementi sottostanti verranno selezionati/deselezionati.

Regole di importazione:

Un messaggio di successo o di errore dell'importazione verrà visualizzato nel frontend.

Formato di esportazione

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

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

Le sezioni seguenti descrivono ciascun elemento nel formato di esportazione. Gli esempi usano un host con il template MySQL by Zabbix agent 2. A scopo dimostrativo degli elementi, il template viene scollegato dopo la creazione dell'host. Lo scollegamento mantiene tutti gli elementi nella configurazione (a differenza di scollegare e cancellare, che li rimuove).

Un'ellissi (...) indica elementi omessi per brevità. La nota (see table below) viene usata quando l'elemento è spiegato in modo più dettagliato nelle sezioni successive.

Metadati dell'host

zabbix_export:
  version: '8.0'
  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 di 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 normale, 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 dell'item dell'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 dell'item 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 non ha ricevuto alcun dato per gli item negli ultimi 30 minuti.'
              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: 'L'uptime di MySQL è inferiore a 10 minuti.'
              tags:
                - tag: scope
                  value: notice
        (...)

Regole di discovery low-level dell'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: (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
        (...)

Filtri della regola di discovery low-level dell'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 discovery low-level dell'host

Scenari web dell'host

Passi dello scenario web dell'host

Grafici dell'host

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

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 dei valori dell'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 menzionati solo come riferimento. Per ulteriori informazioni, vedere la pagina dell'oggetto API collegata nella voce della tabella o alla fine di ogni sezione.