Parameter	Description
Alias	Imposta un alias per una chiave item.
AllowKey	Consente l'esecuzione delle chiavi item che corrispondono a un pattern.
BufferSend	Non conservare i dati nel buffer per più di N secondi.
BufferSize	Il numero massimo di valori nel buffer in memoria.
ControlSocket	Il socket di controllo, usato per inviare comandi a runtime con l'opzione '-R'.
DebugLevel	Il livello di debug.
DenyKey	Nega l'esecuzione delle chiavi item che corrispondono a un pattern.
EnablePersistentBuffer	Abilita l'uso dell'archiviazione persistente locale per gli item attivi.
ForceActiveChecksOnStart	Esegue i controlli attivi immediatamente dopo il riavvio per la prima configurazione ricevuta.
HeartbeatFrequency	La frequenza dei messaggi heartbeat in secondi.
HostInterface	Parametro opzionale che definisce l'interfaccia dell'host.
HostInterfaceItem	Parametro opzionale che definisce un item usato per ottenere l'interfaccia dell'host.
HostMetadata	Parametro opzionale che definisce i metadati dell'host.
HostMetadataItem	Parametro opzionale che definisce un item di Zabbix agent usato per ottenere i metadati dell'host.
Hostname	Parametro opzionale che definisce il nome host.
HostnameItem	Parametro opzionale che definisce un item di Zabbix agent usato per ottenere il nome host.
Include	È possibile includere singoli file o tutti i file in una directory nel file di configurazione.
ListenIP	Un elenco di indirizzi IP separati da virgole su cui l'agent deve ascoltare.
ListenPort	L'agent ascolterà su questa porta le connessioni dal server.
LogFile	Il nome del file di log.
LogFileSize	La dimensione massima del file di log.
LogType	Il tipo di output del log.
PersistentBufferFile	Il file in cui Zabbix agent 2 deve conservare il database SQLite.
PersistentBufferPeriod	L'intervallo di tempo per cui i dati devono essere memorizzati quando non c'è connessione al server o al proxy.
PidFile	Il nome del file PID.
Plugins.<PluginName>.System.Capacity	Il limite di controlli per plugin che possono essere eseguiti contemporaneamente.
Plugins.Log.MaxLinesPerSecond	Il numero massimo di nuove righe che l'agent invierà al secondo a Zabbix server o proxy durante l'elaborazione dei controlli attivi 'log' e 'logrt'.
Plugins.SystemRun.LogRemoteCommands	Abilita la registrazione dei comandi shell eseguiti come avvisi.
PluginSocket	Il percorso del socket UNIX per la comunicazione con i plugin caricabili.
PluginTimeout	Il timeout per le connessioni con i plugin caricabili, in secondi.
RefreshActiveChecks	Con quale frequenza viene aggiornato l'elenco dei controlli attivi.
Server	Un elenco di indirizzi IP separati da virgole, opzionalmente in notazione CIDR, o nomi DNS di Zabbix server e Zabbix proxy.
ServerActive	L'indirizzo di Zabbix server/proxy o la configurazione del cluster da cui ottenere i controlli attivi.
SourceIP	L'indirizzo IP di origine.
StatusPort	Se impostato, l'agent ascolterà su questa porta le richieste HTTP di stato (http://localhost:<port>/status).
Timeout	Specifica per quanto tempo attendere (in secondi) per stabilire la connessione e scambiare dati con Zabbix proxy o server.
TLSAccept	Quali connessioni in ingresso accettare.
TLSCAFile	Il percorso completo di un file contenente i certificati della CA di livello superiore per la verifica del certificato del peer, usato per le comunicazioni cifrate tra i componenti di Zabbix.
TLSCertFile	Il percorso completo di un file contenente il certificato dell'agent o la catena di certificati, usato per le comunicazioni cifrate tra i componenti di Zabbix.
TLSCipherAll	La stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la cifratura basata su certificato e PSK.
TLSCipherAll13	La stringa di cifratura OpenSSL (TLS 1.3) per OpenSSL 1.1.1 o versioni successive. Sostituisce i criteri predefiniti di selezione della suite di cifratura per la cifratura basata su certificato e PSK.
TLSCipherCert	La stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la cifratura basata su certificato.
TLSCipherCert13	La stringa di cifratura OpenSSL (TLS 1.3) per OpenSSL 1.1.1 o versioni successive. Sostituisce i criteri predefiniti di selezione della suite di cifratura per la cifratura basata su certificato.
TLSCipherPSK	La stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura per la cifratura basata su PSK.
TLSCipherPSK13	La stringa di cifratura OpenSSL (TLS 1.3) per OpenSSL 1.1.1 o versioni successive. Sostituisce i criteri predefiniti di selezione della suite di cifratura per la cifratura basata su PSK.
TLSConnect	Come l'agent deve connettersi a Zabbix server o proxy.
TLSCRLFile	Il percorso completo di un file contenente i certificati revocati. Questo parametro viene usato per le comunicazioni cifrate tra i componenti di Zabbix.
TLSKeyFile	Il percorso completo di un file contenente la chiave privata dell'agent, usato per le comunicazioni cifrate tra i componenti di Zabbix.
TLSPSKFile	Il percorso completo di un file contenente la chiave precondivisa dell'agent, usato per le comunicazioni cifrate con Zabbix server.
TLSPSKIdentity	La stringa di identità della chiave precondivisa, usata per le comunicazioni cifrate con Zabbix server.
TLSServerCertIssuer	L'emittente consentito del certificato del server (proxy).
TLSServerCertSubject	Il soggetto consentito del certificato del server (proxy).
UnsafeUserParameters	Consente di passare tutti i caratteri negli argomenti dei parametri definiti dall'utente.
UserParameter	Un parametro definito dall'utente da monitorare.
UserParameterDir	Il percorso di ricerca predefinito per i comandi UserParameter.

