4 Proxy

Panoramica

Zabbix proxy è un processo che può raccogliere dati di monitoraggio da uno o più dispositivi monitorati e inviare le informazioni al server Zabbix, operando essenzialmente per conto del server. Tutti i dati raccolti vengono memorizzati temporaneamente in locale e quindi trasferiti al server Zabbix a cui il proxy appartiene.

La distribuzione di un proxy è facoltativa, ma può essere molto vantaggiosa per distribuire il carico di un singolo server Zabbix. Se solo i proxy raccolgono i dati, l'elaborazione sul server richiede meno CPU e I/O su disco.

Uno Zabbix proxy è la soluzione ideale per il monitoraggio centralizzato di sedi remote, filiali e reti senza amministratori locali.

Zabbix proxy richiede un database separato.

Si noti che i database supportati con Zabbix proxy sono SQLite, MySQL e PostgreSQL.

Vedi anche: Utilizzo dei proxy in un ambiente distribuito

Eseguire il proxy

Se installato come pacchetto

Zabbix proxy viene eseguito come processo daemon. Il proxy può essere avviato eseguendo:

systemctl start zabbix-proxy

Questo funzionerà sulla maggior parte dei sistemi GNU/Linux. Su altri sistemi potrebbe essere necessario eseguire:

/etc/init.d/zabbix-proxy start

Analogamente, per arrestare/riavviare/visualizzare lo stato di Zabbix proxy, utilizzare i seguenti comandi:

systemctl stop zabbix-proxy
systemctl restart zabbix-proxy
systemctl status zabbix-proxy
Avvio manuale

Se quanto sopra non funziona, è necessario avviarlo manualmente. Individua il percorso del binario zabbix_proxy ed esegui:

zabbix_proxy

È possibile usare i seguenti parametri da riga di comando con Zabbix proxy:

-c --config <file>              Percorso del file di configurazione
-f --foreground                 Esegui Zabbix proxy in primo piano
-R --runtime-control <option>   Esegui funzioni amministrative
-T --test-config                Valida il file di configurazione ed esci
-h --help                       Mostra questo aiuto
-V --version                    Mostra il numero di versione

Esempi di esecuzione di Zabbix proxy con parametri da riga di comando:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf
zabbix_proxy --help
zabbix_proxy -V
Controllo runtime

Opzioni di controllo runtime:

Option Description Target
config_cache_reload Ricarica la cache di configurazione. Ignorato se la cache è attualmente in fase di caricamento.
Il proxy Zabbix attivo si connetterà al server Zabbix e richiederà i dati di configurazione.
Il proxy Zabbix passivo richiederà i dati di configurazione al server Zabbix la volta successiva in cui il server si connetterà al proxy.
history_cache_clear=target Svuota la cache della cronologia per l'item specificato dal relativo ID.
Influisce su tutti i valori dell'item, tranne il primo e l'ultimo valore.		 target - ID dell'item.
diaginfo[=<section>] Raccoglie informazioni diagnostiche nel file di log del proxy. historycache - statistiche della cache della cronologia;
preprocessing - statistiche del gestore di preprocessing;
locks - elenco dei mutex (è vuoto sui sistemi BSD).
snmp_cache_reload Ricarica la cache SNMP - svuota le proprietà del motore SNMP (engine time, engine boots, engine id, credenziali) per tutti gli host. Usalo per forzare una pulizia globale della cache durante la risoluzione dei problemi SNMP.
housekeeper_execute Avvia la procedura di housekeeping. Ignorato se la procedura di housekeeping è attualmente in corso.
log_level_increase[=<target>] Aumenta il livello di log, influisce su tutti i processi se il target non è specificato.
Non supportato sui sistemi BSD.		 process type - tutti i processi del tipo specificato (ad esempio, poller).
Vedi tutti i tipi di processo del proxy.
process type,N - tipo di processo e numero (ad esempio, poller,3)
pid - identificatore del processo (1 to 65535). Per valori maggiori specifica il target come 'process type,N'.
log_level_decrease[=<target>] Riduce il livello di log, influisce su tutti i processi se il target non è specificato.
Non supportato sui sistemi BSD.
prof_enable[=<target>] Abilita il profiling.
Influisce su tutti i processi se il target non è specificato.
Il profiling abilitato fornisce dettagli di tutti i rwlock/mutex per nome funzione.		 process type - tutti i processi del tipo specificato (ad esempio, history syncer).
Vedi tutti i tipi di processo del proxy.
process type,N - tipo di processo e numero (ad esempio, history syncer,1).
pid - identificatore del processo (1 to 65535). Per valori maggiori specifica il target come 'process type,N'.
scope - rwlock, mutex, processing possono essere usati con il tipo di processo e il numero (ad esempio, history syncer,1,processing) oppure con tutti i processi di un tipo (ad esempio, history syncer,rwlock).
prof_disable[=<target>] Disabilita il profiling.
Influisce su tutti i processi se il target non è specificato.		 process type - tutti i processi del tipo specificato (ad esempio, history syncer).
Vedi tutti i tipi di processo del proxy.
process type,N - tipo di processo e numero (ad esempio, history syncer,1).
pid - identificatore del processo (1 to 65535). Per valori maggiori specifica il target come 'process type,N'.

