Table of Contents

zabbix_sender
- NOMBRE
- SINOPSIS
- DESCRIPCIÓN
- OPCIONES
- SALIDA DE PROCESOS
- EJEMPLOS
- VER TAMBIÉN
- Índice

zabbix_sender

Sección: Comandos de usuario (1)
Actualizado en: 2021-06-01
Índice Volver a contenidos principales

NOMBRE

zabbix_sender - Utilidad del transmisor Zabbix

SINOPSIS

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

DESCRIPCIÓN

zabbix_sender es una utilidad de línea de comandos para enviar los datos monitorizados al servidor Zabbix o al proxy. En el servidor Zabbix un tipo de métrica Captura Zabbix debe ser creada con su clave correspondiente. Hay que tener en cuenta que los valores recibidos sólo serán aceptados desde los equipos especificados en el campo Equipos permitidos para esta métrica.

OPCIONES

-c, --config config-file
Utilice config-file. Zabbix sender para leer en detalles del servidor en el archivos de configuración del agente. Por defecto Zabbix sender no leer ningún archivo de configuración. Solo parámetros como Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity y TLSPSKFile están soportados. Todas las rutas definidas en los parámetros de configuración del agente ServerActive son usadas para enviar datos. Si uno de los lotes de datos falla en una de las rutas, los siguientes lotes no serán enviados a esa ruta.

-z, --zabbix-server server
Nombre del equipo o dirección IP del servidor Zabbix. Si un equipo está siendo monitorizado por un proxy, debe usarse el nombre del proxy equipo o la dirección IP. Cuando se usa junto con --config, sobreescribe las entradas de ServerActive del parámetro especificado en el archivo de configuración agentd.

-p, --port port
Especifica el número de puerto del capturador del servidor donde está ejecutandose en el servidor. Por defecto es el 10051. Cuando se usa junto con --config, sobreescribe el puerto de entrada del ServerActive del parámetro especificado en el archivo de configuración agentd.

-I, --source-address IP-address
Especifica el dirección IP de origen. Cuando se usa junto con --config, sobreescrive SourceIP del parámetro especificado en el archivo de configuración agentd.

-t, --timeout seconds
Especifica el tiempo de espera. Rango válido: 1-300 segundos (por defecto: 60)

-s, --host host
Especifica el nombre del equipo al que pertenece el elemento (registrado como el interfaz de Zabbix). La dirección IP del equipo y el nombre DNS no funcionarán. Cuando son usados junto con --config, sobreescribe Hostname del parámetro especificado en el archivo de configuración agentd.

-k, --key key
Especifica la clave de la métrica para enviar el valor.

-o, --value value
Especifica el valor de la métrica.

-i, --input-file input-file
Carga los valores desde el fichero de entrada. Especifica - como <input-file> para leer los valores desde la entrada estándar. Cada linea del archivo contiene espacios en blanco delimitados: <hostname> <key> <value>. Cada valor debe ser especificado en su propia linea. Cada linea debe contener 3 espacios en blanco delimitando las entradas: <hostname> <key> <value>, donde "hostname" es el nombre del equipo monitorizado registrado en el interfaz de Zabbix, "key" es la clave del elemento y "value" - el valor para ser enviado. Especifica - como <hostname> para usar el nombre de equipo desde el archivo de configuración del agente o desde el argumento --host .

Un ejemplo de una linea de un archivo entrada:

"Linux DB3" db.connections 43

El tipo de valor debe ser establecido correctamente en la configuración de la métrica en la interfaz de Zabbix. El remitente de Zabbix enviará hasta 250 valores en una sola conexión. El contenido del fichero de entrada debe estar codificado en UTF-8. Todos los valores del fichero de entrada se envían en orden secuencial de arriba a abajo. Las entradas deben ser formateadas usando las siguientes reglas:

Se permiten las entradas con comillas y sin comillas.
Las dobles comillas es el carácter de comillas.
Las entradas con espacios en blanco deben estar entre comillas.
Las dobles comillas y la barra invertida dentro de una entrada con comillas necesita de una barra invertida para el escape.
No se admite el escape en entradas sin comillas.
Las secuencias de salto de linea (\n) están soportadas en las cadenas entrecomilladas.
Las secuencias de salto de linea son recortadas desde el final de una entrada.

-T, --with-timestamps
Esta opción solo puede ser usada con la opción --input-file .

Cada linea del archivo de entrada debe contener 4 espacios delimitando las entradas: <hostname> <key> <timestamp> <value>. La marca de tiempo debe ser especificada en el formato de marca de tiempo de UNIX. Si el elemento objetivo tiene disparadores que lo referencian, todos las marcas de tiempo deben estar en un orden creciente, de lo contrario el cálculo del evento no será correcto.

Un ejemplo de una linea del archivo de entrada:

"Linux DB3" db.connections 1429533600 43

