[comment]: # ({7b8627f8-e8fcab58}) # zabbix_sender ```text ZABBIX_SENDER(1) Manuale dei comandi generali ZABBIX_SENDER(1) NOME zabbix_sender - utilità Zabbix sender SINTASSI 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 monitoraggio a un server o proxy Zabbix. Sul server Zabbix deve essere creato un item di tipo Zabbix trapper con la chiave corrispondente. Nota 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 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. L'Hostname definito tramite il parametro HostnameItem non verrà preso in considerazione; 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 di agent vengono usati per l'invio dei dati. Se l'invio dei dati in batch fallisce verso un indirizzo, i batch successivi non vengono inviati a tale 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, sostituisce le voci del parametro ServerActive specificato nel file di configurazione di agentd. -p, --port port Specifica il numero di porta del trapper Zabbix in esecuzione sul server. Il valore predefinito è 10051. Se usato insieme a --config, sostituisce le voci di porta del parametro ServerActive specificato nel file di configurazione di agentd. -I, --source-address IP-address Specifica l'indirizzo IP sorgente. Se usato insieme a --config, sostituisce 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 Zabbix). L'indirizzo IP dell'host e il nome DNS non funzioneranno. Se usato insieme a --config, sostituisce 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. Specifica - come per leggere i valori dallo standard input. Ogni riga del file contiene, separati da spazi: . Ogni valore deve essere specificato su una riga propria. Ogni riga deve contenere 3 voci separate da spazi: , dove "hostname" è il nome dell'host monitorato come registrato nel frontend Zabbix, "key" è la chiave dell'item di destinazione e "value" è il valore da inviare. Specifica - come per usare il nome host dalla configurazione di 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 Zabbix. Zabbix sender invierà fino a 250 valori in una connessione. Il contenuto del file di input deve essere codificato in 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 citazione è il doppio apice. • Le voci contenenti spazi devono essere racchiuse tra virgolette. • I caratteri doppio apice e backslash all'interno di una voce tra virgolette devono essere escapati con un backslash. • L'escaping non è supportato nelle voci non tra virgolette. • Le sequenze di escape di fine riga (\n) sono supportate nelle stringhe tra virgolette. • Le sequenze di escape di fine 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 separate da spazi: . Il timestamp deve essere specificato nel formato Unix timestamp. Se l'item di destinazione ha trigger che lo referenziano, tutti 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 ulteriori dettagli, vedere l'opzione --input-file. Se un valore con timestamp viene inviato per un host che si trova in un tipo di manutenzione “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 separate da spazi: . Un esempio di riga di un file di input: "Linux DB3" db.connections 1429533600 7402561 43 Per ulteriori dettagli, vedere l'opzione --input-file. -r, --real-time Invia i valori uno per uno non appena vengono ricevuti. Può essere usato quando si legge dallo standard input. --tls-connect value Modalità di connessione al server o proxy. Valori: unencrypted 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 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 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 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 successivo per TLS 1.3. Sostituisce i criteri predefiniti di selezione della suite di cifratura. 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 versioni successive) o stringa di cifratura OpenSSL (solo per TLS 1.2). Sostituisce i criteri predefiniti di selezione della suite di cifratura. -v, --verbose Modalità dettagliata, -vv per maggiori dettagli. -h, --help Mostra 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 è fallita, 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'item mysql.queries dell'host monitorato. Usa l'host monitorato e il server Zabbix definiti nel file di configurazione di 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 Monitored Host usando il server Zabbix definito nel file di configurazione di 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 di 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 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'item mysql.queries nell'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 nell'host Monitored Host al server con IP 192.168.1.113 usando TLS con chiave precondivisa (PSK). VEDI 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) ``` [comment]: # ({/7b8627f8-e8fcab58})