Table of Contents

zabbix_sender
- NOMBRE
- SYNOPSIS
- DESCRIPCIÓN
- OPCIONES
- EXIT STATUS
- EJEMPLOS
- VEA TAMBIÉN
- AUTOR
- Índice

zabbix_sender

Section: User Commands (1)
Updated: 2018-10-11
Índice Retorno a Página Principal

NOMBRE

zabbix_sender - Utilidad Zabbix sender

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

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.

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:

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.

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

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