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 gli host, procedere come segue:

  1. Andare su Data collection → Hosts.
  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:

Rule Description
Update existing Gli elementi esistenti verranno aggiornati usando i dati del file di importazione. In caso contrario, non verranno aggiornati.
Create new I nuovi elementi verranno creati usando i dati del file di importazione. In caso contrario, non verranno creati.
Delete missing Gli elementi esistenti non presenti nel file di importazione verranno rimossi. In caso contrario, non verranno rimossi.
Se Delete missing è selezionato per Template linkage, il collegamento ai template attualmente presenti ma non nel file di importazione verrà rimosso. Le entità (item, trigger, graph, ecc.) ereditate dai template scollegati non verranno rimosse (a meno che l'opzione Delete missing non sia selezionata anche per ciascuna entità).

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

Formato di esportazione

Formato di esportazione in YAML:

zabbix_export:
  version: '7.0'
  host_groups:
    - uuid: f2481361f99448eea617b7b1d4765566
      name: 'Discovered hosts'
    - uuid: 6f6799aa69e844b4b3918f779f2abf08
      name: 'Zabbix servers'
  hosts:
    - host: 'Zabbix server 1'
      name: 'Main Zabbix server'
      monitored_by: 'SERVER'
      templates:
        - name: 'Linux by Zabbix agent'
        - name: 'Zabbix server health'
      groups:
        - name: 'Discovered hosts'
        - name: 'Zabbix servers'
      interfaces:
        - ip: 192.168.1.1
          interface_ref: if1
      items:
        - name: 'Zabbix trap'
          type: TRAP
          key: trap
          delay: '0'
          history: 1w
          preprocessing:
            - type: MULTIPLIER
              parameters:
                - '8'
          tags:
            - tag: component
              value: 'raw'
          triggers:
            - expression: 'last(/Zabbix server 1/trap)=0'
              name: 'Ultimo valore pari a zero'
              priority: WARNING
              tags:
                - tag: scope
                  value: 'availability'
      tags:
        - tag: service
          value: zabbix-server
      macros:
        - macro: '{$HOST.MACRO}'
          value: '123'
        - macro: '{$PASSWORD1}'
          type: SECRET_TEXT
      inventory:
        type: 'Zabbix server'
        name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
        os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64'
      inventory_mode: AUTOMATIC
  graphs:
    - name: 'Utilizzo CPU server'
      show_work_period: 'NO'
      show_triggers: 'NO'
      graph_items:
        - drawtype: FILLED_REGION
          color: FF5555
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,steal]'
        - sortorder: '1'
          drawtype: FILLED_REGION
          color: 55FF55
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,softirq]'
        - sortorder: '2'
          drawtype: FILLED_REGION
          color: '009999'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,interrupt]'
        - sortorder: '3'
          drawtype: FILLED_REGION
          color: '990099'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,nice]'
        - sortorder: '4'
          drawtype: FILLED_REGION
          color: '999900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,iowait]'
        - sortorder: '5'
          drawtype: FILLED_REGION
          color: '990000'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,system]'
        - sortorder: '6'
          drawtype: FILLED_REGION
          color: '000099'
          calc_fnc: MIN
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,user]'
        - sortorder: '7'
          drawtype: FILLED_REGION
          color: '009900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,idle]'

Elementi esportati

Gli elementi esportati sono spiegati nelle tabelle seguenti.

Element Type Description
version string (required) Versione di Zabbix.
host_groups (required) Elemento radice per i gruppi host.
uuid string (required) Identificatore univoco per questo gruppo host.
name string (required) Nome del gruppo host.
hosts Elemento radice per gli host.

Host

