Parametri di configurazione: Zabbix agent (Windows)

Panoramica

I parametri di configurazione consentono di personalizzare il comportamento di Zabbix agent su Windows.

Specifica i valori dei parametri nel file di configurazione (zabbix_agentd.win.conf). Tutti i parametri sono opzionali, a meno che non sia esplicitamente indicato che il parametro è obbligatorio.

Questa pagina è strutturata come segue:

• Panoramica dei parametri (per vedere i dettagli completi di un parametro, fai clic sul suo nome)
• Dettagli dei parametri

Nota che:

• I valori predefiniti riflettono i valori predefiniti del daemon, non i valori nei file di configurazione distribuiti.
• I valori supportano variabili di ambiente.
• 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 di item. Può essere usato per sostituire una chiave di 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 di item.
Gli alias possono essere usati in HostMetadataItem ma non in HostnameItem o nel parametro PerfCounter.

Esempio 1: Recupero dell'utilizzo del file di paging in percentuale dal server.

Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

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

Esempio 2: Ottenere il carico della CPU con parametri predefiniti e personalizzati.

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

Questo consente di usare la chiave cpu.load per ottenere il carico della CPU con parametri predefiniti, oltre a usare cpu.load[percpu,avg15] per ottenere dati specifici sul carico 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

Imposta la frequenza di invio dei valori dal buffer a Zabbix server/proxy (in secondi).

Predefinito: 5
Intervallo: 1-3600

BufferSize

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

Predefinito: 100
Intervallo: 2-65535

DebugLevel

Imposta il livello di debug:
0 - informazioni di base sull'avvio e l'arresto dei processi di 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 chiave è un'espressione wildcard che supporta il carattere "*" per corrispondere a un numero qualsiasi di caratteri.
È possibile definire più regole di corrispondenza delle chiavi in combinazione con AllowKey. I parametri vengono elaborati uno per uno in base all'ordine in cui compaiono. Vedi anche: Restricting agent checks.

EnableRemoteCommands

Consenti i comandi remoti dal server Zabbix.
Questo parametro è deprecato; usa invece AllowKey=system.run[*] oppure DenyKey=system.run[*].
È un alias interno per i parametri AllowKey/DenyKey a seconda del valore:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

Predefinito: 0
Valori: 0 - non consentire, 1 - consentire

HeartbeatFrequency

Imposta la frequenza dei messaggi heartbeat in secondi. Usato per monitorare la disponibilità dei controlli attivi.
0 - messaggi heartbeat disabilitati.

Predefinito: 60
Intervallo: 0-3600

HostInterface

Specificare l'interfaccia dell'host (indirizzo IP o nome DNS) utilizzata durante l'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

Specifica un item per determinare l'interfaccia dell'host (indirizzo IP o nome DNS) durante l'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

Specifica i metadati utilizzati per identificare o distinguere l'host durante l'autoregistrazione dell'host (active agent). 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, verranno rifiutati e segnalati come non validi anche i valori che sono UTF-8 validi ma non sono IP o nomi DNS validi.

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

Intervallo: 0-2034 byte

HostMetadataItem

Specifica un item di Zabbix agent per ottenere i metadati dell'host. Questa opzione viene usata solo quando HostMetadata non è definito.

Il valore di HostMetadataItem viene recuperato a ogni tentativo di autoregistrazione ed è usato solo nel processo di autoregistrazione dell'host (agent attivo). HostMetadataItem consente di distinguere gli host oltre il nome host.

Sono supportati parametri utente, contatori di prestazioni e alias. L'item system.run[] è supportato indipendentemente dalle impostazioni AllowKey/DenyKey.

Durante una richiesta di autoregistrazione, l'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

Specifica hostname univoci e sensibili alle maiuscole/minuscole. Un elenco delimitato da virgole.
Obbligatorio per i controlli attivi e deve corrispondere agli hostname configurati sul server. Il valore viene acquisito da HostnameItem se non definito.
Caratteri consentiti: alfanumerici, '.', ' ', '_' e '-'. Lunghezza massima: 128 caratteri per hostname, 2048 caratteri per l'intera riga.

Predefinito: impostato da HostnameItem

HostnameItem

Specifica un item dell'agent Zabbix per ottenere il nome host.
Questa opzione viene utilizzata solo quando Hostname non è definito.
I parametri utente, i contatori di prestazioni o gli alias non sono supportati, ma l'item system.run[] è supportato indipendentemente dai valori di AllowKey/DenyKey.
Vedi anche una descrizione più dettagliata.

