Áú»¢¶Ä²©

zabbix_sender

Secci¨®: Comandes d'usuari (1)
Actualitzat: 2021-06-01
?ndex Return to Main Contents


?

NOM

zabbix_sender - Utilitat de Áú»¢¶Ä²© sender ?

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] [-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 ?

DESCRIPCI?

zabbix_sender ¨¦s una utilitat de l¨ªnia de comandes per enviar dades de monitoratge al servidor o proxy Áú»¢¶Ä²©. Al servidor de Áú»¢¶Ä²© s'hi ha de crear un item del tipus Áú»¢¶Ä²© 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. ?

OPCIONS

-c, --config config-file
Fer ¨²s de config-file. Áú»¢¶Ä²© sender llegeix els par¨¤metres del servidor de l'arxiu de configuraci¨® de l'agent. Per defecte, Áú»¢¶Ä²© sender no llegeix pas cap arxiu de configuraci¨®. Tant sols s¨®n suportats els par¨¤metres Hostname, ListenBacklog, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity i TLSPSKFile. El nom d'equip definit al par¨¤metre HostnameItem no s'agafar¨¤ pas; en aquest cas el nom d'equip s'ha d'especificar via l¨ªnia de comandes (veieu la opci¨® -s). 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 Áú»¢¶Ä²©. 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²©). 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 <input-file> per tal de llegir els valors d'entrada per defecte. Cada l¨ªnia de l'arxiu cont¨¦ espais en blanc delimitats: <hostname> <key> <value>. Cada valor s'ha d'especificar a la seva l¨ªnia. Cada l¨ªnia ha de tindre 3 espais delimitadors: <hostname> <key> <value>, on "hostname" ¨¦s el nom de l'equip monitorat tal com s'ha registrat al tauler de Áú»¢¶Ä²©, "key" ¨¦s la clau de l'element dest¨ª i "value" - el valor a enviar. Definiu - com a <hostname> 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 Áú»¢¶Ä²©. El Áú»¢¶Ä²© Sender enviar¨¤ fins a 250 valors en una connexi¨®. Mida l¨ªmit per enviar valors des d'un arxiu d'entrada dependr¨¤ de la mida descrita al protocol de comunicacions de Áú»¢¶Ä²©. 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: <hostname> <key> <timestamp> <value>. 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: <hostname> <key> <timestamp> <ns> <value>.

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.

-g, --group
Agrupa els valors per equips i els envia a cada equip en un lot independent.

--tls-connect value
Com connectar al servidor o proxy. Valors:

?

unencrypted
connectar sense criptografia (per defecte)

psk
connectar amb TLS i una clau pre-compartida

cert
connectar amb TLS i un certificat

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

?

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.

?

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 Áú»¢¶Ä²© definit a l'arxiu de configuraci¨® de l'agent de Áú»¢¶Ä²©.

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 Áú»¢¶Ä²© definit a l'arxiu de configuraci¨® de l'agent de Áú»¢¶Ä²©.


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 Áú»¢¶Ä²©, definit a l'arxiu de configuraci¨® de l'agent de Áú»¢¶Ä²©. 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 '"Áú»¢¶Ä²© server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

Envia un valor buit d'un element per al servidor Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 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).

?

VEIEU TAMB?

¶Ù´Ç³¦³Ü³¾±ð²Ô³Ù²¹³¦¾±¨® /manuals

zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8) ?

?ndex

NOM

SINOPSI

DESCRIPCI?

OPCIONS

ESTAT DE SORTIDA

EXEMPLES

VEIEU TAMB?

AUTOR


Aquest document fou creat per man2html, usant les p¨¤gines d'aquest manual.
Hora: 08:42:39 GMT, 11 de Juny de 2021