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 Use config-file. Zabbix sender lee los detalles del servidor desde el archivo de configuración de agentd. De manera predeterminada, Zabbix sender no lee ningún archivo de configuración. Solo se admiten los parámetros Hostname, 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 se seleccionará; en este caso, el nombre de equipo se debe especificar a través de la línea de comandos (consulte la opción -s). Todas las direcciones definidas en el parámetro de configuración ServerActive del agente se utilizan para enviar datos. Si falla el envío de datos por lotes a una dirección, los siguientes lotes no se envían a esta dirección.

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

-p, --port port Especifique el número de puerto del capturador del servidor Zabbix que se ejecuta en el servidor. El valor predeterminado es 10051. Cuando se usa junto con --config, anula las entradas de puerto del parámetro ServerActive especificado en el archivo de configuración de agentd.

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

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

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

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

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

-i, --input-file input-file Carga valores desde el archivo de entrada. Especifica - como <input-file> para leer valores desde la entrada estándar. Cada línea del archivo contiene espacios en blanco delimitados: <nombre_host> <clave> <valor>. Cada valor debe especificarse en su propia línea. Cada línea debe contener 3 entradas delimitadas por espacios en blanco: <nombre_host> <clave> <valor>, donde "nombre_host" es el nombre del equipo monitoreado tal como está registrado en la interfaz de Zabbix, "clave" es la clave de la métrica de destino y "valor" es el valor que se enviará.

Especifique - como <nombre_host> para usar el nombre de equipo del archivo de configuración del agente o del argumento --host.

Un ejemplo de una 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 de la interfaz de Zabbix. El remitente de Zabbix enviará hasta 250 valores en una conexión. 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 hacia abajo. Las entradas deben formatearse utilizando las siguientes reglas:

Se admiten entradas entre comillas y sin comillas.
Las comillas dobles son el carácter de comillas.
Las entradas con espacios en blanco deben estar entre comillas.
Los caracteres de comillas dobles y barra invertida dentro de una entrada entre comillas deben escaparse con una barra invertida.
No se admite el escape en entradas sin comillas.
Las secuencias de escape de salto de línea (\n) se admiten en cadenas entre comillas.
Las secuencias de escape de salto de línea se recortan desde el final de una entrada.

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

Cada línea del archivo de entrada debe contener 4 entradas delimitadas por espacios en blanco: <nombre_de_host> <clave> <marca_de_tiempo> <valor>. La marca de tiempo se debe especificar en formato de marca de tiempo Unix. Si la métrica de destino tiene iniciadores que le hacen referencia, todas las marcas de tiempo deben estar en orden creciente; de lo contrario, el cálculo del evento no será correcto.

Un ejemplo de una línea del archivo de entrada:

"Linux DB3" db.connections 1429533600 43

Para obtener 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”, se descartará este valor; sin embargo, es posible enviar un valor con marca de tiempo para un período de mantenimiento vencido y se aceptará.

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

Cada línea del archivo de entrada debe contener 5 entradas delimitadas por espacios en blanco: <hostname> <key> <timestamp> <ns> <value>.

Un ejemplo de una línea del archivo de entrada:

"Linux DB3" db.connections 1429533600 7402561 43

Para obtener 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 se puede utilizar al leer desde la entrada estándar.

--tls-connect value Cómo conectarse al servidor o 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).