Tutti i parametri sono facoltativi, salvo quando è esplicitamente indicato che il parametro è obbligatorio.

Nota:

I valori predefiniti riflettono i valori predefiniti del processo, non i valori nei file di configurazione distribuiti.
Zabbix supporta i file di configurazione solo in codifica UTF-8 senza BOM.
I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

Dettagli del parametro

Alias

Imposta un alias per una chiave item. Può essere usato per sostituire una chiave item lunga e complessa con una più breve e semplice.
Possono essere presenti più parametri Alias. Non sono consentiti più parametri con la stessa chiave Alias.
Chiavi Alias diverse possono fare riferimento alla stessa chiave item.
Gli alias possono essere usati in HostMetadataItem ma non nel parametro HostnameItem.

Esempio 1: Recupero dell'ID dell'utente 'zabbix'.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

Ora la chiave abbreviata zabbix.userid può essere usata per recuperare i dati.

Esempio 2: Ottenere l'utilizzo della CPU con parametri predefiniti e personalizzati.

Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]

Questo consente di usare la chiave cpu.util per ottenere la percentuale di utilizzo della CPU con parametri predefiniti, oltre a usare cpu.util[all, idle, avg15] per ottenere dati specifici sull'utilizzo della CPU.

Esempio 3: Esecuzione di più regole di low-level discovery che elaborano gli stessi elementi di discovery.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Ora è possibile configurare diverse regole di discovery usando vfs.fs.discovery con parametri diversi per ciascuna regola, ad esempio vfs.fs.discovery[foo], vfs.fs.discovery[bar], ecc.

AllowKey

Consente l'esecuzione di quegli item key che corrispondono a un pattern. Il pattern della key è un'espressione wildcard che supporta il carattere "*" per corrispondere a un numero qualsiasi di caratteri.
È possibile definire più regole di corrispondenza delle key in combinazione con DenyKey. I parametri vengono elaborati uno per uno in base all'ordine in cui compaiono. Vedi anche: Restricting agent checks.

BufferSend

L'intervallo di tempo in secondi che determina con quale frequenza i valori vengono inviati dal buffer al server Zabbix. Nota che, se il buffer è pieno, i dati verranno inviati prima.

Predefinito: 5
Intervallo: 1-3600

BufferSize

Il numero massimo di valori nel buffer di memoria. L'agent invierà tutti i dati raccolti al server Zabbix o al proxy se il buffer è pieno. Questo parametro deve essere usato solo se il buffer persistente è disabilitato (EnablePersistentBuffer=0).

Predefinito: 1000
Intervallo: 2-65535

ControlSocket

Il socket di controllo, usato per inviare comandi in fase di esecuzione con l'opzione '-R'.

Predefinito: /tmp/agent.sock

DebugLevel

Specifica il livello di debug:
0 - informazioni di base sull'avvio e l'arresto dei processi Zabbix
1 - informazioni critiche;
2 - informazioni sugli errori;
3 - avvisi;
4 - per il debug (produce molte informazioni);
5 - debug esteso (produce ancora più informazioni).

Predefinito: 3
Intervallo: 0-5

DenyKey

