On this page
zabbix_sender
ZABBIX_SENDER(1) Manuale generale dei comandi ZABBIX_SENDER(1)
NOME
zabbix_sender - utilità sender di Zabbix
SINOSSI
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file]
[--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject
cert-subject] --tls-cert-file cert-file --tls-key-file key-file
[--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o
value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file
CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k
key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string]
[-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender -h
zabbix_sender -V
DESCRIZIONE
zabbix_sender è un'utilità da riga di comando per inviare dati di moni‐
toraggio a Zabbix server o proxy. Sullo Zabbix server deve essere cre‐
ato un item di tipo Zabbix trapper con la key corrispondente. Si noti
che i valori in ingresso saranno accettati solo dagli host specificati
nel campo Allowed hosts per questo item.
OPZIONI
-c, --config config-file
Usa config-file. zabbix_sender legge i dettagli del server dal
file di configurazione agentd. Per impostazione predefinita
zabbix_sender non legge alcun file di configurazione. Sono sup‐
portati solo i parametri Hostname, ServerActive, SourceIP,
TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer,
TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity e
TLSPSKFile. Il valore Hostname definito tramite il parametro
HostnameItem non verrà rilevato; in questo caso il nome host
deve essere specificato tramite riga di comando (vedere l'op‐
zione -s). Tutti gli indirizzi definiti nel parametro di confi‐
gurazione agent ServerActive vengono usati per l'invio dei dati.
Se l'invio di dati in batch a un indirizzo fallisce, i batch
successivi non vengono inviati a tale indirizzo.
-z, --zabbix-server server
Nome host o indirizzo IP di Zabbix server. Se un host è monito‐
rato da un proxy, deve essere usato invece il nome host o l'in‐
dirizzo IP del proxy. Se usata insieme a --config, sovrascrive
le voci del parametro ServerActive specificate nel file di con‐
figurazione agentd.
-p, --port port
Specifica il numero di porta del trapper di Zabbix server in
esecuzione sul server. Il valore predefinito è 10051. Se usata
insieme a --config, sovrascrive le voci di porta del parametro
ServerActive specificate nel file di configurazione agentd.
-I, --source-address IP-address
Specifica l'indirizzo IP sorgente. Se usata insieme a --config,
sovrascrive il parametro SourceIP specificato nel file di confi‐
gurazione agentd.
-t, --timeout seconds
Specifica il timeout. Intervallo valido: 1-300 secondi (predefi‐
nito: 60)
-s, --host host
Specifica il nome host a cui appartiene l'item (come registrato
nel frontend di Zabbix). L'indirizzo IP e il nome DNS dell'host
non funzioneranno. Se usata insieme a --config, sovrascrive il
parametro Hostname specificato nel file di configurazione
agentd.
-k, --key key
Specifica la key dell'item a cui inviare il valore.
-o, --value value
Specifica il valore dell'item.
-i, --input-file input-file
Carica i valori dal file di input. Specificare - come <input-fi‐
le> per leggere i valori dallo standard input. Ogni riga del fi‐
le contiene, delimitati da spazi bianchi: <hostname> <key> <va‐
lue>. Ogni valore deve essere specificato sulla propria riga.
Ogni riga deve contenere 3 voci delimitate da spazi bianchi:
<hostname> <key> <value>, dove "hostname" è il nome dell'host
monitorato come registrato nel frontend di Zabbix, "key" è la
key dell'item di destinazione e "value" è il valore da inviare.
Specificare - come <hostname> per usare il nome host dal file di
configurazione agent o dall'argomento --host.
Un esempio di riga di un file di input:
"Linux DB3" db.connections 43
Il tipo di valore deve essere impostato correttamente nella con‐
figurazione dell'item nel frontend di Zabbix. zabbix_sender in‐
vierà fino a 250 valori in una connessione. Il contenuto del fi‐
le di input deve essere in codifica UTF-8. Tutti i valori del
file di input vengono inviati in ordine sequenziale dall'alto
verso il basso. Le voci devono essere formattate usando le se‐
guenti regole:
• Sono supportate voci tra virgolette e non tra virgolet‐
te.
• Il carattere di quoting è il doppio apice.
• Le voci contenenti spazi bianchi devono essere racchiu‐
se tra virgolette.
• I caratteri doppio apice e backslash all'interno di una
voce tra virgolette devono essere preceduti da un back‐
slash.
• L'escaping non è supportato nelle voci non tra virgolet‐
te.
• Le sequenze di escape di avanzamento riga (\n) sono sup‐
portate nelle stringhe tra virgolette.
• Le sequenze di escape di avanzamento riga vengono rimos‐
se dalla fine di una voce.
-T, --with-timestamps
Questa opzione può essere usata solo con l'opzione --input-file.
Ogni riga del file di input deve contenere 4 voci delimitate da
spazi bianchi: <hostname> <key> <timestamp> <value>. Il times‐
tamp deve essere specificato nel formato timestamp Unix. Se
l'item di destinazione ha trigger che vi fanno riferimento, tut‐
ti i timestamp devono essere in ordine crescente, altrimenti il
calcolo degli eventi non sarà corretto.
Un esempio di riga di un file di input:
"Linux DB3" db.connections 1429533600 43
Per maggiori dettagli vedere l'opzione --input-file.
Se viene inviato un valore con timestamp per un host che si tro‐
va in una manutenzione di tipo “no data”, questo valore verrà
scartato; tuttavia, è possibile inviare un valore con timestamp
relativo a un periodo di manutenzione scaduto e verrà accettato.
-N, --with-ns
Questa opzione può essere usata solo con l'opzione --with-times‐
tamps.
Ogni riga del file di input deve contenere 5 voci delimitate da
spazi bianchi: <hostname> <key> <timestamp> <ns> <value>.
Un esempio di riga di un file di input:
"Linux DB3" db.connections 1429533600 7402561 43
Per maggiori dettagli vedere l'opzione --input-file.
-r, --real-time
Invia i valori uno per uno non appena vengono ricevuti. Questo
può essere usato durante la lettura dallo standard input.
--tls-connect value
Modalità di connessione al server o proxy. Valori:
unencrypted
connessione senza crittografia (predefinita)
psk connessione tramite TLS e una chiave precondivi‐
sa
cert connessione tramite TLS e un certificato
--tls-ca-file CA-file
Percorso completo di un file contenente i certificati della CA
di livello superiore per la verifica del certificato del peer.
--tls-crl-file CRL-file
Percorso completo di un file contenente certificati revocati.
--tls-server-cert-issuer cert-issuer
Emittente del certificato del server consentito.
--tls-server-cert-subject cert-subject
Soggetto del certificato del server consentito.
--tls-cert-file cert-file
Percorso completo di un file contenente il certificato o la ca‐
tena di certificati.
--tls-key-file key-file
Percorso completo di un file contenente la chiave privata.
--tls-psk-identity PSK-identity
Stringa di identità PSK.
--tls-psk-file PSK-file
Percorso completo di un file contenente la chiave precondivisa.
--tls-cipher13 cipher-string
Stringa di cifratura per OpenSSL 1.1.1 o versioni successive per
TLS 1.3. Sovrascrive i criteri predefiniti di selezione della
suite di cifratura. Questa opzione non è disponibile se la ver‐
sione di OpenSSL è inferiore a 1.1.1.
--tls-cipher cipher-string
Stringa di priorità GnuTLS (per TLS 1.2 e superiori) o stringa
di cifratura OpenSSL (solo per TLS 1.2). Sovrascrive i criteri
predefiniti di selezione della suite di cifratura.
-v, --verbose
Modalità dettagliata, -vv per maggiori dettagli.
-h, --help
Visualizza questo aiuto ed esce.
-V, --version
Mostra le informazioni sulla versione ed esce.
STATO DI USCITA
Lo stato di uscita è 0 se i valori sono stati inviati e tutti sono
stati elaborati correttamente dal server. Se i dati sono stati inviati,
ma l'elaborazione di almeno uno dei valori non è riuscita, lo stato di
uscita è 2. Se l'invio dei dati non è riuscito, lo stato di uscita è 1.
ESEMPI
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o
342.45
Invia 342.45 come valore per l'item mysql.queries dell'host mo‐
nitorato. Usa l'host monitorato e Zabbix server definiti nel fi‐
le di configurazione agent.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
Invia 342.45 come valore per l'item mysql.queries dell'host Mo‐
nitored Host usando Zabbix server definito nel file di configu‐
razione agent.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Invia i valori dal file data_values.txt a Zabbix server con IP
192.168.1.113. I nomi host e le key sono definiti nel file.
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -
Invia un valore con timestamp dalla riga di comando a Zabbix
server, specificato nel file di configurazione agent. Il tratto
nei dati di input indica che anche il nome host deve essere usa‐
to dallo stesso file di configurazione.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Invia un valore vuoto di un item a Zabbix server con indirizzo
IP 192.168.1.113 sulla porta 10000 dalla riga di comando. I va‐
lori vuoti devono essere indicati con doppi apici vuoti.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o
342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file
--tls-cert-file /home/zabbix/zabbix_agentd.crt --tls-key-file
/home/zabbix/zabbix_agentd.key
Invia 342.45 come valore per l'item mysql.queries nell'host Mo‐
nitored Host al server con IP 192.168.1.113 usando TLS con cer‐
tificato.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o
342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd"
--tls-psk-file /home/zabbix/zabbix_agentd.psk
Invia 342.45 come valore per l'item mysql.queries nell'host Mo‐
nitored Host al server con IP 192.168.1.113 usando TLS con chia‐
ve precondivisa (PSK).
VEDERE ANCHE
Documentazione
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8),
zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
Zabbix 2022-01-06 ZABBIX_SENDER(1)