zabbix_sender
Section: User Commands (1)
Updated: 2018-10-11
Índice Retorno a Página
Principal
[ ]{#lbAB}
NOMBRE
zabbix_sender - Utilidad Zabbix sender [ ]{#lbAC}
SYNOPSIS
zabbix_sender [-v] -z server [-p port] [-I
IP-address] -s host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-s host] [-T] [-r] -i
input-file
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-s host] -k key
-o value
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-s host] [-T]
[-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I
IP-address] -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 -k key -o value
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-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 [-T] [-r] -i
input-file
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-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 -k
key -o value
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-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 [-T]
[-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I
IP-address] -s host --tls-connect psk
--tls-psk-identity PSK-identity --tls-psk-file PSK-file
-k key -o value
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-s host] --tls-connect psk
--tls-psk-identity PSK-identity --tls-psk-file PSK-file
[-T] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-s host]
--tls-connect psk --tls-psk-identity PSK-identity
--tls-psk-file PSK-file -k key -o value
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-s host]
--tls-connect psk --tls-psk-identity PSK-identity
--tls-psk-file PSK-file [-T] [-r] -i input-file
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}
DESCRIPCIÓN
zabbix_sender Es un comando de la línea de comandos para enviar información de monitoreo al servidor o proxy Zabbix. En el servidor Zabbix, un ítem del tipo Zabbix trapper debe ser creado con su correspondiente key. Es de notar que los valores van a ser aceptados solo si provienen de los hosts especificados en la propiedad Allowed hosts del mencionado ítem. [ ]{#lbAE}
OPCIONES
-c, --config config-file
Zabbix sender lee las propiedades del servidor desde el archivo de
configuración del agente Zabbix config-file.. Por defecto Zabbix
sender no lee ningún archivo de configuración. El nombre completo del
archivo debe ser especificado Solo los parámetros Hostname,
ServerActive, SourceIP, TLSConnect, TLSCAFile,
TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject,
TLSCertFile, TLSKeyFile, TLSPSKIdentity y TLSPSKFile son
soportados. La primera entrada del parámetro ServerActive es usada.
-z, --zabbix-server server
Hostname o dirección IP del servidor Zabbix. Si el dispositivo es
monitoreado por un proxy, debe usarse el nombre del éste o su IP. Cuando
se usa en conjunto con --config, sobreescribe la primer entrada del
parámetro ServerActive especificado en el archivo de configuración.
-p, --port port
El puerto en el servidor Zabbix donde escucha el proceso trapper. Por
defecto ess 10051. Cuando se usa en conjunto con --config,
sobreescribe el puerto de la primer entrada del parámetro
ServerActive especificado en el archivo de configuración.
-I, --source-address IP-address
Especifica la IP de origen. Cuando se usan en conjunto con --config,
sobreescribe el parámetro SourceIP especificado en el archivo de
configuración.
-s, --host host
Especifica el nombe del host al que el ítem pertenece, tal cual está
registrado en el frontend Zabbix. La IP o DNS no van a funcionar. Cuando
se usa en conjunto con --config, sobreescribe el parámetro
Hostname especificado en el archivo de configuración.
-k, --key key
Especifica la key del ítem al que se le envía el valor.
-o, --value value
Especifica el valor enviado al ítem.
-i, --input-file input-file
Carga los valores desde input-file Especifique - como
<input-file> para leer los valores desde el standard input
Cada linea del archivo debe contener los campos delimitados por blanc:
<hostname> <key> <value>. Cada valor debe ser
especificado en líneas diferentes. Cada linea debe contener 3 entradas
delimitadas por blanco: <hostname> <key> <value>,
donde "hostname" es el nombre del dispositivo monitoreado tal cual está
registrado en el frontend Zabbix. "key" es la key del tem al que se le
carga el valor y "value" - el valor que se carga. Especifique - como
<hostname> para usar el hostname especificado en el archivo de
configuración o el especificado en el argumento de --host.
Un ejemplo de una línea de un archivo de entrada:
"Linux DB3" db.connections 43
El tipo del valor debe ser correctamente configurado en el ítem, desde el frontend Zabbix, para recibir el valor. Zabbix sender va a enviar hasta 250 valores en una conección. El contenido del archivo de entrada debe estar condificado en UTF-8. Todos los valores del archivo de entrada son enviados de forma secuencial desde el comienzo del archivo. Las entradas deben ser formateadas utilizando las siguientes reglas:
•
Entradas con y sin comillas son aceptadas.
•
El caracter para entrecomillar es la comilla doble.
•
Entradas con espacios en blanco deben ser entrecomilladas.
•
Retrobarras (backslash) y comillas dobles dentro de una entrada deben
ser escapadas con retrobarras (backslash).
•
Escapar caracteres en entradas sin encomillas no es aceptado.
•
Avance de línea (linefeed \n) son aceptados en entradas
entrecomilladas.
•
Los avances de línea (linefeed) al final de una entrada son quitados.
-T, --with-timestamps
Esta opción solo puede ser usada con la opción --input-file.
Cada línea del archivo de entrada debe contener 4 entradas separadas por blancos: <hostname> <key> <timestamp> <value>. Timestamp debe ser especificada como en el formato Unix timestamp. Si el ítem tiene triggers que lo referencian, todos los timestamp deben ser especificados en orden creciente, de otra manera el cálculo de eventos no va a ser correcto.
Un ejemplo de una línea del un archivo de entrada:
"Linux DB3" db.connections 1429533600 43
Para más información por favor mire la opción --input-file.
Si un valor con timestamp es especificado para un dispositivo que está en mantenimiento sin cosecha de valores, ese valor va a ser descartado, sin embargo es posible enviar un valor para un período de mantenimiento expirado y va a ser aceptado.
-r, --real-time
Envía los valores de a uno en uno así como son recividos. Esto puede
usarse cuando se lee desde el standard input
--tls-connect value
Como conectarse al servidor o proxy. Valores:
[ ]{#lbAF}
unencrypted
conectarse sin encriptación (valor por defecto)
<!-- -->
psk
conectarse usando TLS y una pre-shared key
<!-- -->
cert
conectarse unsando TLS y un certificado.
<!-- -->
--tls-ca-file CA-file
Nombre completo del archivo conteniendo el primer nivel de los
certificados CA(s) para verificación del punto.
--tls-crl-file CRL-file
Nombre completo del archivo conteniendo los certificados revocados.
--tls-server-cert-issuer cert-issuer
Agente emisor autorizado.
--tls-server-cert-subject cert-subject
Titular autorizado del agente del certificado.
--tls-cert-file cert-file
Nombre completo del archivo conteniendo el certificado o la cadena de
certificado.
--tls-key-file key-file
Nombre completo del archivo conteniendo la calve privada.
--tls-psk-identity PSK-identity
Cadena PSK-identity.
--tls-psk-file PSK-file
Nombre completo del archivo conteniendo la clave compartida (pre-shared
key)
-v, --verbose
Modo Verbose, -vv para más información.
-h, --help
Despliega esta auyuda y sale
-V, --version
Despliega información de versión y sale.
[ ]{#lbAG}
EXIT STATUS
El exit status</> is 0 si los valores fueron enviados y todos ellos fueron procesados con éxito por el servidor. Si los datos fueron enviados, pero el proceso de al menos uno falló, el exit status</> es 2. Si falló el envío de datos, etonces el *exit status</> es 1.***
[ ]{#lbAH}
EJEMPLOS
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45\
Envía 342.45 como el valor para el ítem con la key mysql.queries del dispositivo monitoreado. Usa el dispositivo monitoreado y el servidor Zabbix especificado en el archivo de configuración del agente /etc/zabbix/zabbix_agentd.conf.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45\
Envía 342.45 como el valor para el ítem con la key mysql.queries del dispositivo Monitored Host usando el servidor Zabbix epecificado en el archivo de configuración del agente /etc/zabbix/zabbix_agentd.conf.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Envía los valores especificado en el archivo data_values.txt al
servidor Zabbix con IP 192.168.1.113. Los nombres de los
dispositivos y las key de los ítems son especificados en el archivo.
echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -\
Envía valores con timestampo desde la línea de comandos al servidor Zabbix especificado en el archivo de configuración del agente /usr/local/etc/zabbix_agentd.conf. El - especificado en los datos de entrada indica que el hostname debe ser tomado de mismo archivo de configuración.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z
192.168.1.113 -p 10000 -i -\
Envía un valor vacío a un ítem en el servidor Zabbix con IP 192.168.1.113 en el puerto 10000 desde la línea de comandos. Valores vacíos deben ser especificados con dos comillas dobles seguidas.
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\
Envía 342.45 como valor para el ítem de key mysql.queries en el dispositivo Monitored Host a el servidor Zabbix con IP 192.168.1.113 usando TLS con certificado.
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\
Envía 342.45 como valor para el ítem de key mysql.queries en el dispositivo Monitored Host a el servidor Zabbix con IP 192.168.1.113 usando TLS con pre-shared key (PSK).
[ ]{#lbAI}
VEA TAMBIÉN
zabbix_agentd(8), zabbix_get(8), zabbix_proxy(8), zabbix_server(8) [ ]{#lbAJ}
AUTOR
Alexei Vladishev <[email protected]>
[ ]{#index}
Índice
This document was created by man2html,
using the manual pages.
Time: 15:28:13 GMT, October 18, 2018