8 Controlli interni

Panoramica

I controlli interni consentono di monitorare i processi interni di Zabbix. In altre parole, è possibile monitorare ciò che accade in Zabbix server o Zabbix proxy.

I controlli interni vengono calcolati:

• su Zabbix server - se il host è monitorato dal server
• su Zabbix proxy - se il host è monitorato dal proxy

I controlli interni vengono elaborati da server o proxy indipendentemente dallo stato di manutenzione del host.

Per utilizzare questo item, scegliere il tipo di item Zabbix internal.

Prestazioni

L'utilizzo di alcuni item interni può influire negativamente sulle prestazioni. Questi item sono:

• zabbix[host,,items]
• zabbix[host,,items_unsupported]
• zabbix[hosts]
• zabbix[items]
• zabbix[items_unsupported]
• zabbix[queue,,]
• zabbix[requiredperformance]
• zabbix[stats,,,queue,,]
• zabbix[triggers]

Anche le sezioni del frontend Informazioni di sistema e Coda sono interessate.

Controlli supportati

Le chiavi degli item sono elencate senza parametri personalizzabili e informazioni aggiuntive. Fare clic sulla chiave dell'item per visualizzare tutti i dettagli.

Dettagli della chiave item

• I parametri senza parentesi angolari sono obbligatori e devono essere utilizzati così come sono (ad esempio, "host" e "available" in zabbix[host,<type>,available]).
• I parametri con parentesi angolari < > devono essere sostituiti con un valore valido. Se un parametro ha un valore predefinito, può essere omesso.
• I valori per gli item e i parametri degli item contrassegnati come "not supported on proxy" possono essere recuperati solo se l'host è monitorato dal server. Viceversa, i valori "not supported on server" possono essere recuperati solo se l'host è monitorato dal proxy.

zabbix[boottime]

L'ora di avvio del processo di Zabbix server o Zabbix proxy in secondi.
Valore restituito: Integer.

zabbix[cluster,discovery,nodes]

Rileva i nodi del cluster ad alta disponibilità.
Valore restituito: oggetto JSON.

Commenti:

• Questo item può essere utilizzato nel low-level discovery.
• I campi restituiti corrispondono per lo più alle proprietà dell'oggetto nodo di alta disponibilità.
• Campi aggiuntivi:
  • db_timestamp — ora corrente del server (timestamp Unix) inclusa nella risposta
  • lastaccess_age — secondi trascorsi dall'ultimo heartbeat del nodo (db_timestamp - lastaccess)
  • status — stato del nodo:
    • 0 — standby
    • 1 — arrestato manualmente
    • 2 — non disponibile
    • 3 — attivo

Esempio di valori restituiti:

[
  {
    "id": "ckvupihk70001z8mkpw5cg0u3",
    "name": "zabbix-prod-01",
    "status": 3,
    "address": "10.0.4.12:10051",
    "port": 10051,
    "lastaccess": 1756115995,
    "db_timestamp": 1756116000,
    "lastaccess_age": 5
  },
  {
    "id": "ckvx2a9k70004b1nq2hz9d7f",
    "name": "zabbix-standby-02",
    "status": 0,
    "address": "10.0.4.13:10051",
    "port": 10051,
    "lastaccess": 1756115550,
    "db_timestamp": 1756116000,
    "lastaccess_age": 450
  },
  {
    "id": "ckw0bq3l70007y4r1a0m5kz8",
    "name": "zabbix-backup-eu1",
    "status": 1,
    "address": "backup.example.com:10051",
    "port": 10051,
    "lastaccess": 1756105080,
    "db_timestamp": 1756116000,
    "lastaccess_age": 10920
  }
]

zabbix[connector_queue]

Il numero di valori accodati nella coda del connector.
Valore restituito: Integer.

zabbix[discovery_queue]

Il numero di controlli di rete accodati nella coda di discovery.
Valore restituito: Integer.

zabbix[host,,items]

Il numero di item abilitati (supportati e non supportati) sull'host.
Valore restituito: Intero.

zabbix[host,,items_unsupported]