Predefinito: system.hostname

Include

Specifica una directory o singoli file da includere nel file di configurazione (situato in C:\Program Files\Zabbix Agent per impostazione predefinita se Zabbix agent è installato tramite i pacchetti di installazione MSI per Windows; situato nella cartella specificata durante l'installazione se Zabbix agent è installato come archivio zip). Tutti i file inclusi devono avere una sintassi corretta, altrimenti agent non si avvierà.
Per includere solo i file pertinenti nella directory specificata, è supportato il carattere jolly asterisco per la corrispondenza dei pattern.
Vedere le note speciali sulle limitazioni.

Esempio:

Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf

ListenBacklog

Imposta il numero massimo di connessioni in sospeso nella coda TCP.
Il valore predefinito è una costante codificata, che dipende dal sistema.
Anche il valore massimo supportato dipende dal sistema; valori troppo elevati possono essere troncati silenziosamente al "massimo specificato dall'implementazione".

Predefinito: SOMAXCONN
Intervallo: 0 - INT_MAX

ListenIP

Specifica l'indirizzo IP di ascolto dell'agent per le connessioni dal server/proxy. Elenco delimitato da virgole.

Predefinito: 0.0.0.0

ListenPort

Specifica la porta di ascolto dell'agent per le connessioni dal server/proxy.

Predefinito: 10050
Intervallo: 1024-32767

LogFile

Specifica il file di log dell'agent.

Predefinito: c:\zabbix_agentd.log
Obbligatorio: Sì, se LogType è impostato su file; altrimenti no

LogFileSize

Imposta la dimensione massima del file di log (in MB).
0 - disabilita la rotazione automatica del 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

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

LogType

Specifica il tipo di output del log:
file - scrive il log nel file specificato dal parametro LogFile;
system - scrive il log nel Windows Event Log;
console - scrive il log nell'output standard.

Predefinito: file

MaxLinesPerSecond

Imposta il numero massimo di nuove righe al secondo da inviare a Zabbix server/proxy durante l'elaborazione dei controlli attivi log, logrt o eventlog.
Il valore fornito verrà sovrascritto dal parametro 'maxlines', specificato nella chiave dell'item 'log', 'logrt' o 'eventlog'.
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

PerfCounter

Definisce un nuovo parametro <parameter_name> che è il valore medio del contatore di prestazioni di sistema <perf_counter_path> per il periodo di tempo specificato <period> (in secondi).
Sintassi: <parameter_name>,"<perf_counter_path>",<period>

Ad esempio, se si desidera ricevere il numero medio di interrupt del processore al secondo per l'ultimo minuto, è possibile definire un nuovo parametro "interrupts" come segue:

PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60

Si noti l'uso delle virgolette doppie attorno al percorso del contatore di prestazioni. Il nome del parametro (interrupts) deve essere usato come chiave dell'item quando si crea un item. I campioni per il calcolo del valore medio verranno raccolti ogni secondo.
È possibile eseguire "typeperf -qx" per ottenere l'elenco di tutti i contatori di prestazioni disponibili in Windows.

PerfCounterEn

Definisce un nuovo parametro <parameter_name> che è il valore medio del contatore delle prestazioni di sistema <perf_counter_path> per il periodo di tempo specificato <period> (in secondi). Rispetto a PerfCounter, i percorsi dei perfcounter devono essere in inglese. Supportato solo su Windows Server 2008/Vista e versioni successive.
Sintassi: <parameter_name>,"<perf_counter_path>",<period>

Ad esempio, se si desidera ricevere il numero medio di interrupt del processore al secondo per l'ultimo minuto, è possibile definire un nuovo parametro "interrupts" come segue:

PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60

Si noti l'uso delle virgolette doppie attorno al percorso del contatore delle prestazioni. Il nome del parametro (interrupts) deve essere usato come chiave dell'item quando si crea un item. I campioni utilizzati per calcolare il valore medio verranno raccolti ogni secondo.
È possibile trovare l'elenco delle stringhe in inglese visualizzando la seguente chiave del registro: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

RefreshActiveChecks

Specifica la frequenza di aggiornamento dell'elenco dei controlli attivi, in secondi.
Nota che, dopo un tentativo fallito di aggiornamento dei controlli attivi, il successivo aggiornamento verrà tentato dopo 60 secondi.

Predefinito: 5
Intervallo: 1-86400

Server

Specifica gli indirizzi IP, opzionalmente in notazione CIDR, oppure i nomi DNS dei server/proxy Zabbix. Un elenco delimitato da virgole.
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. Si noti che gli "indirizzi IPv6 compatibili con IPv4" (prefisso 0000::/96) sono supportati ma deprecati da RFC4291. Sono consentiti gli spazi.

Esempio:

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

Obbligatorio: sì, se StartAgents non è impostato esplicitamente a 0

ServerActive

Specifica 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 è costituita da 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 si dovrebbe specificare più di un proxy Zabbix per ciascun server/cluster Zabbix. Se è specificato un proxy Zabbix, allora il server/cluster Zabbix per quel proxy non deve essere specificato.
È possibile fornire più indirizzi separati da virgola per usare più server Zabbix indipendenti in parallelo. Sono consentiti gli spazi.
Se la porta non è specificata, viene usata la porta predefinita.
Gli indirizzi IPv6 devono essere racchiusi tra parentesi quadre se per quell'host è specificata una porta. 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

Intervallo: Il numero di server attivi elencati in ServerActive più il numero di istanze pre-fork per i controlli passivi specificate in StartAgents deve essere inferiore a 64.

SourceIP

Specificare 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.).