Para más detalles por favor mire la opción --input-file.

Si se envía un valor de marca de tiempo para un equipo que está en un mantenimiento de tipo "no data" entonces el valor será eliminado; Sin embargo, si es posible enviar un valor de marca de tiempo para un periodo de mantenimiento terminado y este será aceptado.

-N, --with-ns
Esta opción solo debe usarse con la opción --with-timestamps .

Cada linea del archivo de entrada contendrá 5 espacios en blanco delimitando las entradas: <hostname> <key> <timestamp> <ns> <value>.

Un ejemplo de una linea del archivo de entrada:

"Linux DB3" db.connections 1429533600 7402561 43

Para más detalles por favor mire la opción --input-file.

-r, --real-time
Envia los valores uno a uno tan pronto como son recibidos. Esto se puede utilizar cuando la lectura proviene de una entrada estándar.

--tls-connect value
Como se conecta al servidor o el proxy. Valores:

sin cifrar conectarse sin encriptación (predeterminado)

psd conectarse mediante TLS y una clave precompartida

certificado conectarse mediante TLS y un certificado

--archivo-tls-ca archivo-CA Nombre de ruta completo de un archivo que contiene los certificados de CA(s) de nivel superior para verificación de certificado de pares.

--archivo-tls-crl archivo-CRL Nombre de ruta completo de un archivo que contiene certificados revocados.

--tls-server-cert-emisor cert-emisor Emisor de certificado de servidor permitido.

--tls-server-cert-subject cert-subject Sujeto de certificado de servidor permitido.

--archivo-cert-tls archivo-cert Nombre de ruta completo de un archivo que contiene el certificado o la cadena de certificados.

--archivo-clave-tls archivo-clave Nombre de ruta completo de un archivo que contiene la clave privada.

--tls-psk-identidad PSK-identidad Cadena de identidad de PSK.

--archivo tls-psk archivo PSK Nombre de ruta completo de un archivo que contiene la clave precompartida.

--tls-cipher13 cadena de cifrado Cadena de cifrado para OpenSSL 1.1.1 o posterior para TLS 1.3. Anular el Criterios de selección de conjuntos de cifrado predeterminados. Esta opción no está disponible si La versión de OpenSSL es inferior a 1.1.1.

--tls-cipher cadena de cifrado Cadena de prioridad GnuTLS (para TLS 1.2 y versiones posteriores) o cadena de cifrado OpenSSL (solo para TLS 1.2). Anule los criterios de selección predeterminados del conjunto de cifrado.

-v, --detallado Modo detallado, -vv para más detalles.

-h, --ayuda Muestre esta ayuda y salga.

-V, --versión Salida de información de versión y salida.

SALIDA DE PROCESOS

El estado de salida de procesos es 0 si los valores han sido enviados y todos han sido procesados satisfactoriamente por el servidor. Si los datos han sido enviados, pero al procesarlos al menos uno de los valores falla, el estado de salida de procesos es 2. Si el envío de datos falla, el estado de salida será 1.

EJEMPLOS

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.consultas -o 342.45

Envíe 342.45 como valor para mysql.queries elemento de monitoreado anfitrión. Use el host monitoreado y el servidor Zabbix definido en el agente archivo de configuración.

zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Host supervisado" -k mysql.consultas -o 342.45

Envíe 342.45 como valor para el elemento mysql.queries de Supervisado Host host que utiliza el servidor Zabbix definido en el archivo de configuración del agente.

zabbix_sender -z 192.168.1.113 -i datos_valores.txt

Enviar valores desde el archivo data_values.txt al servidor Zabbix con IP 192.168.1.113. Los nombres de host y las claves se definen en el archivo.

echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix_sender -c /usr/local/etc/zabbix_agentd.conf -T -i -

Envíe un valor con marca de tiempo desde la línea de comandos al servidor Zabbix, especificado en el archivo de configuración del agente. Guión en los datos de entrada indica que el nombre de host también debe usarse desde la misma configuración expediente.

echo '"Servidor Zabbix" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -

Enviar valor vacío de un elemento al servidor Zabbix con dirección IP 192.168.1.113 en el puerto 10000 desde la línea de comandos. Valores vacíos debe indicarse mediante comillas dobles vacías.

zabbix_sender -z 192.168.1.113 -s "Host supervisado" -k mysql.consultas -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íe 342.45 como el valor para el elemento mysql.queries en Supervisado Host host a servidor con IP 192.168.1.113 usando TLS con certificado.

zabbix_sender -z 192.168.1.113 -s "Host supervisado" -k mysql.consultas -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --archivo tls-psk /home/zabbix/zabbix_agentd.psk

Envíe 342.45 como el valor para el elemento mysql.queries en Supervisado Host host a servidor con IP 192.168.1.113 usando TLS con clave previamente compartida (PSK).