zabbix_sender

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
              <input-file> per leggere i valori dallo standard input. Ogni riga
              del file contiene, separati da spazi: <hostname> <key> <value>.
              Ogni valore deve essere specificato su una riga propria. Ogni
              riga deve contenere 3 voci separate da spazi: <hostname> <key>
              <value>, 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
              <hostname> 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: <hostname> <key> <timestamp> <value>. 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: <hostname> <key> <timestamp> <ns> <value>.

              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)