Element Type Description
host string (required) Nome univoco dell'host.
name string Nome visibile dell'host.
description text Descrizione dell'host.
monitored_by string Host monitorato da: SERVER, PROXY o PROXY_GROUP.
proxy Elemento radice per proxy.
name string (required) Nome del proxy (se presente) che monitora l'host.
proxy_group Elemento radice per il gruppo di proxy.
name string (required) Nome del gruppo di proxy (se presente) utilizzato per monitorare l'host.
status string Stato dell'host.
Valori possibili:1 ENABLED (0, predefinito), DISABLED (1).
ipmi_authtype string Tipo di autenticazione della sessione IPMI.
Valori possibili:1 DEFAULT (-1, predefinito), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6).
ipmi_privilege string Livello di privilegio della sessione IPMI.
Valori possibili:1 CALLBACK (1), USER (2, predefinito), OPERATOR (3), ADMIN (4), OEM (5).
ipmi_username string Nome utente per i controlli IPMI.
ipmi_password string Password per i controlli IPMI.
templates Elemento radice per i template collegati.
name string (required) Nome del template.
groups Elemento radice per i gruppi di host a cui appartiene l'host.
name string (required) Nome del gruppo di host.
interfaces Elemento radice per le interfacce dell'host.
items Elemento radice per gli item dell'host.
discovery_rules Elemento radice per le regole di discovery low-level dell'host.
http_tests Elemento radice per gli scenari web dell'host.
tags Elemento radice per i tag dell'host.
tag string (required) Nome del tag.
value string Valore del tag.
macros Elemento radice per le macro dell'host.
macro string (required) Nome della macro utente.
type string Tipo di macro utente.
Valori possibili:1 TEXT (0, predefinito), SECRET_TEXT (1), VAULT (2).
value string Valore della macro utente.
description string Descrizione della macro utente.
inventory Elemento radice per l'inventario dell'host.
<inventory_property> string Proprietà dell'inventario. Tutte le proprietà hanno il rispettivo elemento (type, name, os, ecc.; ad esempio, vedere Export format).
inventory_mode string Modalità inventario.
Valori possibili:1 DISABLED (-1), MANUAL (0, predefinito), AUTOMATIC (1).
valuemaps Elemento radice per i value map dell'host.

Vedi anche: Host object (fare riferimento alla proprietà pertinente con lo stesso nome).

Interfacce host

Element Type Description
default string Indica se questa è l'interfaccia host primaria. Nota che può esserci una sola interfaccia primaria di un tipo su un host.
Valori possibili:1 NO (0), YES (1, default).
type string Tipo di interfaccia.
Valori possibili:1 ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).
useip string Indica se usare l'IP come interfaccia per la connessione all'host (in caso contrario verrà usato DNS).
Valori possibili:1 NO (0), YES (1, default).
ip string (obbligatorio per connessioni IP) Indirizzo IP (IPv4 o IPv6).
dns string (obbligatorio per connessioni DNS) Nome DNS.
port string Numero di porta.
details Elemento radice per i dettagli dell'interfaccia.
version string Usa questa versione SNMP.
Valori possibili:1 SNMPV1 (1), SNMP_V2C (2, default), SNMP_V3 (3).
community string (obbligatorio per item SNMPv1 e SNMPv2) Community SNMP.
max_repetitions string Valore massimo di ripetizioni per le richieste bulk SNMP native (PDU GetBulkRequest).
Supportato per item SNMPv2 e SNMPv3 (discovery[] e walk[]).
Predefinito: 10.
contextname string Nome del contesto SNMPv3.
Supportato per item SNMPv3.
securityname string Nome di sicurezza SNMPv3.
Supportato per item SNMPv3.
securitylevel string Livello di sicurezza SNMPv3.
Supportato per item SNMPv3.
Valori possibili:1 NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).
authprotocol string Protocollo di autenticazione SNMPv3.
Supportato per item SNMPv3.
Valori possibili:1 MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).
authpassphrase string Passphrase di autenticazione SNMPv3.
Supportato per item SNMPv3.
privprotocol string Protocollo di privacy SNMPv3.
Supportato per item SNMPv3.
Valori possibili:1 DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).
privpassphrase string Passphrase di privacy SNMPv3.
Supportato per item SNMPv3.
bulk string Usa richieste bulk per SNMP.
Valori possibili:1 NO (0), YES (1, default).
interface_ref string Nome di riferimento dell'interfaccia da usare negli item (formato: if<N>).

