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 per esportare nel formato YAML predefinito, oppure fare clic sulla freccia per selezionare un formato di esportazione diverso.

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

• zabbix_export_hosts.yaml - nell'esportazione YAML;
• zabbix_export_hosts.xml - nell'esportazione XML;
• zabbix_export_hosts.json - nell'esportazione JSON.

Importazione

Per importare gli host, procedere come segue:

1. Andare a Raccolta dati > Host.
2. Fare clic su Importa nell'angolo in alto a destra.
3. Selezionare il file di importazione.
4. Selezionare le caselle di controllo delle regole di importazione da applicare (vedere di seguito).
5. 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 o deselezionati.

Regole di importazione:

Non è possibile esaminare le modifiche agli host durante l'importazione. Nel frontend verrà visualizzato un messaggio che indica se l'importazione è riuscita o non riuscita.

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.