Template

Panoramica

I template vengono esportati con molti oggetti correlati e relazioni tra oggetti.

L'esportazione del template contiene:

• Gruppi di template collegati
• Gruppi di host collegati (se utilizzati nella configurazione del host prototype)
• Dati del template
• Collegamento ad altri template
• Collegamento ai gruppi di template
• item collegati direttamente
• trigger collegati direttamente
• grafici collegati direttamente
• dashboard collegati direttamente
• regole di discovery collegate direttamente con tutti i prototipi
• scenari web collegati direttamente
• mappe dei valori

Esportazione

Per esportare i template, procedere come segue:

1. Andare in Data collection > Templates.
2. Selezionare le caselle di controllo dei template da esportare.
3. Fare clic su Export sotto l'elenco.

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

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

Importazione

Per importare i template, procedere come segue:

1. Andare su Data collection > Templates.
2. Fare clic su Import nell'angolo in alto a destra.
3. Selezionare il file di importazione.
4. Fare clic su Import nell'angolo in basso a destra del modulo di configurazione.

Se si seleziona la casella di controllo Advanced options, 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 All, tutti gli elementi sottostanti verranno selezionati/deselezionati.

Regole di importazione:

Nella schermata successiva, sarà possibile visualizzare il contenuto di un template in fase di importazione. Se si tratta di un nuovo template, tutti gli elementi saranno elencati in verde. Se si aggiorna un template esistente, i nuovi elementi del template saranno evidenziati in verde; gli elementi rimossi del template saranno evidenziati in rosso; gli elementi che non sono cambiati saranno elencati su sfondo grigio.

Il menu a sinistra può essere utilizzato per navigare nell'elenco delle modifiche. La sezione Updated evidenzia tutte le modifiche apportate agli elementi esistenti del template. La sezione Added elenca i nuovi elementi del template. Gli elementi in ciascuna sezione sono raggruppati per tipo di elemento; fare clic sulla freccia grigia per espandere o comprimere il gruppo di elementi.

Rivedere le modifiche del template e quindi fare clic su Import per eseguire l'importazione del template. Nel frontend verrà visualizzato un messaggio di successo o di errore dell'importazione.

Formato di esportazione

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

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

Le sezioni seguenti descrivono ciascun elemento nel formato di esportazione. Gli esempi usano il template Linux by Zabbix agent.

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 del template

zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (see table below)
  triggers: (see table below)
  graphs: (see table below)

Template

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        Questo è un template ufficiale per Linux. Richiede Zabbix agent 8.0 o versioni successive. (...)
      wizard_ready: 'YES'
      readme: |
        ## Panoramica

        Questo è un template ufficiale per Linux. Richiede Zabbix agent 8.0 o versioni successive. (...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Sistemi operativi'
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Timeout dopo il quale l'agent è considerato non disponibile. Funziona solo per gli agent raggiungibili da Zabbix server/proxy (modalità passiva).'
          config: (see table below)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Soglia critica dell'utilizzo della CPU espressa in %.'
          config: (see table below)
        (...)
      dashboards: (see table below)
      valuemaps: (see table below)
    (...)

Template items

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Ping dell'agent Zabbix'
          key: agent.ping
          description: 'L'agent restituisce sempre "1" per questo item. Può essere usato in combinazione con `nodata()` per il controllo della disponibilità.'
          valuemap:
            name: 'Stato del ping dell'agent Zabbix'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Numero di pacchetti installati'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (see table below)
          tags:
            - tag: component
              value: os
          triggers: (see table below)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Utilizzo della memoria'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: 'La percentuale di memoria utilizzata viene calcolata come `100-pavailable`.'
          preprocessing: (see table below)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (see table below)
        (...)

Passi di preprocessing del valore dell'item del template

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.length()
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 12h
          (...)

Trigger degli item del template

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: Number of installed packages has been changed'
              priority: WARNING
              manual_close: 'YES'
              tags:
                - tag: scope
                  value: notice
        (...)
        - uuid: 403cebed115441369e94d35d070ca7b8
          (...)
          triggers:
            - uuid: cfd395b1cde74ef18a5e5f840bd5142a
              expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
              name: 'Linux: High memory utilization'
              event_name: 'Linux: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)'
              priority: AVERAGE
              description: 'The system is running out of free memory.'
              dependencies:
                - name: 'Linux: Lack of available memory'
                  expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
              tags:
                - tag: scope
                  value: capacity
                - tag: scope
                  value: performance
        (...)

Regole di discovery a basso livello del template

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Network interface discovery'
          key: net.if.discovery
          delay: 1h
          filter: (see table below)
          description: 'The discovery of network interfaces.'
          item_prototypes: (see table below)
          trigger_prototypes: (see table below)
          graph_prototypes: (see table below)
        (...)

Filtri delle regole di discovery low-level del template

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.MATCHES}'
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)
        - uuid: 2bbdc79f082d4c618e01bec625e9c90a
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.MATCHES}'
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
              - macro: '{#DEVTYPE}'
                value: disk
          (...)

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

Scenari web del template

Passi dello scenario web del template

Configurazione delle macro del template

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Secondi dall'ultimo agent Zabbix rilevato'
            description: 'Timeout dopo il quale l'agent viene considerato non disponibile.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Thresholds
            label: 'Soglia di utilizzo della CPU espressa'
            description: 'Soglia critica di utilizzo della CPU espressa in %. Nell'intervallo da 0 a 100 inclusi.'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: 'Controllo delle interfacce'
            description: 'Genera un trigger quando lo stato operativo dell'interfaccia cambia in "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Dashboard del template

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (see table below)
        (...)

Widget della dashboard del template

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets:
                - type: graphprototype
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '3'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Space utilization chart (relative to total)'
                    - type: STRING
                      name: reference
                      value: AAAEB
                - type: graphprototype
                  'y': '5'
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '1'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Space usage graph, in % (relative to max available)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

Mappe valori del template

zabbix_export:
  (...)
  templates:
    (...)
      valuemaps:
        - uuid: 8c048c6cca8248f2860c208e8db0f59e
          name: ifOperStatus
          mappings:
            - value: '0'
              newvalue: unknown
            - value: '1'
              newvalue: notpresent
            - value: '2'
              newvalue: down
            - value: '3'
              newvalue: lowerlayerdown
            - value: '4'
              newvalue: testing
            - value: '5'
              newvalue: dormant
            - value: '6'
              newvalue: up
        (...)

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 ciascuna sezione.