Vedi anche: Oggetto interfaccia host (fare riferimento alla proprietà pertinente con il nome corrispondente).

Item del host

Element Type Description
name string (required) Nome dell'item.
type string Tipo di item.
Valori possibili:1 ZABBIX_PASSIVE (0, predefinito), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
snmp_oid string (required for SNMP_AGENT items) ID oggetto SNMP.
key string (required) Chiave dell'item.
delay string Intervallo di aggiornamento dell'item.
Predefinito: 1m. Il valore sarà sempre 0 per gli item TRAP.
history string Periodo di tempo (usando time suffix, user macro o LLD macro) per cui i dati storici devono essere conservati.
Predefinito: 31d.
trends string Periodo di tempo (usando time suffix, user macro o LLD macro) per cui i dati di trend devono essere conservati.
Predefinito: 365d.
status string Stato dell'item.
Valori possibili:1 ENABLED (0, predefinito), DISABLED (1).
value_type string Tipo di valore ricevuto.
Valori possibili:1 FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, predefinito), TEXT (4), BINARY (5).
allowed_hosts string Elenco di indirizzi IP separati da virgole degli host autorizzati a inviare dati per l'item.
Supportato per gli item TRAP e HTTP_AGENT.
units string Unità del valore ricevuto (bps, B, ecc.).
params text Parametri aggiuntivi a seconda del tipo di item (script eseguito per item SSH e TELNET; query SQL per item ODBC; formula per item CALCULATED; script per item ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER).
ipmi_sensor string Sensore IPMI.
Supportato per item IPMI.
authtype string Tipo di autenticazione.
Supportato per item SSH e HTTP_AGENT.
Valori possibili per item SSH:1 PASSWORD (0, predefinito), PUBLIC_KEY (1).
Valori possibili per item HTTP_AGENT:1 NONE (0, predefinito), BASIC (1), NTLM (2), Kerberos (3) o Digest (4).
username string (required for SSH and TELNET items) Nome utente per l'autenticazione.
Supportato per item SIMPLE, ODBC, JMX e HTTP_AGENT.
Se usato per item JMX, anche password (vedi sotto) deve essere specificata oppure entrambi gli elementi devono essere lasciati vuoti.
password string (required for SSH and TELNET items) Password per l'autenticazione.
Supportato per item SIMPLE, ODBC, JMX e HTTP_AGENT.
Se usato per item JMX, anche username (vedi sopra) deve essere specificato oppure entrambi gli elementi devono essere lasciati vuoti.
publickey string (required for SSH items) Nome del file della chiave pubblica.
privatekey string (required for SSH items) Nome del file della chiave privata.
description text Descrizione dell'item.
inventory_link string Campo dell'inventario dell'host compilato dall'item.
Valori possibili:1 NONE (0), ALIAS (4), ecc. (vedere Host inventory per i campi supportati).
valuemap Elemento radice per le mappe dei valori dell'item.
name string (required) Nome della mappa dei valori da usare per l'item.
logtimefmt string Formato dell'ora nelle voci di log.
Supportato per item di tipo LOG.
preprocessing Elemento radice per il preprocessing dei valori dell'item.
step Elemento radice per i passi di preprocessing dei valori degli item dell'host.
interface_ref string Riferimento all'interfaccia dell'host (formato: if<N>).
jmx_endpoint string Endpoint JMX.
Supportato per item JMX.
master_item (required for DEPENDENT items) Elemento radice per il master item dell'item dipendente.
key string (required) Chiave del master item dell'item dipendente.
timeout string Timeout della richiesta di polling dei dati dell'item.
Supportato per l'elenco dei tipi di item Timeouts.
url string (required for HTTP_AGENT items) Stringa URL.
query_fields Elemento radice per i parametri di query.
Supportato per item HTTP_AGENT.
name string (required for HTTP_AGENT items) Nome del parametro di query.
value string Valore del parametro di query.
Supportato per item HTTP_AGENT.
parameters Elemento radice per i parametri definiti dall'utente.
Supportato per item ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER.
name string (required for ITEM_TYPE_SCRIPT and ITEM_TYPE_BROWSER items) Nome del parametro definito dall'utente.
value string Valore del parametro definito dall'utente.
Supportato per item ITEM_TYPE_SCRIPT e ITEM_TYPE_BROWSER.
posts string Dati del corpo della richiesta HTTP(S).
Supportato per item HTTP_AGENT.
status_codes string Intervalli di codici di stato HTTP richiesti, separati da virgole.
Supportato per item HTTP_AGENT.
follow_redirects string Segui i redirect della risposta durante il polling dei dati.
Supportato per item HTTP_AGENT.
Valori possibili:1 NO (0), YES (1, predefinito).
post_type string Tipo del corpo dei dati post.
Supportato per item HTTP_AGENT.
Valori possibili:1 RAW (0, predefinito), JSON (2), XML (3).
http_proxy string Stringa di connessione del proxy HTTP(S).
Supportato per item HTTP_AGENT.
headers Elemento radice per le intestazioni della richiesta HTTP(S).
Supportato per item HTTP_AGENT.
name string (required for HTTP_AGENT items) Nome dell'intestazione.
value string (required for HTTP_AGENT items) Valore dell'intestazione.
retrieve_mode string Quale parte della risposta deve essere memorizzata.
Supportato per item HTTP_AGENT.
Valori possibili:1 BODY (0, predefinito), HEADERS (1), BOTH (2).
request_method string Tipo di metodo della richiesta.
Supportato per item HTTP_AGENT.
Valori possibili:1 GET (0, predefinito), POST (1), PUT (2), HEAD (3).
output_format string Come elaborare la risposta.
Supportato per item HTTP_AGENT.
Valori possibili:1 RAW (0, predefinito), JSON (1).
allow_traps string Consenti di popolare il valore in modo simile all'item trapper.
Supportato per item HTTP_AGENT.
Valori possibili:1 NO (0, predefinito), YES (1).
ssl_cert_file string Percorso del file della chiave SSL pubblica.
Supportato per item HTTP_AGENT.
ssl_key_file string Percorso del file della chiave SSL privata.
Supportato per item HTTP_AGENT.
ssl_key_password string Password per il file della chiave SSL.
Supportato per item HTTP_AGENT.
verify_peer string Indica se convalidare che il certificato dell'host sia autentico.
Supportato per item HTTP_AGENT.
Valori possibili:1 NO (0, predefinito), YES (1).
verify_host string Indica se convalidare che il nome host per la connessione corrisponda a quello nel certificato dell'host.
Supportato per item HTTP_AGENT.
Valori possibili:1 NO (0, predefinito), YES (1).
tags Elemento radice per i tag dell'item.
tag string (required) Nome del tag.
value string Valore del tag.
triggers Elemento radice per i trigger degli item dell'host.