StartAgents

Imposta il numero di istanze pre-forked di zabbix_agentd per l'elaborazione dei controlli passivi.
Se impostato a 0, i controlli passivi sono disabilitati e l'agent non ascolterà su alcuna porta TCP.

Predefinito: 10
Intervallo: 0-100 (*)

Timeout

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

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 il monitoraggio di logfile o del registro eventi di Windows;
• invio di messaggi heartbeat;
• durata massima per i controlli vfs.*;
• utilizzo da parte dei moduli dell'agent Zabbix;
• funzione di fallback negli scenari in cui un server o un proxy di versione precedente alla 7.0 invia controlli senza timeout.

Questo timeout non verrà utilizzato per quei controlli dell'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

Specifica il livello di crittografia richiesto per le connessioni in ingresso.
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 parametri del certificato TLS o della PSK (anche per una connessione unencrypted); altrimenti no

TLSCAFile

Specifica 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

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

TLSConnect

Specifica il livello di crittografia richiesto per le connessioni dell'agent a Zabbix server o proxy.
Usato per i controlli attivi.
Può essere specificato un solo valore:
unencrypted - connessione senza crittografia (predefinito)
psk - connessione tramite TLS e una chiave precondivisa (PSK)
cert - connessione tramite TLS e un certificato

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

TLSCRLFile

Specifica il percorso completo del file contenente i certificati revocati. Questo parametro viene utilizzato per le comunicazioni crittografate tra i componenti di Zabbix.

TLSKeyFile

Specificare il percorso completo del file contenente la chiave privata dell'agent, utilizzata per le comunicazioni crittografate tra i componenti di Zabbix.

TLSPSKFile

Specifica il percorso completo del file contenente la chiave pre-condivisa dell'agent, utilizzata per le comunicazioni crittografate con il server Zabbix.

TLSPSKIdentity

Specifica la stringa di identità della chiave pre-condivisa, utilizzata per le comunicazioni crittografate con il server Zabbix.

TLSServerCertIssuer

Specifica l'emittente del certificato del server (proxy) consentito.

TLSServerCertSubject

Specifica il subject del certificato del server (proxy) consentito.

UnsafeUserParameters

Consente di passare tutti i caratteri negli argomenti dei parametri definiti dall'utente. I seguenti caratteri non sono consentiti: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @ %
Inoltre, i caratteri di nuova riga non sono consentiti.

Predefinito: 0
Valori: 0 - non consentire, 1 - consentire

UserParameter

Specifica un parametro definito dall'utente da monitorare. Possono esserci diversi parametri definiti dall'utente.
Formato: UserParameter=<key>,<shell command>
Nota che il comando shell non deve restituire una stringa vuota o solo EOL. I comandi shell possono avere percorsi relativi, se è specificato il parametro UserParameterDir.

Esempio:

UserParameter=system.test,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat

UserParameterDir

Specifica il percorso di ricerca predefinito per i comandi UserParameter. Se utilizzato, l'agent cambierà la propria directory di lavoro in quella specificata qui prima di eseguire un comando. In questo modo, i comandi UserParameter possono avere un prefisso relativo ./ invece di un percorso completo. È consentita una sola voce.

Esempio:

UserParameterDir=C:\opt\myscripts