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] [-g] -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] [-g] -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] [-g] -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] [-g] -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] [-g] -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-identity --tls-psk-file PSK-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 psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}

DESCRIZIONE

zabbix_sender è un'utilità della riga di comando per l'invio di dati di monitoraggio al server o proxy Zabbix. Sul server Zabbix un elemento di tipo Zabbix trapper deve essere creato con la chiave corrispondente. Nota che i valori in arrivo verranno accettati solo dagli host specificati nel campo Host consentiti per questo elemento. [ ]{#lbAE}

OPZIONI

-c, --config config-file
Usa config-file. Zabbix sender legge i dettagli del server dal file di configurazione di agentd. Per impostazione predefinita Zabbix sender non legge alcun file di configurazione. Sono supportati solo i parametri Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity e TLSPSKFile.
Il nome host definito tramite il parametro HostnameItem non verrà rilevato; in questo caso il nome host deve essere specificato tramite riga di comando (vedere l'opzione -s).
Tutti gli indirizzi definiti nel parametro di configurazione ServerActive dell'agent vengono utilizzati per l'invio dei dati. Se l'invio di dati in batch a un indirizzo non riesce, i batch successivi non vengono inviati a questo indirizzo.

-z, --zabbix-server server
Nome host o indirizzo IP del server Zabbix. Se un host è monitorato da un proxy, deve essere usato invece il nome host o l'indirizzo IP del proxy. Se usato insieme a --config, sovrascrive le voci del parametro ServerActive specificate nel file di configurazione di agentd.

-p, --port port
Specifica il numero di porta del trapper del server Zabbix in esecuzione sul server. Il valore predefinito è 10051. Se usato insieme a --config, sovrascrive le voci di porta del parametro ServerActive specificate nel file di configurazione di agentd.

-I, --source-address IP-address
Specifica l'indirizzo IP sorgente. Se usato insieme a --config, sovrascrive il parametro SourceIP specificato nel file di configurazione di agentd.

-t, --timeout seconds
Specifica il timeout. Intervallo valido: 1-300 secondi (predefinito: 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 funzionano. Se usato insieme a --config, sovrascrive il parametro Hostname specificato nel file di configurazione di agentd.

-k, --key key
Specifica la chiave dell'item a cui inviare il valore.

-o, --value value
Specifica il valore dell'item.

-i, --input-file input-file
Carica i valori da un file di input. Specificare - come <input-file> per leggere i valori dallo standard input. Ogni riga del file contiene voci delimitate da spazi: <hostname> <key> <value>. Ogni valore deve essere specificato sulla propria riga. Ogni riga deve contenere 3 voci delimitate da spazi: <hostname> <key> <value>, dove "hostname" è il nome dell'host monitorato come registrato nel frontend di Zabbix, "key" è la chiave dell'item di destinazione e "value" è il valore da inviare. Specificare - come <hostname> per usare il nome host dal file di configurazione dell'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 configurazione dell'item nel frontend di Zabbix. Zabbix sender invierà fino a 250 valori in una connessione. Il limite di dimensione per l'invio di valori da un file di input dipende dalla dimensione descritta nel protocollo di comunicazione di Zabbix. Il contenuto del file 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 secondo le seguenti regole:

Sono supportate voci tra virgolette e non tra virgolette.
Il carattere di quoting è il doppio apice.
Le voci con spazi devono essere racchiuse tra virgolette.
I caratteri doppio apice e backslash all'interno di una voce tra virgolette devono essere preceduti da un backslash.
L'escaping non è supportato nelle voci non tra virgolette.
Le sequenze di escape di avanzamento riga (\n) sono supportate nelle stringhe tra virgolette.
Le sequenze di escape di avanzamento riga vengono rimosse 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: <hostname> <key> <timestamp> <value>. Il timestamp deve essere specificato nel formato timestamp Unix. Se l'item di destinazione ha trigger che vi fanno riferimento, tutti i timestamp devono essere in ordine crescente, altrimenti il calcolo degli eventi non sarà corretto.

Un esempio di riga del file di input:

"Linux DB3" db.connections 1429533600 43

Per maggiori dettagli vedere l'opzione --input-file.

Se un valore con timestamp viene inviato per un host che si trova in una manutenzione di tipo “no data”, questo valore verrà scartato; tuttavia, è possibile inviare un valore con timestamp per un periodo di manutenzione scaduto e verrà accettato.

-N, --with-ns
Questa opzione può essere usata solo con l'opzione --with-timestamps.

Ogni riga del file di input deve contenere 5 voci delimitate da spazi: <hostname> <key> <timestamp> <ns> <value>.

Un esempio di riga del 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.

-g, --group
Raggruppa i valori per host e li invia a ciascun host in un batch separato.

--tls-connect value
Come connettersi al server o al proxy. Valori:

[ ]{#lbAF}

non crittografato
connessione senza crittografia (predefinito)

<!-- -->

psk
connessione tramite TLS e una chiave precondivisa

<!-- -->

cert
connessione tramite TLS e un certificato

<!-- -->

--tls-ca-file CA-file
Percorso completo di un file contenente i certificati della CA o delle CA di livello superiore per la verifica del certificato del peer.

--tls-crl-file CRL-file
Percorso completo di un file contenente i certificati revocati.

--tls-server-cert-issuer cert-issuer
Emittente consentito del certificato del server.

--tls-server-cert-subject cert-subject
Soggetto consentito del certificato del server.

--tls-cert-file cert-file
Percorso completo di un file contenente il certificato o la catena 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 versione di OpenSSL è inferiore alla 1.1.1.

--tls-cipher cipher-string
Stringa di priorità GnuTLS (per TLS 1.2 e versioni successive) 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.

[ ]{#lbAG}

STATO DI USCITA

Lo stato di uscita è 0 se i valori sono stati inviati e sono stati elaborati tutti con successo dal server. Se i dati sono stati inviati, ma l'elaborazione di almeno uno dei valori non è riuscito, lo stato di uscita è 2. Se l'invio dei dati è fallito, lo stato di uscita è 1.

[ ]{#lbAH}

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 del host monitorato. Usa il host monitorato e il server Zabbix definiti nel file di configurazione dell'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 del host Monitored Host usando il server Zabbix definito nel file di configurazione dell'agent.

zabbix_sender -z 192.168.1.113 -i data_values.txt

Invia i valori dal file data_values.txt al server Zabbix con IP 192.168.1.113. I nomi host e le chiavi 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 al server Zabbix, specificato nel file di configurazione dell'agent. Il trattino nei dati di input indica che anche il nome host deve essere usato 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 al server Zabbix con indirizzo IP 192.168.1.113 sulla porta 10000 dalla riga di comando. I valori 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 nel host Monitored Host al server con IP 192.168.1.113 usando TLS con certificato.

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 nel host Monitored Host al server con IP 192.168.1.113 usando TLS con chiave precondivisa (PSK).

[ ]{#lbAI}