Nega l'esecuzione di quegli item key che corrispondono a un pattern. Il pattern della key è un'espressione wildcard che supporta il carattere "*" per corrispondere a un numero qualsiasi di caratteri.
È possibile definire più regole di corrispondenza delle key in combinazione con AllowKey. I parametri vengono elaborati uno per uno in base all'ordine in cui compaiono. Vedi anche: Restricting agent checks.

EnablePersistentBuffer

Abilita l'uso dell'archiviazione locale persistente per gli item attivi. Se l'archiviazione persistente è disabilitata, verrà utilizzato il buffer in memoria.

Predefinito: 0
Valori: 0 - disabilitato, 1 - abilitato

ForceActiveChecksOnStart

Esegue i controlli attivi immediatamente dopo il riavvio, alla prima configurazione ricevuta. Disponibile anche come parametro di configurazione per singolo plugin, ad esempio: Plugins.Uptime.System.ForceActiveChecksOnStart=1

Predefinito: 0
Valori: 0 - disabilitato, 1 - abilitato

HeartbeatFrequency

La frequenza dei messaggi di heartbeat in secondi. Utilizzata per monitorare la disponibilità dei controlli attivi.
0 - messaggi di heartbeat disabilitati.

Predefinito: 60
Intervallo: 0-3600

HostInterface

Un parametro opzionale che definisce l'interfaccia dell'host (indirizzo IP o nome DNS) utilizzata durante il processo di autoregistrazione dell'host. Questo valore verrà usato per popolare l'interfaccia nel nuovo host creato e consente di configurare esplicitamente un indirizzo IP o DNS. Per ulteriori dettagli, vedere Using DNS as default interface.

Se non definito, il valore verrà acquisito da HostInterfaceItem.

L'agent segnalerà un errore e non si avvierà se il valore supera il limite di 255 caratteri.

Intervallo: 0-255 caratteri

HostInterfaceItem

Un parametro opzionale che definisce un item utilizzato per determinare l'interfaccia dell'host (indirizzo IP o nome DNS) durante il processo di autoregistrazione dell'host. Questo valore viene usato solo se HostInterface non è definito. Per ulteriori dettagli, vedere Using DNS as default interface.

Durante una richiesta di autoregistrazione, l'agent registrerà un messaggio di avviso se il valore restituito dall'item specificato supera il limite di 255 caratteri.

L'item system.run[] è supportato indipendentemente dalle impostazioni AllowKey/DenyKey.

HostMetadata

Un parametro opzionale che definisce i metadati utilizzati per identificare o distinguere l'host durante il processo di autoregistrazione dell'host. HostMetadata consente di distinguere gli host oltre il nome host.

Se non definito, il valore verrà acquisito da HostMetadataItem.

L'agent segnalerà un errore e non si avvierà se il valore specificato supera il limite di 2034 byte o se si tratta di una stringa non UTF-8. Quando un parametro si aspetta un indirizzo IP o un nome DNS, anche i valori validi UTF-8 ma non validi come IP o nomi DNS verranno rifiutati e segnalati come non validi.

I metadati su più righe non sono supportati: l'output verrà troncato alla prima interruzione di riga.

Intervallo: 0-2034 byte

HostMetadataItem

Un parametro opzionale che definisce un item di Zabbix agent utilizzato per ottenere i metadati dell'host. Questa opzione viene utilizzata solo quando HostMetadata non è definito.

Il valore di HostMetadataItem viene recuperato a ogni tentativo di autoregistrazione e viene usato solo nel processo di autoregistrazione dell'host. HostMetadataItem consente di distinguere gli host oltre il nome host.

Sono supportati i parametri utente e gli alias. L'item system.run[] è supportato indipendentemente dalle impostazioni AllowKey/DenyKey.

Durante una richiesta di autoregistrazione, il agent registrerà un messaggio di avviso se il valore restituito dall'item specificato supera il limite di 65535 code point UTF-8. Il valore restituito dall'item deve essere una stringa UTF-8, altrimenti verrà ignorato. Quando un parametro si aspetta un indirizzo IP o un nome DNS, anche i valori validi UTF-8 ma non validi come IP o nomi DNS verranno rifiutati e segnalati come non validi.

I metadati su più righe non sono supportati: l'output verrà troncato al primo ritorno a capo.

Nome host

Un elenco di nomi host univoci, sensibili alle maiuscole/minuscole, separati da virgole. Richiesto per i controlli attivi e deve corrispondere ai nomi host configurati sul server. Il valore viene acquisito da HostnameItem se non definito.
Caratteri consentiti: alfanumerici, '.', ' ', '_' e '-'. Lunghezza massima: 128 caratteri per nome host, 2048 caratteri per l'intera riga.

