agent

Panoramica

Zabbix agent viene distribuito su un target di monitoraggio per monitorare attivamente le risorse e le applicazioni locali (dischi rigidi, memoria, statistiche del processore, ecc.).

L'agent raccoglie localmente le informazioni operative e invia i dati al server Zabbix per un'ulteriore elaborazione. In caso di errori (ad esempio, un disco rigido pieno o un processo di servizio arrestato in modo anomalo), il server Zabbix può avvisare attivamente gli amministratori della macchina specifica che ha segnalato l'errore.

Gli agent Zabbix sono altamente efficienti perché utilizzano chiamate di sistema native per raccogliere informazioni statistiche.

È possibile eseguire più istanze dell'agent su un host.

Vedere anche:

Controlli passivi e attivi

Gli agent Zabbix possono eseguire controlli passivi e attivi:

  • Controlli passivi - l'agent Zabbix risponde a una richiesta da parte di Zabbix server (o proxy). Ad esempio, il server richiede dati (ad esempio, il carico della CPU) e l'agent restituisce il risultato.
  • Controlli attivi - l'agent Zabbix raccoglie e invia i dati senza attendere una richiesta da parte di Zabbix server (o proxy). Per prima cosa, recupera un elenco di item di monitoraggio da server (carico della CPU, memoria disponibile, ecc.), quindi raccoglie i dati richiesti e invia periodicamente nuovi valori al server.

Il tipo di controllo dell'agent viene configurato selezionando il rispettivo tipo di item di monitoraggio. L'agent Zabbix elabora gli item di tipo Zabbix agent o Zabbix agent (active).

Piattaforme supportate

Per le piattaforme supportate, fare riferimento alla pagina Requisiti.

Agent sui sistemi Unix-like

Zabbix agent sui sistemi Unix-like viene eseguito sull'host monitorato.

Installazione

Zabbix agent può essere installato sui sistemi basati su Linux utilizzando uno dei seguenti metodi:

  • Pacchetti Zabbix - selezionare il componente Agent (dopo aver selezionato la versione di Zabbix, la distribuzione del sistema operativo e la versione del sistema operativo) e seguire le istruzioni fornite;
  • Sorgenti Zabbix - scaricare i file sorgente e compilare Zabbix agent configurando i sorgenti con l'opzione --enable-agent.

In generale, gli agent Zabbix a 32 bit funzionano sui sistemi a 64 bit, ma in alcuni casi potrebbero non funzionare.

I binari precompilati di Zabbix agent sono disponibili per il download per macOS, IBM AIX, FreeBSD, OpenBSD e Solaris. I binari legacy, compatibili con la versione corrente di Zabbix server/proxy, sono disponibili per NetBSD e HP-UX. Per installare ed eseguire l'agent su IBM AIX, vedere Zabbix agent su IBM AIX.

Se installato come pacchetto

Zabbix agent viene eseguito come processo daemon. L'agent può essere avviato eseguendo:

systemctl start zabbix-agent

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

/etc/init.d/zabbix-agent start

Per arrestare, riavviare o controllare lo stato di Zabbix agent, utilizzare i seguenti comandi:

systemctl stop zabbix-agent
systemctl restart zabbix-agent
systemctl status zabbix-agent
Se installato da un archivio binario

Dopo aver estratto l'archivio, individuare il binario zabbix_agentd e il file di configurazione zabbix_agentd.conf. La loro posizione all'interno dell'archivio dipende dalla piattaforma (ad esempio, sbin/ e conf/, oppure usr/sbin/ e etc/zabbix/). Eseguire direttamente il binario dalla directory estratta e specificare il file di configurazione con l'opzione -c. Ad esempio:

/opt/zabbix/sbin/zabbix_agentd -c /opt/zabbix/etc/zabbix/zabbix_agentd.conf

