[comment]: # ({4683e02c-4dfa5936}) # zabbix\_sender Secció: Comandes d'usuari (1)\ Actualitzat: 2021-06-01\ [Índex](#index) [Return to Main Contents](/documentation/6.0/manpages) ------------------------------------------------------------------------ [ ]{#lbAB} [comment]: # ({/4683e02c-4dfa5936}) [comment]: # ({1fb3a028-1fb3a028}) ## NOM zabbix\_sender - Utilitat de Zabbix sender [ ]{#lbAC} [comment]: # ({/1fb3a028-1fb3a028}) [comment]: # ({3f811652-3f811652}) ## SINOPSI **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** [ ]{#lbAD} [comment]: # ({/3f811652-3f811652}) [comment]: # ({14895cca-14895cca}) ## DESCRIPCIÓ **zabbix\_sender** és una utilitat de línia de comandes per enviar dades de monitoratge al servidor o proxy Zabbix. Al servidor de Zabbix s'hi ha de crear un item del tipus **Zabbix trapper**, amb la clau corresponent. Veieu que a l'entrada de valors només s'acceptaran els equips especificats al camp **Allowed hosts** per a aquest element. [ ]{#lbAE} [comment]: # ({/14895cca-14895cca}) [comment]: # ({acd1c909-cd7de714}) ## OPCIONS **-c**, **--config** *config-file* Fer ús de *config-file*. **Zabbix sender** llegeix els paràmetres del servidor de l'arxiu de configuració de l'agent. Per defecte, **Zabbix sender** no llegeix pas cap arxiu de configuració. Tant sols són suportats els paràmetres **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** i **TLSPSKFile**. Totes les adreces definides al paràmetre de configuració **ServerActive** de l'agent són emprats per enviar dades. Si l'enviament de dades en lots falla per a una adreça, els següents lots no s'enviaran pas cap a aquesta adreça. **-z**, **--zabbix-server** *server* Nom o adreça IP de l'equip del servidor Zabbix. Si un equip és monitorat per un proxy, s'han d'especificar el nom o adreça IP del proxy. Quan s'empra amb **--config**, sobreescriu els valors del paràmetre **ServerActive** especificat a l'arxiu de configuració de l'agent. **-p**, **--port** *port* Nombre de port del servidor Zabbix en execució al servidor. Per defecte és el 10051. Quan s'empra amb **--config**, sobreescriu les entrades de port del paràmetre **ServerActive** especificat a l'arxiu de configuració de l'agent. **-I**, **--source-address** *IP-address* Adreça IP d'origen. Quan s'empra amb **--config**, sobreescriu el paràmetre **SourceIP** especificat a l'arxiu de configuració de l'agent. **-t**, **--timeout** *seconds* Temps d'espera. Interval permès: 1-300 segons (per defecte: 60) **-s**, **--host** *host* Nom de l'equip al que pertany l'element (tal com s'ha registrat al tauler de Zabbix). L'adreça IP de l'equip i el nom DNS no funcionaran pas. Quan s'empra amb **--config**, sobreescriu el paràmetre **Hostname** definit a l'arxiu de configuració de l'agent. **-k**, **--key** *key* Clau de l'element per enviar el valor. **-o**, **--value** *value* Valor de l'element. **-i**, **--input-file** *input-file* Carrega els valors d'un arxiu d'entrada. Escriviu **-** como a **** per tal de llegir els valors d'entrada per defecte. Cada línia de l'arxiu conté espais en blanc delimitats: ** **. Cada valor s'ha d'especificar a la seva línia. Cada línia ha de tindre 3 espais delimitadors: ** **, on "hostname" és el nom de l'equip monitorat tal com s'ha registrat al tauler de Zabbix, "key" és la clau de l'element destí i "value" - el valor a enviar. Definiu **-** com a **** per emprar el nom d'equip de l'arxiu de configuració de l'agent o de l'argument **--host**. Un exemple d'una línia d'entrada d'un arxiu: **"Linux DB3" db.connections 43** El tipus de valor ha d'ésser definit correctament a la configuració de l'element del tauler de Zabbix. El Zabbix Sender enviarà fins a 250 valors en una connexió. [Mida límit](/manual/appendix/protocols/header_datalen) per enviar valors des d'un arxiu d'entrada dependrà de la mida descrita al protocol de comunicacions de Zabbix. El contingut de l'arxiu d'entrada ha d'ésser codificat amb UTF-8. Tots els valors de l'arxiu d'entrada s'envien en ordre seqüencial de dalt a baix. Les entrades s'han de formatar amb aquestes regles: - Suporta entrades amb i sense cometes. - Cometes dobles representen els caràcters de cometes. - Les entrades amb espais en blanc han d'ésser entre cometes. - Els caracters de cometes dobles i barra invertida dins de cometes s'han d'especificar amb una barra invertida. - L'ESC no és pas suportat en entrades sense cometes. - Els salts de línia (\\n) es suporten en cadenes entre cometes. - Els salts de línia es tallen a partir del final d'una entrada. **-T**, **--with-timestamps** Aquesta opció només es pot emprar amb l'opció **--input-file**. Cada línia de l'arxiu d'entrada ha de contindre 4 entrades delimitades per espais en blanc: ** **. El temps d'espera s'ha d'especificar en format Unix. Si el destí té triggers que el referencien, tots els temps d'espera han d'ésser en ordre creixent; en cas contrari, el càlcul de l'event no serà pas correcte. Un exemple d'una línia de l'arxiu d'entrada: **"Linux DB3" db.connections 1429533600 43** Per més detalls, veieu l'opció **--input-file**. Si un valor amb temps d'espera s'envia a un equip que és en tipus de manteniment “no data”, es descartarà el valor; en canvi, és possible enviar un valor de temps d'espera per a un període de manteniment expirat i s'acceptarà. **-N**, **--with-ns** Aquesta opció només es pot emprar amb l'opció **--with-timestamps**. Cada línia de l'arxiu d'entrada ha de contindre 5 entrades delimitades per espais en blanc: ** **. un exemple d'una línia d'arxiu d'entrada: **"Linux DB3" db.connections 1429533600 7402561 43** Per tindre més detalls, veieu l'opció **--input-file**. **-r**, **--real-time** Envia els valors d'un en un tan aviat es reben. Això es pot emprar al llegir de l'entrada per defecte. **--tls-connect** *value* Com connectar al servidor o proxy. Valors: [ ]{#lbAF} [comment]: # ({/acd1c909-cd7de714}) [comment]: # ({4029bd0a-4029bd0a}) ### **unencrypted** connectar sense criptografia (per defecte) ```{=html} ``` **psk** connectar amb TLS i una clau pre-compartida ```{=html} ``` **cert** connectar amb TLS i un certificat ```{=html} ``` **--tls-ca-file** *CA-file* Ruta completa d'un arxiu que conté els certificats CA(s) de nivell superior per verificar la certificació de peer. **--tls-crl-file** *CRL-file* Ruta completa de l'arxiu que conté els certificats revocats. **--tls-server-cert-issuer** *cert-issuer* Emissor de certificat de servidor permès. **--tls-server-cert-subject** *cert-subject* Assumpte del certificat del servidor permès. **--tls-cert-file** *cert-file* Ruta completa de l'arxiu que conté el certificat o cadena de certificats. **--tls-key-file** *key-file* Ruta completa d'un arxiu que conté la clau privada. **--tls-psk-identity** *PSK-identity* Cadena d'identitat PSK. **--tls-psk-file** *PSK-file* Ruta completa d'un arxiu que conté la clau pre-compartida. **--tls-cipher13** *cipher-string* Seqüència de criptografia per a OpenSSL 1.1.1 or més nova per a TLS 1.3. Sobreescriu el criteri per escollir per defecte el xifrat. Aquesta opció no és pas disponible si la versió d'OpenSSL és inferior a l'1.1.1. **--tls-cipher** *cipher-string* La cadena de prioritat GnuTLS (per a TLS 1.2 o superior) o la cadena de xifrat d'OpenSSL (només per a TLS 1.2). Sobreescriu els criteris d'escollir per defecte de la cadena de xifrat. **-v**, **--verbose** Mode detallat; **-vv** per a més detalls. **-h**, **--help** Mostra l'ajuda i surt. **-V**, **--version** Mostra informació de la versió i surt. [ ]{#lbAG} [comment]: # ({/4029bd0a-4029bd0a}) [comment]: # ({965bb13b-965bb13b}) ## ESTAT DE SORTIDA L'estat de sortida és 0 si els valors enviats són tots ells processats com a successos pel servidor. Si les dades s'envien i ha fallat el processament de com a mínim un dels valors, l'estat de sortida és 2. Si l'enviament de dades ha fallat, l'estat de sortida és 1. [ ]{#lbAH} [comment]: # ({/965bb13b-965bb13b}) [comment]: # ({9b276166-9b276166}) ## EXEMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip monitorat. Fa ús de l'equip monitorat i el servidor Zabbix definit a l'arxiu de configuració de l'agent de Zabbix. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip **Monitored Host**, fent ús del servidor de Zabbix definit a l'arxiu de configuració de l'agent de Zabbix. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Envia els valors de l'arxiu **data\_values.txt** cal ap servidor zabbix amb la IP **192.168.1.113**. El nom d'equips i les claus es defineixen a l'arxiu. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Envia un valor de timestamp de la línia de comandes per al servidor Zabbix, definit a l'arxiu de configuració de l'agent de Zabbix. La barra a les dades d'entrada indica que el nom de l'equip també s'ha d'emprar al mateix arxiu de configuració. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Envia un valor buit d'un element per al servidor Zabbix amb l'adreça IP **192.168.1.113** i el port **10000** des de la línia de comandes. Els valors buits s'han d'indicar amb cometes dobles. **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**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip **Monitored Host** cap al servidor amb IP **192.168.1.113**, emprant certificat TLS. **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**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip **Monitored Host** cap al servidor amb IP **192.168.1.113**, emprant TLS com a clau pre-compartida (PSK). [ ]{#lbAI} [comment]: # ({/9b276166-9b276166}) [comment]: # ({554afaaf-554afaaf}) ## VEIEU TAMBÉ Documentació **[zabbix\_agentd](zabbix_agentd)**(8), **[zabbix\_get](zabbix_get)**(1), **[zabbix\_proxy](zabbix_proxy)**(8), **[zabbix\_server](zabbix_server)**(8), **[zabbix\_js](zabbix_js)**(1), **[zabbix\_agent2](zabbix_agent2)**(8), **[zabbix\_web\_service](zabbix_web_service)**(8) [ ]{#lbAJ} [comment]: # ({/554afaaf-554afaaf}) [comment]: # ({e55ed07e-c84769dd}) ## AUTOR Alexei Vladishev <> ------------------------------------------------------------------------ [ ]{#index} [comment]: # ({/e55ed07e-c84769dd}) [comment]: # ({d0347988-0c5a6f3e}) ## Índex [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [ESTAT DE SORTIDA](#lbAG) [EXEMPLES](#lbAH) [VEIEU TAMBÉ](#lbAI) [AUTOR](#lbAJ) ------------------------------------------------------------------------ Aquest document fou creat per [man2html](/cgi-bin/man/man2html), usant les pàgines d'aquest manual.\ Hora: 08:42:39 GMT, 11 de Juny de 2021 [comment]: # ({/d0347988-0c5a6f3e})