Esempio di utilizzo del controllo runtime per ricaricare la cache di configurazione del proxy:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R config_cache_reload

Esempio di utilizzo del controllo runtime per svuotare la cache della cronologia per un item:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R history_cache_clear=42243

Esempi di utilizzo del controllo runtime per raccogliere informazioni diagnostiche:

# Raccogli tutte le informazioni diagnostiche disponibili nel file di log del proxy:
zabbix_proxy -R diaginfo

# Raccogli le statistiche della cache della cronologia nel file di log del proxy:
zabbix_proxy -R diaginfo=historycache

Esempio di utilizzo del controllo runtime per ricaricare la cache SNMP:

zabbix_proxy -R snmp_cache_reload

Quando un'interfaccia SNMPv3 viene aggiornata tramite la UI di Zabbix, nella maggior parte dei casi Zabbix ricaricherà automaticamente le nuove credenziali SNMPv3 per tale interfaccia; usa -R snmp_cache_reload solo se il polling continua a non riuscire dopo la modifica delle credenziali (ad esempio, a causa di incoerenze engineBoots/engineID o di dispositivi non RFC), oppure quando devi forzare una pulizia globale della cache SNMP per la risoluzione dei problemi.

Esempio di utilizzo del controllo runtime per avviare l'esecuzione di housekeeper:

zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R housekeeper_execute

Esempi di utilizzo del controllo runtime per modificare il livello di log:

# Aumenta il livello di log di tutti i processi:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_increase

# Aumenta il livello di log del secondo processo poller:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_increase=poller,2

# Aumenta il livello di log del processo con PID 1234:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_increase=1234

# Riduce il livello di log di tutti i processi http poller:
zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R log_level_decrease="http poller"
Utente del processo

Zabbix proxy è progettato per essere eseguito come utente non root. Verrà eseguito come qualsiasi utente non root con cui viene avviato. Quindi puoi eseguire proxy come qualsiasi utente non root senza problemi.

Se provi a eseguirlo come 'root', passerà a un utente 'zabbix' codificato in modo fisso, che deve essere presente nel tuo sistema. Puoi eseguire proxy come 'root' solo se modifichi di conseguenza il parametro AllowRoot nel file di configurazione di proxy.

File di configurazione

Vedere le opzioni del file di configurazione per i dettagli sulla configurazione di zabbix_proxy.

Tipi di processi e thread del proxy

  • agent poller - processo poller asincrono per i controlli passivi con un thread worker;
  • availability manager - processo per gli aggiornamenti della disponibilità dell'host;
  • browser poller - poller per i controlli degli item browser;
  • configuration syncer - processo per la gestione della cache in memoria dei dati di configurazione;
  • data sender - invio dati del proxy;
  • discovery manager - processo manager per la discovery dei dispositivi;
  • discovery worker - processo per la gestione delle attività di discovery provenienti dal discovery manager;
  • history syncer - writer del DB della history;
  • housekeeper - processo per la rimozione della history obsoleta degli item;
  • http agent poller - processo poller asincrono per i controlli HTTP con un thread worker;
  • http poller - poller per il monitoraggio web;
  • icmp pinger - poller per i controlli icmpping;
  • internal poller - poller per i controlli interni;
  • ipmi manager - manager del poller IPMI;
  • ipmi poller - poller per i controlli IPMI;
  • java poller - poller per i controlli Java;
  • odbc poller - poller per i controlli ODBC;
  • poller - poller normale per i controlli passivi;
  • preprocessing manager - manager delle attività di preprocessing con thread worker di preprocessing;
  • preprocessing worker - thread per il preprocessing dei dati;
  • self-monitoring - processo per la raccolta delle statistiche interne del server;
  • snmp poller - processo poller asincrono per i controlli SNMP con un thread worker (walk[OID] e get[OID] solo item);
  • snmp trapper - trapper per i trap SNMP;
  • task manager - processo per l'esecuzione remota delle attività richieste da altri componenti (ad esempio chiudere un problema, riconoscere un problema, verificare ora il valore di un item, funzionalità di comando remoto);
  • trapper - trapper per i controlli attivi, i trap e la comunicazione del proxy;
  • unreachable poller - poller per i dispositivi non raggiungibili;
  • vmware collector - raccoglitore di dati VMware responsabile della raccolta dei dati dai servizi VMware.

