Table of Contents

zabbix_sender
- NOMBRE
- SINOPSIS
- DESCRIPCIÓN
- OPCIONES
- ESTADO DE SALIDA
- EJEMPLOS
- VEA TAMBIÉN
- Índice

zabbix_sender

Sección: Comandos de usuario (1)
Actualizado: 2021-06-01
Índice Volver al contenido principal

NOMBRE

zabbix_sender - Utilidad de envío de Zabbix

SINOPSIS

zabbix_sender [-v] -z servidor [-p puerto] [-I dirección-IP] [-t timeout] -s equipo -k clave -o valor
zabbix_sender [-v] -z servidor [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] [-T] [-N] [-r] [-g] -i archivo-entrada
zabbix_sender [-v] -c archivo-configuración [-z servidor] [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] -k clave -o valor
zabbix_sender [-v] -c archivo-configuración [-z servidor] [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] [-T] [-N] [-r] [-g] -i archivo-entrada
zabbix_sender [-v] -z servidor [-p puerto] [-I dirección-IP] [-t timeout] -s equipo --tls-connect cert --tls-ca-file archivo-CA [--tls-crl-file archivo-CRL] [--tls-server-cert-issuer emisor-cert] [--tls-server-cert-subject sujeto-cert] --tls-cert-file archivo-cert --tls-key-file archivo-clave [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] -k clave -o valor
zabbix_sender [-v] -z servidor [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] --tls-connect cert --tls-ca-file archivo-CA [--tls-crl-file archivo-CRL] [--tls-server-cert-issuer emisor-cert] [--tls-server-cert-subject sujeto-cert] --tls-cert-file archivo-cert --tls-key-file archivo-clave [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] [-T] [-N] [-r] [-g] -i archivo-entrada
zabbix_sender [-v] -c archivo-configuración [-z servidor] [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] --tls-connect cert --tls-ca-file archivo-CA [--tls-crl-file archivo-CRL] [--tls-server-cert-issuer emisor-cert] [--tls-server-cert-subject sujeto-cert] --tls-cert-file archivo-cert --tls-key-file archivo-clave [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] -k clave -o valor
zabbix_sender [-v] -c archivo-configuración [-z servidor] [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] --tls-connect cert --tls-ca-file archivo-CA [--tls-crl-file archivo-CRL] [--tls-server-cert-issuer emisor-cert] [--tls-server-cert-subject sujeto-cert] --tls-cert-file archivo-cert --tls-key-file archivo-clave [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] [-T] [-N] [-r] [-g] -i archivo-entrada
zabbix_sender [-v] -z servidor [-p puerto] [-I dirección-IP] [-t timeout] -s equipo --tls-connect psk --tls-psk-identity identidad-PSK --tls-psk-file archivo-PSK [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] -k clave -o valor
zabbix_sender [-v] -z servidor [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] --tls-connect psk --tls-psk-identity identidad-PSK --tls-psk-file archivo-PSK [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] [-T] [-N] [-r] [-g] -i archivo-entrada
zabbix_sender [-v] -c archivo-configuración [-z servidor] [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] --tls-connect psk --tls-psk-identity identidad-PSK --tls-psk-file archivo-PSK [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] -k clave -o valor
zabbix_sender [-v] -c archivo-configuración [-z servidor] [-p puerto] [-I dirección-IP] [-t timeout] [-s equipo] --tls-connect psk --tls-psk-identity identidad-PSK --tls-psk-file archivo-PSK [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] [-T] [-N] [-r] [-g] -i archivo-entrada
zabbix_sender -h
zabbix_sender -V

DESCRIPCIÓN

zabbix_sender es una utilidad de línea de comandos para enviar datos de monitorización al servidor o proxy de Zabbix. En el servidor Zabbix se debe crear una métrica de tipo Zabbix trapper con la clave correspondiente. Tenga en cuenta que los valores entrantes solo serán aceptados de los equipos especificados en el campo Equipos permitidos para esta métrica.

OPCIONES

-c, --config archivo-configuración
Usar archivo-configuración. Zabbix sender lee los detalles del servidor desde el archivo de configuración de agentd. Por defecto, Zabbix sender no lee ningún archivo de configuración. Solo se admiten los parámetros Hostname, ListenBacklog, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity y TLSPSKFile. El nombre de equipo definido a través del parámetro HostnameItem no será recogido, en este caso el nombre de equipo debe especificarse mediante la línea de comandos (ver opción -s). Todas las direcciones definidas en el parámetro de configuración ServerActive del agente se utilizan para enviar datos. Si el envío de datos por lotes falla a una dirección, los siguientes lotes no se envían a esa dirección.

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

-p, --port puerto
Especifica el número de puerto del trapper de Zabbix server que se ejecuta en el servidor. El valor por defecto es 10051. Cuando se usa junto con --config, sobrescribe las entradas de puerto del parámetro ServerActive especificado en el archivo de configuración de agentd.

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

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

-s, --host equipo
Especifica el nombre de equipo al que pertenece la métrica (tal como está registrado en el frontend de Zabbix). La dirección IP y el nombre DNS del equipo no funcionarán. Cuando se usa junto con --config, sobrescribe el parámetro Hostname especificado en el archivo de configuración de agentd.

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

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

-i, --input-file archivo-entrada
Carga valores desde un archivo de entrada. Especifique - como <archivo-entrada> para leer valores desde la entrada estándar. Cada línea del archivo contiene, separados por espacios: <nombre_equipo> <clave> <valor>. Cada valor debe especificarse en su propia línea. Cada línea debe contener 3 entradas separadas por espacios: <nombre_equipo> <clave> <valor>, donde "nombre_equipo" es el nombre del equipo monitorizado tal como está registrado en el frontend de Zabbix, "clave" es la clave de la métrica objetivo y "valor" es el valor a enviar. Especifique - como <nombre_equipo> para usar el nombre de equipo del archivo de configuración del agente o del argumento --host.