Nei sistemi simili a UNIX, Zabbix agent è progettato per essere eseguito da un utente non root. Se viene avviato come root, passa all'utente zabbix (o all'utente specificato dal parametro User), a meno che nel file di configurazione non sia impostato AllowRoot=1. Questo utente deve esistere nel sistema; in caso contrario, l'agent non viene avviato.

Su IBM AIX, l'agent può essere eseguito anche con il System Resource Controller (SRC) e avviato all'avvio del sistema; vedere Zabbix agent su IBM AIX.

Avvio manuale

È possibile avviare Zabbix agent eseguendo direttamente il binario zabbix_agentd, ad esempio:

zabbix_agentd

Questa operazione funziona quando la directory contenente zabbix_agentd è inclusa in PATH.

Agent sui sistemi Windows

Zabbix agent su Windows viene eseguito come servizio Windows.

Installazione

Zabbix agent può essere installato su Windows utilizzando uno dei seguenti metodi:

Vedere la pagina Zabbix agent su Microsoft Windows per ulteriori dettagli sull'installazione di Zabbix agent (da un archivio ZIP) come servizio Windows.

Opzioni

I seguenti parametri della riga di comando possono essere utilizzati con Zabbix agent:

Parametro Descrizione
UNIX e Windows agent
-c --config <config-file> Percorso del file di configurazione.
È possibile utilizzare questa opzione per specificare un file di configurazione diverso da quello predefinito.
-f --foreground Esegue Zabbix agent in primo piano (predefinito: true).
-p --print Stampa gli item conosciuti ed esce.
Per restituire anche i risultati dei parametri utente, è necessario specificare il file di configurazione (se non si trova nella posizione predefinita).
-t --test <item key> Testa l'item specificato ed esce.
Per restituire anche i risultati dei parametri utente, è necessario specificare il file di configurazione (se non si trova nella posizione predefinita).
-T --test-config Convalida il file di configurazione ed esce.
-h --help Visualizza le informazioni della guida.
-V --version Visualizza il numero di versione.
Solo UNIX agent
-R --runtime-control <option> Esegue funzioni amministrative. Vedere controllo runtime.
Solo Windows agent
-m --multiple-agents Utilizza più istanze dell'agent (con le opzioni -i, -d, -s, -x).
Per distinguere i nomi dei servizi delle istanze, ogni nome del servizio includerà il valore Hostname del file di configurazione specificato.
-S --startup-type <value> Imposta il tipo di avvio del servizio Zabbix Windows agent. Valori consentiti:
automatic - (predefinito) avvia automaticamente il servizio all'avvio di Windows;
delayed - ritarda l'avvio del servizio finché i servizi avviati automaticamente non hanno completato l'avvio (disponibile in Windows Server 2008/Vista e versioni successive);
manual - avvia manualmente il servizio (da parte di un utente o di un'applicazione);
disabled - disabilita il servizio, impedendone l'avvio da parte di un utente o di un'applicazione.
È possibile utilizzare questa opzione insieme all'opzione -i oppure separatamente per modificare il tipo di avvio di un servizio già installato.
-i --install Installa Zabbix Windows agent come servizio.
-d --uninstall Disinstalla il servizio Zabbix Windows agent.
-s --start Avvia il servizio Zabbix Windows agent.
-x --stop Arresta il servizio Zabbix Windows agent.

Esempi specifici di utilizzo dei parametri della riga di comando:

  • Stampa tutti gli item integrati dell'agent con i relativi valori.
  • Testa un parametro utente con la chiave mysql.ping definita nel file di configurazione specificato.
  • Installa un servizio Zabbix Agent per Windows utilizzando il percorso predefinito del file di configurazione.
  • Installa un servizio Zabbix Agent [Hostname] per Windows utilizzando il file di configurazione situato nella stessa cartella dell'eseguibile dell'agent e rende univoco il nome del servizio aggiungendovi il valore Hostname dal file di configurazione.
  • Modifica il tipo di avvio di un servizio Zabbix Agent per Windows installato utilizzando il file di configurazione situato nella stessa cartella dell'eseguibile dell'agent.
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
Controllo in fase di esecuzione

Con le opzioni di controllo in fase di esecuzione è possibile modificare il livello di log dei processi dell'agent.

Opzione Descrizione Destinazione
log_level_increase[=<target>] Aumenta il livello di log.
Se la destinazione non è specificata, vengono interessati tutti i processi.		 La destinazione può essere specificata come:
tipo di processo - tutti i processi del tipo specificato (ad esempio, listener)
Vedere tutti i tipi di processo dell'agent.
tipo di processo,N - tipo e numero del processo (ad esempio, listener,3)
pid - identificatore del processo (1 a 65535). Per valori maggiori, specificare la destinazione come 'tipo di processo,N'.
log_level_decrease[=<target>] Riduce il livello di log.
Se la destinazione non è specificata, vengono interessati tutti i processi.
userparameter_reload Ricarica i valori delle opzioni UserParameter e Include dal file di configurazione corrente.

Esempi:

  • Aumento del livello di log di tutti i processi
  • Aumento del livello di log del terzo processo listener
  • Aumento del livello di log del processo con PID 1234
  • Riduzione del livello di log di tutti i processi di controllo attivo
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"

Il controllo in fase di esecuzione non è supportato su OpenBSD, NetBSD e Windows.

Tipi di processo dell'agent

I tipi di processo dell'agent sono i seguenti:

  • active checks - processo per l'esecuzione dei controlli attivi;
  • collector - processo per la raccolta dei dati;
  • listener - processo per l'ascolto dei controlli passivi.

Il file di log dell'agent può essere utilizzato per osservare questi tipi di processo.

Il file di log dell'agent viene creato con autorizzazioni di lettura e scrittura solo per il proprietario del file. Inoltre, il file è leggibile dal gruppo del proprietario. Tutte le altre autorizzazioni sono negate.

Esegui come utente

Zabbix agent su UNIX è progettato per essere eseguito come utente non root. Verrà eseguito con l'utente non root con cui è stato avviato. Pertanto, è possibile eseguire agent con qualsiasi utente non root senza problemi.

Se si tenta di eseguirlo come "root", passerà all'utente "zabbix" codificato nel programma, che deve essere presente nel sistema. È possibile eseguire agent come "root" solo modificando di conseguenza il parametro AllowRoot nel file di configurazione di agent.

File di configurazione

Il percorso predefinito del file di configurazione dipende dal sistema operativo e dal metodo di installazione di Zabbix:

  • Su UNIX, il valore predefinito è:
    • Per l'installazione dai sorgenti: /usr/local/etc/zabbix_agentd.conf, oppure quello impostato dalle variabili di compilazione --sysconfdir o --prefix.
    • Per l'installazione dai pacchetti e dall'appliance: /etc/zabbix/zabbix_agentd.conf.
  • Su Windows, il valore predefinito è C:\Program Files\Zabbix Agent\zabbix_agentd.conf.

Se su un host è in esecuzione una singola istanza dell'agent, questa può utilizzare il file di configurazione predefinito oppure un file di configurazione specificato nella riga di comando. In caso di più istanze, ogni istanza dell'agent deve avere il proprio file di configurazione (una delle istanze può utilizzare il file di configurazione predefinito).

Per informazioni dettagliate sulla configurazione dell'agent Zabbix, vedere le opzioni del file di configurazione per l'agent Zabbix Unix o l'agent Zabbix Windows.

Locale

Si noti che l'agent richiede una locale UTF-8 affinché alcuni item testuali dell'agent possano restituire il contenuto previsto. La maggior parte dei moderni sistemi Unix-like ha una locale UTF-8 come impostazione predefinita; tuttavia, in alcuni sistemi potrebbe essere necessario impostarla esplicitamente.

Codice di uscita

L'agent Zabbix restituisce 0 in caso di uscita riuscita e 1 in caso di errore.