Il file di log del proxy può essere utilizzato per osservare questi tipi di processo.

Il file di log del proxy viene creato con permessi di lettura e scrittura solo per il proprietario del file. Inoltre, il file è leggibile dal gruppo proprietario. Tutti gli altri permessi sono negati.

Vari tipi di processi del proxy Zabbix possono essere monitorati usando l'item interno zabbix[process,<type>,<mode>,<state>] item.

Statistiche delle transazioni del history syncer

Il titolo del processo history syncer mostra statistiche dettagliate sulle transazioni del history syncer.

205276 ?        S      0:00  zabbix_proxy: history syncer #1 [processed 1 values in 0.001179 (0.001167,0.000000) sec, idle 1 sec]
205277 ?        S      0:00  zabbix_proxy: history syncer #2 [processed 0 values in 0.000022 (0.000000,0.000000) sec, idle 1 sec]

I tempi, in processed...in N (<timings>) sec, sono:

  • Tempo impiegato per scrivere i valori degli item nel database.
  • Tempo impiegato per aggiornare i dati dell'item (stato, errori).
Procedura di housekeeping

Il proxy Zabbix dispone del processo housekeeper che rimuove la cronologia e i trend obsoleti degli item. Viene eseguito a cicli, con frequenza determinata da HousekeepingFrequency e con il limite di eliminazione per ciclo determinato da ProxyLocalBuffer e ProxyOfflineBuffer. A differenza della procedura di housekeeping del server Zabbix, il processo housekeeper del proxy non utilizza la tabella housekeeper: elimina tutti i dati obsoleti una volta per ogni ciclo di housekeeping.

Piattaforme supportate

Zabbix proxy funziona sullo stesso elenco di piattaforme supportate di Zabbix server.

Buffer di memoria

Il buffer di memoria consente di memorizzare nuovi dati (valori degli item, network discovery, host autoregistration) nel buffer e di caricarli su Zabbix server senza accedere al database. Il buffer di memoria è stato introdotto per il proxy in Zabbix 7.0.

Nelle installazioni precedenti a Zabbix 7.0, i dati raccolti venivano memorizzati nel database prima di essere caricati su Zabbix server. Per queste installazioni, questo rimane il comportamento predefinito dopo l'aggiornamento a Zabbix 7.0.

Per prestazioni ottimizzate, si consiglia di configurare l'uso del buffer di memoria sul proxy. Questo è possibile modificando il valore di ProxyBufferMode da disk (impostazione predefinita hardcoded per le installazioni esistenti) a hybrid (consigliato) o memory. È inoltre necessario impostare la dimensione del buffer di memoria (parametro ProxyMemoryBufferSize).

In modalità hybrid, il buffer è protetto dalla perdita di dati scaricando nel database i dati non inviati se il proxy viene arrestato, il buffer è pieno o i dati sono troppo vecchi. Quando tutti i valori sono stati scaricati nel database, il proxy torna a utilizzare il buffer di memoria.

In modalità memory, il buffer di memoria viene utilizzato, tuttavia non esiste alcuna protezione contro la perdita di dati. Se il proxy viene arrestato o la memoria viene sovraccaricata, i dati non inviati verranno eliminati.

La modalità hybrid (ProxyBufferMode=hybrid) viene applicata a tutte le nuove installazioni a partire da Zabbix 7.0.

Parametri aggiuntivi come ProxyMemoryBufferSize e ProxyMemoryBufferAge definiscono rispettivamente la dimensione del buffer di memoria e l'età massima dei dati nel buffer.

Si noti che, in caso di configurazione in conflitto, il proxy visualizzerà un errore e non si avvierà, ad esempio se:

  • ProxyBufferMode è impostato su hybrid o memory e ProxyMemoryBufferSize è 0.
  • ProxyBufferMode è impostato su hybrid o memory e ProxyLocalBuffer non è 0.

Locale

Si noti che il proxy richiede una locale UTF-8 affinché alcuni item testuali possano essere interpretati correttamente. La maggior parte dei moderni sistemi di tipo Unix utilizza una locale UTF-8 come impostazione predefinita; tuttavia, esistono alcuni sistemi in cui potrebbe essere necessario configurarla esplicitamente.

Calcolo delle code durante la manutenzione

Il proxy Zabbix non è a conoscenza dei periodi di manutenzione; per i dettagli, vedere Calcolo delle code durante la manutenzione.