Il numero di item non supportati abilitati sull'host.
Valore restituito: Integer.

zabbix[host,,maintenance]

Lo stato di manutenzione corrente del host.
Valori restituiti: 0 - stato normale; 1 - manutenzione con raccolta dati; 2 - manutenzione senza raccolta dati.

Commenti:

• Questo item viene sempre elaborato da Zabbix server indipendentemente dalla posizione del host (sul server o sul proxy). Il proxy non riceverà questo item con i dati di configurazione.
• Il secondo parametro deve essere vuoto ed è riservato per uso futuro.

zabbix[host,active_agent,available]

La disponibilità dei controlli attivi dell'agent sull'host.
Valori restituiti: 0 - sconosciuto; 1 - disponibile; 2 - non disponibile.

zabbix[host,discovery,interfaces]

The details of all configured interfaces of the host in Zabbix frontend.
Return value: JSON object.

Comments:

• This item can be used in low-level discovery;
• This item is not supported on Zabbix proxy.

zabbix[host,<type>,available]

La disponibilità dell'interfaccia principale di un particolare tipo di controlli sul host.
Valori restituiti: 0 - sconosciuto; 1 - disponibile; 2 - non disponibile.

Parametri:

• type - agent, snmp, ipmi o jmx.

Commenti:

• Il valore dell'item viene calcolato in base ai parametri di configurazione relativi a irraggiungibilità/indisponibilità del host.

zabbix[hosts]

Il numero di host monitorati.
Valore restituito: intero.

zabbix[items]

Il numero di item abilitati (supportati e non supportati).
Valore restituito: Integer.

zabbix[items_unsupported]

Il numero di item non supportati.
Valore restituito: Integer.

zabbix[java,,<param>]

Informazioni su Zabbix Java gateway.
Valori restituiti: 1 - se <param> è ping; versione di Java gateway - se <param> è version (per esempio: "8.0.0").

Parametri:

• param - ping oppure version.

Commenti:

• Questo item può essere utilizzato per verificare la disponibilità di Java gateway usando la funzione trigger nodata().
• Il secondo parametro deve essere vuoto ed è riservato per utilizzi futuri.

zabbix[lld_queue]

Il numero di valori accodati nella coda di elaborazione del low-level discovery.
Valore restituito: Integer.

Commenti:

• Questo item può essere utilizzato per monitorare la lunghezza della coda di elaborazione del low-level discovery.

zabbix[preprocessing]

Statistiche dei valori ricevuti dal gestore di preprocessing:

• queued - il numero e la dimensione dei valori in coda che richiedono preprocessing (contatore)
• direct - il numero e la dimensione dei valori in coda che non richiedono preprocessing (contatore)
• queue - il conteggio dei valori accodati nella coda di preprocessing (uguale a zabbix[preprocessing_queue])

Valore restituito: JSON.

Esempio di valori restituiti:

{"data":
    {
    "queued": {
        "count": 106,
        "size": 58620
    },
    "direct": {
        "count": 395,
        "size": 33843
    },
    "queue": 0
    }
}

zabbix[preprocessing_queue]

Il numero di valori accodati nella coda di preprocessing.
Valore restituito: Integer.

Commenti:

• Questo item può essere utilizzato per monitorare la lunghezza della coda di preprocessing.

zabbix[process,<type>,<mode>,<state>]

La percentuale di tempo che un particolare processo Zabbix o un gruppo di processi (identificati da <type> e <mode>) ha trascorso nello stato <state>. Viene calcolata solo per l’ultimo minuto.
Valore restituito: Float.

Parametri:

• type - per i processi server: agent poller, alert manager, alert syncer, alerter, availability manager, browser poller, configuration syncer, configuration syncer worker, connector manager, connector worker, discovery manager, discovery worker, escalator, ha manager, history poller, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller ipmi manager, ipmi poller, java poller, lld manager, lld worker, odbc poller, poller, preprocessing manager, preprocessing worker, proxy group manager, proxy poller, self-monitoring, service manager, snmp poller, snmp trapper, task manager, timer, trapper, trigger housekeeper, unreachable poller, vmware collector;
  per i processi proxy: agent poller, availability manager, browser poller, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller ipmi manager, ipmi poller, java poller, odbc poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp poller, snmp trapper, task manager, trapper, unreachable poller, vmware collector;
