3 Template

Panoramica

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

L'esportazione di un template contiene:

• Gruppi di template correlati
• Gruppi di host correlati (se utilizzati nella configurazione del prototipo host)
• Dati del template
• Collegamento ad altri template
• Collegamento a gruppi di template
• Elementi direttamente correlati
• Trigger direttamente correlati
• Grafici direttamente correlati
• Dashboard direttamente correlate
• Regole di discovery direttamente correlate con tutti i prototipi
• Scenari web direttamente correlati
• Mappe di valori

Esportazione

Per esportare i template, procedi come segue:

1. Vai su Raccolta dati → Template.
2. Seleziona le caselle di controllo dei template da esportare.
3. Fai clic su Esporta sotto l'elenco.

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

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

Importazione

Per importare i template, procedi come segue:

1. Vai su Raccolta dati → Template.
2. Fai clic su Importa nell'angolo in alto a destra.
3. Seleziona il file di importazione.
4. Fai clic su Importa nell'angolo in basso a destra del modulo di configurazione.

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

Se fai clic sulla casella nella riga Tutti, tutti gli elementi sottostanti verranno selezionati/deselezionati.

Regole di importazione:

Nella schermata successiva, potrai 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 del template rimossi saranno evidenziati in rosso; gli elementi che non sono cambiati saranno elencati su uno sfondo grigio.

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

Esamina le modifiche del template e poi fai clic su Importa per eseguire l'importazione del template. Nel frontend verrà visualizzato un messaggio di esito positivo o negativo dell'importazione.

Formato di esportazione

Quando un template viene esportato, Zabbix genera un formato strutturato YAML, JSON o XML. L'esportazione include elementi del template, come metadati del template, item, macro, trigger, dashboard 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 il template Linux by Zabbix agent.

I puntini di sospensione (...) indicano elementi omessi per brevità. La nota (vedi tabella sotto) viene utilizzata 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: (vedere la tabella sotto)
  triggers: (vedere la tabella sotto)
  graphs: (vedere la tabella sotto)

Template

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

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

Item del template

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

Passaggi di preprocessing del valore degli 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 low-level discovery del template

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Rilevamento delle interfacce di rete'
          key: net.if.discovery
          delay: 1h
          filter: (vedere la tabella sotto)
          description: 'Il rilevamento delle interfacce di rete.'
          item_prototypes: (vedere la tabella sotto)
          trigger_prototypes: (vedere la tabella sotto)
          graph_prototypes: (vedere la tabella sotto)
        (...)

Filtri delle regole di low-level discovery 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 low-level discovery 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’ultima volta in cui è stato visto Zabbix agent'
            description: 'Timeout dopo il quale l’agent è considerato non disponibile.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Soglie
            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: 'Attiva un trigger quando lo stato operativo dell’interfaccia cambia in "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Dashboard dei template

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (vedere la tabella sotto)
        (...)

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})]: Grafico di utilizzo dello spazio (relativo al totale)'
                    - 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})]: Grafico di utilizzo dello spazio, in % (relativo al massimo disponibile)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

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