Un ejemplo de línea de un archivo de entrada:

"Linux DB3" db.connections 43

El tipo de valor debe estar correctamente configurado en la configuración de la métrica en el frontend de Zabbix. Zabbix sender enviará hasta 250 valores en una conexión. El límite de tamaño para enviar valores desde un archivo de entrada depende del tamaño descrito en el protocolo de comunicación de Zabbix. El contenido del archivo de entrada debe estar en codificación UTF-8. Todos los valores del archivo de entrada se envían en orden secuencial de arriba a abajo. Las entradas deben formatearse utilizando las siguientes reglas:

Se admiten entradas entrecomilladas y sin comillas.
La comilla doble es el carácter de entrecomillado.
Las entradas con espacios deben ir entrecomilladas.
Los caracteres de comilla doble y barra invertida dentro de una entrada entrecomillada deben escaparse con una barra invertida.
No se admite el escape en entradas sin comillas.
Se admiten secuencias de escape de salto de línea (\n) en cadenas entrecomilladas.
Las secuencias de escape de salto de línea se eliminan del final de una entrada.

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

Cada línea del archivo de entrada debe contener 4 entradas separadas por espacios: <nombre_equipo> <clave> <marca_de_tiempo> <valor>. La marca de tiempo debe especificarse en formato de timestamp Unix. Si la métrica objetivo tiene disparadores que la referencian, todas las marcas de tiempo deben estar en orden ascendente, de lo contrario el cálculo de eventos no será correcto.

Un ejemplo de línea del archivo de entrada:

"Linux DB3" db.connections 1429533600 43

Para más detalles, consulte la opción --input-file.

Si se envía un valor con marca de tiempo para un equipo que está en un tipo de mantenimiento "sin datos", este valor se descartará; sin embargo, es posible enviar un valor con marca de tiempo para un periodo de mantenimiento expirado y será aceptado.

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

Cada línea del archivo de entrada debe contener 5 entradas separadas por espacios: <nombre_equipo> <clave> <marca_de_tiempo> <ns> <valor>.

Un ejemplo de línea del archivo de entrada:

"Linux DB3" db.connections 1429533600 7402561 43

Para más detalles, consulte la opción --input-file.

-r, --real-time
Envía los valores uno por uno tan pronto como se reciben. Esto puede usarse al leer desde la entrada estándar.

-g, --group
Agrupa los valores por equipos y los envía a cada equipo en un lote separado.

--tls-connect valor
Cómo conectarse al servidor o proxy. Valores:

unencrypted
conectar sin cifrado (por defecto)

psk
conectar usando TLS y una clave precompartida

cert
conectar usando TLS y un certificado

--tls-ca-file CA-file
Ruta completa de un archivo que contiene los certificados de CA(s) de nivel superior para la verificación del certificado del par.

--tls-crl-file CRL-file
Ruta completa de un archivo que contiene certificados revocados.

--tls-server-cert-issuer cert-issuer
Emisor permitido del certificado del servidor.

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

--tls-cert-file cert-file
Ruta completa de un archivo que contiene el certificado o la cadena de certificados.

--tls-key-file key-file
Ruta completa de un archivo que contiene la clave privada.

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

--tls-psk-file PSK-file
Ruta completa de un archivo que contiene la clave precompartida.

--tls-cipher13 cipher-string
Cadena de cifrado para OpenSSL 1.1.1 o superior para TLS 1.3. Sobrescribe los criterios de selección de la suite de cifrado por defecto. Esta opción no está disponible si la versión de OpenSSL es menor que 1.1.1.

--tls-cipher cipher-string
Cadena de prioridad GnuTLS (para TLS 1.2 y superior) o cadena de cifrado OpenSSL (solo para TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado por defecto.

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

-h, --help
Muestra esta ayuda y sale.

-V, --version
Muestra la información de la versión y sale.

ESTADO DE SALIDA

El estado de salida es 0 si los valores fueron enviados y todos ellos fueron procesados correctamente por el servidor. Si se enviaron datos, pero el procesamiento de al menos uno de los valores falló, el estado de salida es 2. Si el envío de datos falló, el estado de salida es 1.

EJEMPLOS

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

Enviar 342.45 como el valor para la métrica mysql.queries del equipo monitorizado. Utiliza el equipo monitorizado y el servidor Zabbix definidos en el archivo de configuración del agente.

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

Enviar 342.45 como el valor para la métrica mysql.queries del equipo Monitored Host utilizando el servidor Zabbix definido en el archivo de configuración del agente.

zabbix_sender -z 192.168.1.113 -i data_values.txt

Enviar los valores del archivo data_values.txt al servidor Zabbix con IP 192.168.1.113. Los nombres de los equipos 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 -

Enviar un valor con marca de tiempo desde la línea de comandos al servidor Zabbix, especificado en el archivo de configuración del agente. El guion en los datos de entrada indica que el nombre del equipo también debe usarse desde el mismo archivo de configuración.

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

Enviar un valor vacío de una métrica al servidor Zabbix con dirección IP 192.168.1.113 en el puerto 10000 desde la línea de comandos. Los valores vacíos deben indicarse con comillas dobles vacías.

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

Enviar 342.45 como el valor para la métrica mysql.queries en el equipo Monitored Host al servidor 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

Enviar 342.45 como el valor para la métrica mysql.queries en el equipo Monitored Host al servidor con IP 192.168.1.113 usando TLS con clave precompartida (PSK).