• mode - avg - valore medio per tutti i processi di un determinato tipo (predefinito);
  count - restituisce il numero di fork per un determinato tipo di processo, <state> non deve essere specificato;
  max - valore massimo;
  min - valore minimo;
  <process number> - numero del processo (tra 1 e il numero di istanze pre-fork; ad esempio, se sono in esecuzione 4 trapper, il valore è compreso tra 1 e 4);
• state - busy - il processo è nello stato occupato, ad esempio durante l’elaborazione di una richiesta (predefinito);
  idle - il processo è nello stato inattivo e non sta facendo nulla.

Commenti:

• Se <mode> è un numero di processo Zabbix che non è in esecuzione (ad esempio, con 5 poller in esecuzione viene specificato <mode> uguale a 6), tale item diventerà non supportato.
• Il minimo e il massimo si riferiscono alla percentuale di utilizzo di un singolo processo. Quindi, se in un gruppo di 3 poller le percentuali di utilizzo per processo sono 2, 18 e 66, min restituirà 2 e max restituirà 66.
• I processi riportano ciò che stanno facendo nella memoria condivisa e il processo di self-monitoring riepiloga tali dati ogni secondo. Le modifiche di stato (busy/idle) vengono registrate al momento del cambiamento; pertanto un processo che diventa busy viene registrato come tale e non cambia né aggiorna lo stato finché non diventa idle. Questo garantisce che anche i processi completamente bloccati vengano registrati correttamente come busy al 100%.
• Attualmente, "busy" significa "non in sleep", ma in futuro potrebbero essere introdotti stati aggiuntivi: attesa di lock, esecuzione di query al database, ecc. Si noti che i poller asincroni sono considerati busy se hanno raggiunto il limite impostato dal parametro di configurazione MaxConcurrentChecksPerPoller server/proxy.
• Su Linux e sulla maggior parte degli altri sistemi, la risoluzione è di 1/100 di secondo.

Esempi:

zabbix[process,poller,avg,busy] #il tempo medio dei processi poller trascorso a fare qualcosa durante l’ultimo minuto
zabbix[process,"icmp pinger",max,busy] #il tempo massimo trascorso a fare qualcosa da un qualsiasi processo ICMP pinger durante l’ultimo minuto
zabbix[process,"history syncer",2,busy] #il tempo trascorso a fare qualcosa da history syncer numero 2 durante l’ultimo minuto
zabbix[process,trapper,count] #il numero di processi trapper attualmente in esecuzione

zabbix[proxy,<name>,<param>]

Le informazioni sul proxy Zabbix.
Valore restituito: Intero.

Parametri:

• name - il nome del proxy;
• param - lastaccess - il timestamp dell'ultimo messaggio heartbeat ricevuto dal proxy;
  delay - per quanto tempo i valori raccolti non sono stati inviati; calcolato come "proxy delay" + ("ora corrente del server" - "proxy lastaccess"), dove "proxy delay" è la differenza tra l'ora corrente del proxy e il timestamp del valore non inviato più vecchio sul proxy.

Commenti:

• Questo item viene sempre elaborato dal server Zabbix indipendentemente dalla posizione dell'host (sul server o sul proxy).
• La funzione fuzzytime() può essere utilizzata per verificare la disponibilità del proxy.

Esempio:

zabbix[proxy,"Germany",lastaccess] #il timestamp dell'ultimo messaggio heartbeat ricevuto dal proxy "Germany"

zabbix[proxy,discovery]

L'elenco dei proxy Zabbix con nome, modalità, crittografia, compressione, versione, ultimo accesso, numero di host, numero di item, valori richiesti al secondo (vps), stato della versione (corrente/obsoleta/non supportata), timeout per tipo di item, nome del gruppo di proxy (se il proxy appartiene a un gruppo), stato (sconosciuto/offline/online).
Valore restituito: oggetto JSON.