Predefinito: impostato da HostnameItem

HostnameItem

Un parametro opzionale che definisce un item utilizzato per ottenere il nome dell'host. Questa opzione viene usata solo quando Hostname non è definito. I parametri utente o gli alias non sono supportati, ma l'item system.run[] è supportato indipendentemente dai valori di AllowKey/DenyKey.

Predefinito: system.hostname

Includi

Puoi includere singoli file o tutti i file in una directory nel file di configurazione. Durante l'installazione Zabbix creerà la directory include in /usr/local/etc, a meno che non venga modificata in fase di compilazione. Il percorso può essere relativo alla posizione del file zabbix_agent2.conf.
Per includere solo i file pertinenti nella directory specificata, è supportato il carattere jolly asterisco per la corrispondenza dei pattern.
Vedi note speciali sulle limitazioni.

Esempio:

Include=/absolute/path/to/config/files/*.conf

ListenIP

Un elenco di indirizzi IP separati da virgole su cui l'agent deve mettersi in ascolto. Il primo indirizzo IP viene inviato al server Zabbix, se ci si connette ad esso, per recuperare l'elenco dei controlli attivi.

Predefinito: 0.0.0.0

ListenPort

L'agent ascolterà su questa porta le connessioni provenienti dal server.

Predefinito: 10050
Intervallo: 1024-32767

LogFile

Il nome del file di log.

Predefinito: /tmp/zabbix_agent2.log
Obbligatorio: Sì, se LogType è impostato su file; altrimenti no

LogFileSize

La dimensione massima di un file di log in MB.
0 - disabilita la rotazione automatica dei log.
Nota: Se viene raggiunto il limite di dimensione del file di log e la rotazione del file non riesce, per qualsiasi motivo, il file di log esistente viene troncato e ricreato da zero.

Predefinito: 1
Intervallo: 0-1024

LogType

Il tipo di output del log:
file - scrive il log nel file specificato dal parametro LogFile;
system - scrive il log in syslog;
console - scrive il log nell'output standard

Predefinito: file

PersistentBufferFile

Il file in cui Zabbix agent 2 deve conservare il database SQLite. Deve essere un nome file completo. Questo parametro viene utilizzato solo se il buffer persistente è abilitato (EnablePersistentBuffer=1).

PersistentBufferPeriod

Il periodo di tempo per cui i dati devono essere memorizzati quando non c'è connessione al server o al proxy. I dati più vecchi andranno persi. I dati di log verranno conservati. Questo parametro viene utilizzato solo se il buffer persistente è abilitato (EnablePersistentBuffer=1).

Predefinito: 1h
Intervallo: 1m-365d

PidFile

Il nome del file PID.

Predefinito: /tmp/zabbix_agent2.pid

Plugins.<PluginName>.System.Capacity

Il limite di controlli per il plugin <PluginName> che possono essere eseguiti contemporaneamente.

Predefinito: 1000 Intervallo: 1-1000

Plugins.Log.MaxLinesPerSecond

Il numero massimo di nuove righe che l'agent invierà al secondo a Zabbix server o proxy durante l'elaborazione dei controlli attivi 'log' e 'logrt'. Il valore fornito verrà sovrascritto dal parametro 'maxlines', specificato nella chiave dell'item 'log' e 'logrt'.
Nota: Zabbix elaborerà 10 volte più nuove righe rispetto a quelle impostate in MaxLinesPerSecond per cercare la stringa richiesta negli item di log.

Predefinito: 20
Intervallo: 1-1000

Plugins.SystemRun.LogRemoteCommands

Abilita la registrazione dei comandi shell eseguiti come avvisi. I comandi verranno registrati solo se eseguiti in remoto. Le voci di log non verranno create se system.run[] viene avviato localmente dai parametri HostMetadataItem, HostInterfaceItem o HostnameItem.

Predefinito: 0
Valori: 0 - disabilitato, 1 - abilitato

PluginSocket

Il percorso del socket UNIX per le comunicazioni dei plugin caricabili.

Predefinito: /tmp/agent.plugin.sock

PluginTimeout

Il timeout per le connessioni con i plugin caricabili, in secondi.

Predefinito: Timeout
Intervallo: 1-30

RefreshActiveChecks

Con quale frequenza viene aggiornato l'elenco dei controlli attivi, in secondi. Si noti che, dopo un tentativo fallito di aggiornamento dei controlli attivi, il successivo aggiornamento verrà tentato dopo 60 secondi.

Predefinito: 5
Intervallo: 1-86400

Server

Un elenco di indirizzi IP separati da virgole, facoltativamente in notazione CIDR, oppure nomi DNS di server Zabbix o proxy Zabbix. Le connessioni in ingresso saranno accettate solo dagli host elencati qui. Se il supporto IPv6 è abilitato, allora '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' sono trattati allo stesso modo e '::/0' consentirà qualsiasi indirizzo IPv4 o IPv6. '0.0.0.0/0' può essere usato per consentire qualsiasi indirizzo IPv4. Sono consentiti gli spazi. Se questo parametro non è specificato, i controlli passivi vengono disabilitati e l'agent non ascolterà su alcuna porta TCP.

Esempio:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

ServerActive

L'indirizzo del server/proxy Zabbix o la configurazione del cluster da cui ottenere i controlli attivi. L'indirizzo del server/proxy è un indirizzo IP o un nome DNS, con una porta opzionale separata da due punti.
La configurazione del cluster è uno o più indirizzi dei membri del gruppo di server o proxy separati da punto e virgola. È possibile specificare più server/cluster Zabbix e proxy Zabbix, separati da virgola. A meno che non si usino gruppi di proxy, non dovrebbe essere specificato più di un proxy Zabbix per ciascun server/cluster Zabbix. Se viene specificato un proxy Zabbix, allora non dovrebbe essere specificato il server/cluster Zabbix per quel proxy.
È possibile fornire più indirizzi delimitati da virgole per usare in parallelo più server Zabbix indipendenti. Gli spazi sono consentiti.
Se la porta non è specificata, viene usata la porta predefinita.
Gli indirizzi IPv6 devono essere racchiusi tra parentesi quadre se è specificata la porta per quell'host. Se la porta non è specificata, le parentesi quadre per gli indirizzi IPv6 sono facoltative.
Se questo parametro non è specificato, i controlli attivi sono disabilitati.

Esempio per proxy Zabbix:

ServerActive=127.0.0.1:10051

Esempio per gruppo di proxy Zabbix:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

Esempio per più server:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

Esempio per alta disponibilità:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

Esempio per alta disponibilità con due cluster e un server:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain

SourceIP

L'indirizzo IP sorgente per:

le connessioni in uscita verso Zabbix server o Zabbix proxy.
la creazione di connessioni durante l'esecuzione di alcuni item (web.page.get, net.tcp.port, ecc.).

StatusPort

Se impostato, l'agent ascolterà su questa porta le richieste HTTP di stato (http://localhost:<port>/status).

Intervallo: 1024-32767

Timeout

Specifica per quanto tempo attendere (in secondi) per stabilire la connessione e scambiare dati con Zabbix proxy o server.

Questo parametro definisce la durata di varie operazioni di comunicazione, tra cui:

attesa di una risposta dal server Zabbix;
invio di richieste al server Zabbix, incluse le richieste di configurazione degli item e i dati degli item nelle active checks;
recupero dei dati di log tramite logfile;
invio di messaggi heartbeat;
durata massima per i controlli vfs.*;
utilizzo come fallback negli scenari in cui un server o proxy precedente alla versione 7.0 invia controlli senza timeout.

Questo timeout non verrà utilizzato per quei controlli agent che dispongono di impostazioni di timeout configurabili nel frontend (a livello globale, di proxy o per singolo item).

Predefinito: 3
Intervallo: 1-30

TLSAccept

Le connessioni in ingresso da accettare. Usato per i controlli passivi. È possibile specificare più valori, separati da virgola:
unencrypted - accetta connessioni senza crittografia (predefinito)
psk - accetta connessioni con TLS e una chiave precondivisa (PSK)
cert - accetta connessioni con TLS e un certificato

Obbligatorio: sì, se sono definiti i parametri del certificato TLS o della PSK (anche per una connessione unencrypted); altrimenti no

TLSCAFile

Il percorso completo del file contenente i certificati della CA di livello superiore per la verifica del certificato del peer, utilizzato per le comunicazioni crittografate tra i componenti di Zabbix.

TLSCertFile

Il percorso completo del file contenente il certificato dell'agent o la catena di certificati, utilizzato per le comunicazioni crittografate con i componenti di Zabbix.

TLSCipherAll

La stringa di cifratura OpenSSL (TLS 1.2). Sostituisce i criteri di selezione della suite di cifratura predefinita per la crittografia basata su certificati e PSK.

Esempio:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128