zabbix_sender
Sección: Comandos de usuario (1)
Actualizado en: 2021-06-01
Índice Volver a contenidos principales
[ ]{#lbAB}
NOMBRE
zabbix_sender - Utilidad del transmisor Zabbix [ ]{#lbAC}
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] [-g] -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] [-g] -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] [-g] -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] [-g] -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] [-g] -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] [-g]
-i input-file
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}
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. [ ]{#lbAE}
OPCIONES
-c, --config archivo-configuración
Utilizar archivo-configuración. Zabbix sender lee los detalles del server 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, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity y TLSPSKFile.
El nombre de host definido a través del parámetro HostnameItem no se tendrá en cuenta, en este caso el nombre de host debe especificarse a través de la línea de comandos (ver opción -s).
Todas las direcciones definidas en el parámetro de configuración ServerActive del agent 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 esta dirección.
-z, --zabbix-server server
Nombre de host o dirección IP del server de Zabbix. Si un host es monitorizado por un proxy, se debe utilizar el nombre de host o la dirección IP del proxy. Cuando se utiliza junto con --config, sobrescribe las entradas del parámetro ServerActive especificadas en el archivo de configuración de agentd.
-p, --port puerto
Especificar el número de puerto del trapper del server de Zabbix que se ejecuta en el server. El valor predeterminado es 10051. Cuando se utiliza junto con --config, sobrescribe las entradas de puerto del parámetro ServerActive especificadas en el archivo de configuración de agentd.
-I, --source-address dirección-IP
Especificar la dirección IP de origen. Cuando se utiliza junto con --config, sobrescribe el parámetro SourceIP especificado en el archivo de configuración de agentd.
-t, --timeout segundos
Especificar el tiempo de espera. Rango válido: 1-300 segundos (por defecto: 60)
-s, --host host
Especificar el nombre de host al que pertenece el item (tal como está registrado en el frontend de Zabbix). La dirección IP y el nombre DNS del host no funcionarán. Cuando se utiliza junto con --config, sobrescribe el parámetro Hostname especificado en el archivo de configuración de agentd.
-k, --key clave
Especificar la clave del item al que enviar el valor.
-o, --value valor
Especificar el valor del item.
-i, --input-file archivo-entrada
Cargar valores desde un archivo de entrada. Especifique - como <archivo-entrada> para leer valores desde la entrada estándar. Cada línea del archivo contiene delimitados por espacios en blanco: <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 host monitorizado tal como está registrado en el frontend de Zabbix, "clave" es la clave del item de destino y "valor" es el valor a enviar. Especifique - como <nombre-host> para usar el nombre de host del archivo de configuración del agent 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 establecerse correctamente en la configuración del item 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 no entrecomilladas.
- La comilla doble es el carácter de entrecomillado.
- Las entradas con espacios en blanco 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 las entradas no entrecomilladas.
- 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 se puede usar con la opción --input-file.
Cada línea del archivo de entrada debe contener 4 entradas delimitadas por espacios en blanco: <nombre-host> <clave> <marca-tiempo> <valor>. La marca de tiempo debe especificarse en formato de marca de tiempo Unix. Si el item de destino tiene triggers que lo referencian, todas las marcas de tiempo deben estar en orden ascendente, 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 más detalles, consulte la opción --input-file.
Si se envía un valor con marca de tiempo para un host 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 período de mantenimiento expirado y será aceptado.
-N, --with-ns
Esta opción solo se puede usar con la opción --with-timestamps.
Cada línea del archivo de entrada debe contener 5 entradas delimitadas por espacios en blanco: <nombre-host> <clave> <marca-tiempo> <ns> <valor>.
Un ejemplo de una 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
Enviar valores uno por uno tan pronto como se reciban. Esto se puede usar al leer desde la entrada estándar.
-g, --group
Agrupar valores por hosts y enviar a cada host en un lote separado.
--tls-connect valor
Cómo conectarse al server o proxy. Valores:
[ ]{#lbAF}
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.
[ ]{#lbAG}
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.
[ ]{#lbAH}
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).
[ ]{#lbAI}
VER TAMBIÉN
Documentación https://www.zabbix.com/manuals
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_servidor(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8) [ ]{#lbAJ}
Índice
Este documento ha sido creado a las 08:42:39 GMT del 11 de junio de 2021