zabbix[proxy group,<name>,available]

Il numero di proxy online in un gruppo di proxy.
Valore restituito: Integer.

Parametri:

• name - il nome del gruppo di proxy.

zabbix[proxy group,<name>,pavailable]

La percentuale di proxy online in un gruppo di proxy.
Valore restituito: Float.

Parametri:

• name - il nome del gruppo di proxy.

zabbix[proxy group,<name>,proxies]

L’elenco dei proxy Zabbix in un gruppo di proxy con nome, modalità, crittografia, compressione, versione, ultimo accesso, numero di host, numero di item, valori richiesti al secondo (vps), stato della versione (corrente/obsoleta/non supportata), timeout, nome del gruppo di proxy, stato (sconosciuto/offline/online).
Valore restituito: JSON.

Parametri:

• name - il nome del gruppo di proxy.

zabbix[proxy group,<name>,state]

Lo stato di un gruppo di proxy.
Valore restituito: 0 - sconosciuto; 1 - offline; 2 - in ripristino; 3 - online; 4 - in degrado.

Parametri:

• name - il nome del gruppo di proxy.

zabbix[proxy group,discovery]

Restituisce un elenco di gruppi di proxy con dati di configurazione e dati in tempo reale. I dati di configurazione includono il nome del gruppo di proxy, il ritardo di failover e il numero minimo richiesto di proxy online. I dati in tempo reale includono lo stato del gruppo di proxy (vedere i commenti per i dettagli), il numero di proxy online e la percentuale di proxy online.
Valore restituito: JSON.

Commenti:

• Questo item non restituisce i proxy senza gruppo.
• Se è presente un valore non valido per "failover_delay" o "min_online", viene riportato un valore speciale -1 per indicarlo. Possono verificarsi valori non validi se per la configurazione vengono utilizzate macro e queste non possono essere espanse in un valore valido.
• Lo stato del gruppo di proxy viene riportato come intero: 0 - sconosciuto; 1 - offline; 2 - in ripristino; 3 - online; 4 - in degradazione.

Esempio di valori restituiti:

{
    "groups": [
       { "name": "Riga", "failover_delay": 60, "min_online": 1 },
       { "name": "Tokyo", "failover_delay": 60, "min_online": 2 },
       { "name": "Porto Alegre", "failover_delay": 60, "min_online": 3 }
    ],
    "details": {
        "Riga": { "state": 3, "available": 10, "pavailable": 20 },
        "Tokyo": { "state": 3, "available": 10, "pavailable": 20 },
        "Porto Alegre": { "state": 1, "available": 0, "pavailable": 0 }
    }
}

zabbix[proxy_buffer,buffer,<mode>]

Le statistiche di utilizzo del buffer di memoria del proxy.
Valori restituiti: Integer (per la dimensione); Float (per la percentuale).

Parametri:

• mode: total - la dimensione totale del buffer (può essere usata per verificare se il buffer di memoria è abilitato);
  free - la dimensione del buffer libero;
  pfree - la percentuale di buffer libero;
  used - la dimensione del buffer utilizzato;
  pused - la percentuale di buffer utilizzato.

Commenti:

• Restituisce un errore 'Proxy memory buffer is disabled' quando il buffer di memoria è disabilitato;
  
• Questo item non è supportato su Zabbix server.

zabbix[proxy_buffer,state,changes]

Returns the number of state changes between disk/memory buffer modes since start.
Return values: Integer; 0 - the memory buffer is disabled.

Comments:

• Frequent state changes indicate that either the memory buffer size or age must be increased;
• If the memory buffer state is monitored infrequently (for example, once a minute) then the buffer might flip its state without it being registered.

zabbix[proxy_buffer,state,current]

Restituisce lo stato di funzionamento corrente in cui vengono memorizzati i nuovi dati.
Valori restituiti: 0 - disco; 1 - memoria.

Commenti:

• "0" viene restituito anche quando il buffer di memoria è disabilitato.

zabbix[proxy_history]

