Table of Contents

zabbix_sender

zabbix_sender

Sezione: Comandi Utente (1)
Aggiornato: 2021-06-01
Indice Torna al contenuto principale

NOME

zabbix_sender - Utilità Zabbix sender

SYNOPSIS

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] -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-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] -i input-file
zabbix_sender -h
zabbix_sender -V

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.

##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. Tutti gli indirizzi definiti nel parametro di configurazione dell'agente ServerActive sono utilizzati per l'invio dei dati. Se l'invio dei dati batch fallisce a un indirizzo, 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 utilizzato il nome host o l'indirizzo IP del proxy. Quando usato insieme a --config, sovrascrive le voci del parametro ServerActive specificato nel file di configurazione agentd.

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

-I, --source-address IP-address Specifica l'indirizzo IP di origine. Quando usato insieme a --config, sovrascrive il parametro SourceIP specificato nel file di configurazione 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'elemento (come registrato nel frontend Zabbix). L'indirizzo IP dell'host e il nome DNS non funzioneranno. Quando usato insieme a --config, sovrascrive il parametro Hostname specificato nel file di configurazione agentd.

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

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

-i, --input-file input-file Carica i valori dal file di input. Specifica - come <input-file> per leggere i valori dall'input standard. Ogni riga del file contiene delimitato da spazi bianchi: <hostname> <key> <value>. 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 Zabbix, "key" è la chiave dell'elemento target e "value" è il valore da inviare. Specifica - come <hostname> per utilizzare il nome host dal file di configurazione dell'agente o dall'argomento --host.

Un esempio di una riga di un file di input: "Linux DB3" db.connections 43 Il tipo di valore deve essere impostato correttamente nella configurazione dell'elemento del frontend Zabbix. Zabbix sender invierà fino a 250 valori in una connessione. Il limite di dimensione per l'invio dei valori da un file di input dipende dalla dimensione descritta nel protocollo di comunicazione di Zabbix. I contenuti del file di input devono essere codificati in UTF-8. Tutti i valori del file di input sono inviati in ordine sequenziale dall'alto verso il basso. Le voci devono essere formattate utilizzando le seguenti regole:

Sono supportate voci con e senza virgolette.
Il carattere di citazione è la doppia virgoletta.
Le voci con spazi bianchi devono essere tra virgolette.
I caratteri doppia virgoletta e barra rovesciata all'interno della voce citata devono essere preceduti da una barra rovesciata.
L'escape non è supportato nelle voci non citate.
Le sequenze di escape linefeed () sono supportate nelle stringhe citate.
Le sequenze di escape linefeed sono tagliate dalla fine di una voce.

-T, --with-timestamps Questa opzione può essere utilizzata 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 timestamp deve essere specificato nel formato Unix timestamp. Se l'elemento target ha trigger che fanno riferimento a esso, tutti i timestamp devono essere in ordine crescente, altrimenti il calcolo degli eventi non sarà corretto.

Un esempio di una 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 è in un tipo di manutenzione "no data", questo valore verrà eliminato; tuttavia, è possibile inviare un valore con timestamp per un periodo di manutenzione scaduto e sarà accettato.

-N, --with-ns Questa opzione può essere utilizzata solo con l'opzione --with-timestamps. Ogni riga del file di input deve contenere 5 voci delimitate da spazi bianchi: <hostname> <key> <timestamp> <ns> <value>.

Un esempio di una 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 quando si legge dall'input standard.

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

non criptato

connetti senza crittografia (predefinito)

psk connetti utilizzando TLS e una chiave pre-condivisa

cert connetti utilizzando TLS e un certificato

--tls-ca-file CA-file Percorso completo di un file contenente i certificati 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 del certificato server consentito.

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

--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 pre-condivisa.

--tls-cipher13 cipher-string Stringa di cifratura per OpenSSL 1.1.1 o più recente per TLS 1.3. Sovrascrive i criteri di selezione della suite di cifratura predefinita. Questa opzione non è disponibile se la versione di OpenSSL è inferiore a 1.1.1.

--tls-cipher cipher-string Stringa di priorità GnuTLS (per TLS 1.2 e successivi) o stringa di cifratura OpenSSL (solo per TLS 1.2). Sovrascrive i criteri di selezione della suite di cifratura predefinita.

-v, --verbose Modalità dettagliata, -vv per più dettagli.

-h, --help Mostra questo aiuto ed esci.

-V, --version Mostra le informazioni sulla versione ed esci.

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.

###ESEMPI

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45
Invia 342.45 come valore per l'elemento mysql.queries dell'host monitorato. Utilizza l'host monitorato e il server Zabbix definiti nel file di configurazione dell'agente.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45
Invia 342.45 come valore per l'elemento mysql.queries dell'host Monitored Host utilizzando il server Zabbix definito nel file di configurazione dell'agente.

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'agente. Il trattino nei dati di input indica che anche il nome host deve essere utilizzato 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 elemento al server Zabbix con indirizzo IP 192.168.1.113 sulla porta 10000 dalla riga di comando. I valori vuoti devono essere indicati da virgolette doppie vuote.

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'elemento mysql.queries nell'host Monitored Host al server con IP 192.168.1.113 utilizzando 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'elemento mysql.queries nell'host Monitored Host al server con IP 192.168.1.113 utilizzando TLS con chiave pre-condivisa (PSK).