Vedi anche: Item object (fare riferimento alla proprietà pertinente con lo stesso nome).

Passi di preprocessing del valore dell'item dell'host
Element Type Description
type string (obbligatorio) Il tipo di passo di preprocessing del valore dell'item.
Valori possibili:1 MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, calcolato: valore ricevuto - valore precedente), CHANGE_PER_SECOND (10, calcolato: (valore ricevuto - valore precedente)/(ora corrente - ora dell'ultimo controllo)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters (obbligatorio) Elemento radice per i parametri del passo di preprocessing del valore dell'item.
parameter string Parametro individuale del passo di preprocessing del valore dell'item.
error_handler string Tipo di azione usato in caso di errore del passo di preprocessing.
Valori possibili:1 ORIGINAL_ERROR (0, predefinito), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params string Parametri del gestore degli errori.

Vedi anche: Oggetto di preprocessing dell'item (fare riferimento alla proprietà pertinente con lo stesso nome).

Trigger degli item dell'host
Element Type Description
uuid string (required) Identificatore univoco per questo trigger.
expression string (required) Espressione del trigger.
recovery_mode string Base per la generazione degli eventi OK.
Possible values:1 EXPRESSION (0, default), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression string Espressione di ripristino del trigger.
correlation_mode string Modalità di correlazione (nessuna correlazione eventi oppure correlazione eventi per tag).
Possible values:1 DISABLED (0, default), TAG_VALUE (1).
correlation_tag string Nome del tag da usare per la correlazione degli eventi.
name string (required) Nome del trigger.
event_name string Nome dell'evento.
opdata string Dati operativi.
url_name string Etichetta per l'URL associato al trigger.
url string URL associato al trigger.
status string Stato del trigger.
Possible values:1 ENABLED (0, default), DISABLED (1).
priority string Gravità del trigger.
Possible values:1 NOT_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description text Descrizione del trigger.
type string Tipo di generazione dell'evento (singolo evento di problema o più eventi di problema).
Possible values:1 SINGLE (0, default), MULTIPLE (1).
manual_close string Chiusura manuale degli eventi di problema.
Possible values:1 NO (0, default), YES (1).
dependencies Elemento radice per le dipendenze.
name string (required) Nome del trigger dipendente.
expression string (required) Espressione del trigger dipendente.
recovery_expression string Espressione di ripristino del trigger dipendente.
tags Elemento radice per i tag del trigger.
tag string (required) Nome del tag.
value string Valore del tag.

Vedi anche: Trigger object (fare riferimento alla proprietà pertinente con lo stesso nome).

Regole di discovery low-level dell'host

La maggior parte degli elementi delle regole di discovery low-level dell'host è la stessa degli item dell'host. La tabella seguente descrive gli elementi che differiscono dagli item dell'host.

Element Type Description
type string Tipo di item.
Valori possibili:1 ZABBIX_PASSIVE (0, predefinito), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key string (obbligatorio) La chiave della regola di discovery low-level.
filter Elemento radice per i filtri delle regole di discovery low-level dell'host.
lifetime string Periodo di tempo (usando secondi, suffisso di tempo, o macro utente), dopo il quale le risorse non più scoperte verranno eliminate.
Predefinito: 7d.
lifetime_type string Scenario per l'eliminazione delle risorse LLD perse.
Valori possibili: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime string Periodo di tempo (usando secondi, suffisso di tempo, o macro utente), dopo il quale le risorse non più scoperte verranno disabilitate.
enabled_lifetime_type string Scenario per la disabilitazione delle risorse LLD perse.
Valori possibili: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes Elemento radice per gli elementi prototype degli item dell'host, che sono gli stessi degli item dell'host.
trigger_prototypes Elemento radice per i prototype dei trigger dell'host, che sono gli stessi dei trigger degli item dell'host.
graph_prototypes Elemento radice per i prototype dei grafici dell'host, che sono gli stessi dei grafici dell'host.
host_prototypes Elemento radice per i prototype degli host, che sono gli stessi degli host.
master_item string (obbligatorio per le regole DEPENDENT) Elemento radice per l'item master della regola dipendente.
lld_macro_paths Elemento radice per i percorsi delle macro della regola di discovery low-level.
lld_macro string (obbligatorio) Nome della macro della regola di discovery low-level.
path string (obbligatorio) Selettore per il valore, che verrà assegnato alla macro corrispondente.
preprocessing Elemento radice per il preprocessing del valore della regola di discovery low-level.
step Elemento radice per gli elementi dei passi di preprocessing del valore della regola di discovery low-level, che sono gli stessi dei passi di preprocessing del valore dell'item dell'host, ma con meno valori possibili. Vedi anche: oggetto di preprocessing della regola LLD.
overrides Elemento radice per le regole di override della regola di discovery low-level.
name string (obbligatorio) Nome univoco dell'override.
step string (obbligatorio) Numero d'ordine univoco dell'override.
stop string Interrompi l'elaborazione degli override successivi se corrisponde.
filter Elemento radice per gli elementi del filtro delle regole di override della regola di discovery low-level, che sono gli stessi dei filtri delle regole di discovery low-level dell'host.
operations Elemento radice per le operazioni di override delle regole di discovery low-level dell'host.

Vedi anche: oggetto regola LLD (fare riferimento alla proprietà pertinente con lo stesso nome).

Filtri della regola di discovery low-level dell'host
Element Type Description
evaltype string Sovrascrive il metodo di valutazione della condizione del filtro.
Valori possibili:1 AND_OR (0, predefinito), AND (1), OR (2), FORMULA (3).
formula string Formula di calcolo personalizzata per le condizioni del filtro.
conditions Elemento radice per le condizioni del filtro.
macro string (obbligatorio) Il nome della macro di discovery low-level su cui eseguire il controllo.
value string Valore con cui confrontare.
operator string Operatore della condizione.
Valori possibili:1 MATCHES_REGEX (8, predefinito), NOT_MATCHES_REGEX (9).
formulaid string (obbligatorio) ID univoco arbitrario usato per fare riferimento a una condizione dall'espressione personalizzata. Può contenere solo lettere maiuscole. L'ID deve essere definito dall'utente quando si modificano le condizioni del filtro, ma verrà generato nuovamente nelle richieste successive.

Vedi anche: oggetto filtro della regola LLD (fare riferimento alla proprietà pertinente con lo stesso nome).

Operazioni di override della regola di discovery low-level dell'host
Element Type Description
operationobject string Oggetto a cui viene applicata l'operazione.
Valori possibili:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator string Operatore della condizione di override.
Valori possibili:1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value string Un'espressione regolare o una stringa per l'operatore della condizione di override.
status string Stato dell'oggetto dopo l'operazione di override.
discover string Indica se l'oggetto viene aggiunto come risultato della discovery.
delay string Intervallo di aggiornamento impostato per il prototipo di item dopo l'operazione di override.
history string Periodo di conservazione della cronologia impostato per il prototipo di item dopo l'operazione di override.
trends string Periodo di conservazione dei trend impostato per il prototipo di item dopo l'operazione di override.
severity string Gravità del prototipo di trigger impostata dopo l'operazione di override.
tags Elemento radice per i tag impostati per l'oggetto dopo l'operazione di override.
tag string (obbligatorio) Nome del tag.
value string Valore del tag.
templates Elemento radice per i template collegati al prototipo di host dopo l'operazione di override.
name string (obbligatorio) Nome del template.
inventory_mode string Modalità di inventario del prototipo di host impostata dopo l'operazione di override.

Vedi anche: LLD rule override operation object (fare riferimento alla proprietà pertinente con lo stesso nome).

Scenari web del host

Elemento Tipo Descrizione
uuid string (obbligatorio) Identificatore univoco per questo scenario web.
name string (obbligatorio) Nome dello scenario web.
delay string Frequenza (usando secondi, suffisso temporale o macro utente) di esecuzione dello scenario web.
Predefinito: 1m.
attempts integer Numero di tentativi per l'esecuzione dei passaggi dello scenario web.
Valori possibili: 1-10 (predefinito: 1).
agent string agent client. Zabbix fingerà di essere il browser selezionato.
Questo è utile quando un sito web restituisce contenuti diversi per browser diversi.
Predefinito: Zabbix.
http_proxy string proxy che verrà utilizzato dallo scenario web, indicato come: http://[username[:password]@]proxy.example.com[:port]
variables Elemento radice per le variabili dello scenario web che possono essere utilizzate nei passaggi dello scenario.
name string (obbligatorio) Nome della variabile.
value text (obbligatorio) Valore della variabile.
headers Elemento radice per le intestazioni HTTP da inviare durante l'esecuzione di una richiesta.
Le intestazioni devono essere elencate usando la stessa sintassi con cui apparirebbero nel protocollo HTTP.
name string (obbligatorio) Nome dell'intestazione.
value text (obbligatorio) Valore dell'intestazione.
status string Stato dello scenario web.
Valori possibili:1 ENABLED (0, predefinito), DISABLED (1).
authentication string Metodo di autenticazione.
Valori possibili:1 NONE (0, predefinito), BASIC (1), NTLM (2), Kerberos (3) o Digest (4).
http_user string Nome utente utilizzato per l'autenticazione BASIC (HTTP), NTLM, Kerberos o Digest.
http_password string Password utilizzata per l'autenticazione BASIC (HTTP), NTLM, Kerberos o Digest.
verify_peer string Verifica il certificato SSL del server web.
Valori possibili:1 NO (0, predefinito), YES (1).
verify_host string Verifica che il campo Common Name o il campo Subject Alternate Name del certificato del server web corrisponda.
Valori possibili:1 NO (0, predefinito), YES (1).
ssl_cert_file string Nome del file del certificato SSL utilizzato per l'autenticazione client (deve essere in formato PEM).
ssl_key_file string Nome del file della chiave privata SSL utilizzato per l'autenticazione client (deve essere in formato PEM).
ssl_key_password string Password del file della chiave privata SSL.
steps (obbligatorio) Elemento radice per i passaggi dello scenario web del host.
tags Elemento radice per i tag dello scenario web.
tag string (obbligatorio) Nome del tag.
value string Valore del tag.

Vedi anche: Web scenario object (fare riferimento alla proprietà pertinente con un nome corrispondente).

Passi dello scenario web del host
Elemento Tipo Descrizione
name string (obbligatorio) Nome del passo dello scenario web.
url string (obbligatorio) URL per il monitoraggio.
query_fields Elemento radice per i parametri di query (un array di campi HTTP da aggiungere all'URL durante l'esecuzione di una richiesta).
name string (obbligatorio) Nome del parametro di query.
value string Valore del parametro di query.
posts Elemento radice per le variabili HTTP POST (una stringa (dati post grezzi) o un array di campi HTTP (dati dei campi del modulo)).
name string (obbligatorio) Nome del campo POST.
value string (obbligatorio) Valore del campo POST.
variables Elemento radice delle variabili a livello di passo (macro) che devono essere applicate dopo questo passo.
Se il valore della variabile ha il prefisso 'regex:', il suo valore viene estratto dai dati restituiti da questo passo in base al modello di espressione regolare che segue il prefisso 'regex:'
name string (obbligatorio) Nome della variabile.
value text (obbligatorio) Valore della variabile.
headers Elemento radice per le intestazioni HTTP da inviare durante l'esecuzione di una richiesta.
name string (obbligatorio) Nome dell'intestazione.
value text (obbligatorio) Valore dell'intestazione.
follow_redirects string Segui i reindirizzamenti HTTP.
Valori possibili:1 NO (0), YES (1, predefinito).
retrieve_mode string Modalità di recupero della risposta HTTP.
Valori possibili:1 BODY (0, predefinito), HEADERS (1), BOTH (2).
timeout string Timeout (usando secondi, suffisso temporale o macro utente) dell'esecuzione del passo.
Predefinito: 15s.
required string Testo che deve essere presente nella risposta (ignorato se vuoto).
status_codes string Un elenco di codici di stato HTTP accettati, delimitato da virgole (ad esempio, 200-201,210-299; ignorato se vuoto).

Vedi anche: Web scenario step object (fare riferimento alla proprietà pertinente con un nome corrispondente).

Graph dei host

Element Type Description
uuid string Identificatore univoco del graph.
name string (obbligatorio) Nome del graph.
width integer Larghezza del graph, in pixel.
Usato per l'anteprima e per i graph a torta/esplosi.
Valori possibili:1 20-65535 (predefinito: 900).
height integer Altezza del graph, in pixel.
Usato per l'anteprima e per i graph a torta/esplosi.
Valori possibili:1 20-65535 (predefinito: 900).
yaxismin double Valore minimo dell'asse Y.
Supportato per il valore minimo FIXED dell'asse Y.
Predefinito: 0.
yaxismax double Valore massimo dell'asse Y.
Supportato per il valore minimo FIXED dell'asse X.
Predefinito: 0.
show_work_period string Evidenzia le ore non lavorative.
Supportato per i graph NORMAL e STACKED.
Valori possibili:1 NO (0), YES (1, predefinito).
show_triggers string Visualizza i valori semplici dei trigger come una linea.
Supportato per i graph NORMAL e STACKED.
Valori possibili:1 NO (0), YES (1, predefinito).
type string Tipo di graph.
Valori possibili:1 NORMAL (0, predefinito), STACKED (1), PIE (2), EXPLODED (3).
show_legend string Visualizza la legenda del graph.
Valori possibili:1 NO (0), YES (1, predefinito).
show_3d string Abilita lo stile 3D.
Supportato per i graph NORMAL e STACKED.
Valori possibili:1 NO (0, predefinito), YES (1).
percent_left double Mostra la linea del percentile per l'asse sinistro.
Supportato per i graph NORMAL.
Predefinito: 0.
percent_right double Mostra la linea del percentile per l'asse destro.
Supportato per i graph NORMAL.
Predefinito: 0.
ymin_type_1 string Valore minimo dell'asse Y.
Supportato per i graph NORMAL e STACKED.
Valori possibili:1 CALCULATED (0, predefinito), FIXED (1), ITEM (2).
ymin_item_1 (obbligatorio se ymin_type_1 è impostato su ITEM) Elemento radice per i dettagli del singolo item.
host string (obbligatorio) Host dell'item.
key string (obbligatorio) Chiave dell'item.
ymax_type_1 string Valore massimo dell'asse Y.
Supportato per i graph NORMAL e STACKED.
Valori possibili:1 CALCULATED (0, predefinito), FIXED (1), ITEM (2).
ymax_item_1 (obbligatorio se ymax_type_1 è impostato su ITEM) Elemento radice per i dettagli del singolo item.
host string (obbligatorio) Host dell'item.
key string (obbligatorio) Chiave dell'item.
graph_items (obbligatorio) Elemento radice per gli host graph items.

Vedi anche: Graph object (fare riferimento alla proprietà pertinente con lo stesso nome).

Elementi del grafico dell'host
Element < Type Description
sortorder < integer Ordine di disegno. Il valore più piccolo viene disegnato per primo. Può essere usato per disegnare linee o aree dietro (o davanti a) un'altra.
drawtype < string Stile di disegno dell'elemento del grafico.
Supportato per i grafici NORMAL.
Valori possibili:1 SINGLE_LINE (0, predefinito), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color < string Colore dell'elemento (6 simboli, esadecimale).
yaxisside < string Lato del grafico in cui verrà disegnata la scala Y dell'elemento del grafico.
Supportato per i grafici NORMAL e STACKED.
Valori possibili:1 LEFT (0, predefinito), RIGHT (1).
calc_fnc < string Dati da disegnare se per un item esiste più di un valore.
Valori possibili:1 MIN (1), AVG (2, predefinito), MAX (4), ALL (7; minimo, medio e massimo; supportato per i grafici semplici), LAST (9, supportato per i grafici a torta/esplosi).
type < string Tipo di elemento del grafico.
Valori possibili:1 SIMPLE (0, predefinito), GRAPH_SUM (2; il valore dell'item rappresenta l'intera torta; supportato per i grafici a torta/esplosi).
item < (obbligatorio) Item individuale.
< host string (obbligatorio) Host dell'item.
^ key string (obbligatorio) Chiave dell'item.

Vedi anche: Oggetto Graph item (fare riferimento alla proprietà pertinente con lo stesso nome).

Mappe dei valori dell'host

Element Type Description
uuid string (obbligatorio) Identificatore univoco per questa mappa dei valori.
name string (obbligatorio) Nome della mappa dei valori.
mapping Elemento radice per le mappature.
type string Tipo di corrispondenza della mappatura.
Valori possibili:1 EQUAL (0, predefinito), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
value string Valore originale.
newvalue string (obbligatorio) Valore a cui viene mappato il valore originale.

Vedi anche: Oggetto value map (fare riferimento alla proprietà corrispondente con lo stesso nome).

Note a piè di pagina

1 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.