Il numero di valori nella tabella della cronologia del proxy in attesa di essere inviati al server.
Valori restituiti: Intero.

Commenti:

• Questo item non è supportato su Zabbix server.

zabbix[queue,<from>,<to>]

Il numero di item monitorati nella coda che sono in ritardo di almeno <from> secondi, ma di meno di <to> secondi.
Valore restituito: Intero.

Parametri:

• from - in ritardo di almeno (il valore predefinito è 6 secondi);
• to - in ritardo al massimo (il valore predefinito è infinito).

Commenti:

• I suffissi temporali (s,m,h,d,w) sono supportati nei parametri.

zabbix[rcache,<cache>,<mode>]

The availability statistics of the Zabbix configuration cache.
Return values: Integer (for size); Float (for percentage).

Parameters:

• cache - buffer;
• mode - total - the total size of buffer
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

zabbix[requiredperformance]

Le prestazioni richieste di Zabbix server o Zabbix proxy, espresse come nuovi valori al secondo previsti.
Valore restituito: Float.

Commenti:

• Corrisponde approssimativamente a "Prestazioni richieste del server, nuovi valori al secondo" in Reports > System information.

zabbix[stats,<ip>,<port>]

Restituisce le metriche interne di un server o proxy Zabbix. Se vengono specificati <ip> e <port>, le metriche vengono recuperate dall'istanza remota; altrimenti, dall'istanza locale.
Valori restituiti: oggetto JSON.

Parametri:

• ip - l'elenco di IP/DNS/maschere di rete di server/proxy da interrogare in remoto (il valore predefinito è 127.0.0.1);
• port - la porta del server/proxy da interrogare in remoto (il valore predefinito è 10051).

Commenti:

• La richiesta stats sarà accettata solo dagli indirizzi elencati nel parametro 'StatsAllowedIP' del server/proxy nell'istanza di destinazione.
• Questo item restituisce un insieme selezionato di metriche interne. Per i dettagli, vedere Monitoraggio remoto delle statistiche di Zabbix.

zabbix[stats,<ip>,<port>,queue,<from>,<to>]

Restituisce le metriche della coda interna (vedi zabbix[queue,<from>,<to>]) di un server o proxy Zabbix. Se <ip> e <port> sono specificati, le metriche vengono recuperate dall'istanza remota; altrimenti, dall'istanza locale.
Valori restituiti: oggetto JSON.

Parametri:

• ip - l'elenco di IP/DNS/maschere di rete di server/proxy da interrogare in remoto (il valore predefinito è 127.0.0.1);
• port - la porta del server/proxy da interrogare in remoto (il valore predefinito è 10051);
• from - in ritardo di almeno (il valore predefinito è 6 secondi);
• to - in ritardo di al massimo (il valore predefinito è infinito).

Commenti:

• La richiesta stats sarà accettata solo dagli indirizzi elencati nel parametro 'StatsAllowedIP' server/proxy sull'istanza di destinazione.
• Un insieme selezionato di metriche interne viene restituito da questo item. Per i dettagli, vedere Monitoraggio remoto delle statistiche di Zabbix.

zabbix[tcache,cache,<parameter>]

Le statistiche di efficacia della cache della funzione trend di Zabbix.
Valori restituiti: Integer (per la dimensione); Float (per la percentuale).

Parametri:

• parameter - all - richieste totali della cache (predefinito);
  hits - hit della cache;
  phits - percentuale di hit della cache;
  misses - mancate corrispondenze della cache;
  pmisses - percentuale di mancate corrispondenze della cache;
  items - numero di item memorizzati nella cache;
  requests - numero di richieste memorizzate nella cache;
  pitems - percentuale di item memorizzati nella cache rispetto a item memorizzati nella cache + richieste. Una percentuale bassa molto probabilmente indica che la dimensione della cache può essere ridotta.

Commenti:

• Questo item non è supportato su Zabbix proxy.

zabbix[triggers]

Il numero di trigger abilitati nel database di Zabbix, con tutti gli item abilitati su host abilitati.
Valore restituito: Integer.

Commenti:

• Questo item non è supportato su Zabbix proxy.

zabbix[uptime]

L'uptime del processo del server o del proxy Zabbix in secondi.
Valore restituito: Integer.

zabbix[vcache,buffer,<mode>]

Le statistiche di disponibilità della cache dei valori di Zabbix.
Valori restituiti: Integer (per la dimensione); Float (per la percentuale).

Parametri:

• mode - total - la dimensione totale del buffer;
  free - la dimensione del buffer libero;
  pfree - la percentuale di buffer libero;
  used - la dimensione del buffer utilizzato;
  pused - la percentuale di buffer utilizzato.

Commenti:

• Questo item non è supportato su Zabbix proxy.

zabbix[vcache,cache,<parameter>]

Le statistiche di efficacia della cache dei valori di Zabbix.
Valore restituito: Integer. Se <parameter> è impostato su mode, il valore restituito è: 0 - modalità normale; 1 - modalità memoria insufficiente.

Parametri:

• parameter - requests - il numero totale di richieste;
  hits - il numero di hit della cache (valori della cronologia presi dalla cache);
  misses - il numero di miss della cache (valori della cronologia presi dal database);
  mode - la modalità operativa della cache dei valori.

Commenti:

• Una volta attivata la modalità memoria insufficiente, la cache dei valori rimarrà in questo stato per 24 ore, anche se il problema che ha attivato questa modalità viene risolto prima.
• È possibile utilizzare questa chiave con il passaggio di preprocessing Change per second per ottenere statistiche dei valori al secondo.
• Questo item non è supportato su Zabbix proxy.

zabbix[version]

La versione del server o del proxy Zabbix.
Valore restituito: String. Ad esempio: 8.0.0.

zabbix[vmware,buffer,<mode>]

The availability statistics of the Zabbix vmware cache.
Return values: Integer (for size); Float (for percentage).

Parameters:

• mode - total - the total size of buffer
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

zabbix[vps,written]

Il numero totale di valori dello storico scritti nel database.
Valore restituito: Integer.

zabbix[wcache,<cache>,<mode>]

Le statistiche e la disponibilità della cache di scrittura di Zabbix.
Valori restituiti: Integer (per numero/dimensione); Float (per percentuale).

Parametri:

• cache - values, history, index o trend;
• mode - (con values) all (predefinito) - il numero totale di valori elaborati da Zabbix server/proxy, eccetto gli item non supportati (contatore);
  float - il numero di valori float elaborati (contatore);
  uint - il numero di valori interi senza segno elaborati (contatore);
  str - il numero di valori carattere/stringa elaborati (contatore);
  log - il numero di valori log elaborati (contatore);
  text - il numero di valori testo elaborati (contatore);
  bin - il numero di valori binari elaborati (contatore);
  json - il numero di valori JSON elaborati (contatore);
  not supported - il numero di volte in cui l'elaborazione dell'item ha comportato che l'item diventasse non supportato o mantenesse tale stato (contatore);
  (con cache history, index, trend) pfree (predefinito) - la percentuale di buffer libero;
  total - la dimensione totale del buffer;
  free - la dimensione del buffer libero;
  used - la dimensione del buffer utilizzato;
  pused - la percentuale di buffer utilizzato.

Commenti:

• Il parametro della cache trend non è supportato con Zabbix proxy.
• La cache history viene utilizzata per memorizzare i valori degli item. Un numero basso indica problemi di prestazioni lato database.
• La cache history index viene utilizzata per indicizzare i valori memorizzati nella cache history.
• Dopo che la cache history è stata riempita e poi svuotata, la cache history index manterrà comunque alcuni dati. Questo comportamento è previsto e aiuta il sistema a funzionare in modo più efficiente evitando l'elaborazione aggiuntiva necessaria per ridimensionare costantemente la memoria.
• La cache trend memorizza l'aggregato dell'ora corrente per tutti gli item che ricevono dati.
• È possibile utilizzare la chiave zabbix[wcache,values] con il passaggio di preprocessing Change per second per ottenere statistiche dei valori al secondo.