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 datos de monitorización al server o proxy de Zabbix. En el server de Zabbix debe crearse un item de tipo Zabbix trapper con la clave correspondiente. Tenga en cuenta que los valores entrantes solo se aceptarán de los hosts especificados en el campo Allowed hosts para este item. [ ]{#lbAE}

OPCIONES

-c, --config config-file
Usar config-file. Zabbix sender lee los detalles del server desde el archivo de configuración de agentd. De forma 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. No se tomará el Hostname definido mediante el parámetro HostnameItem; en este caso, el nombre del host debe especificarse mediante la línea de comandos (consulte la 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 enviarán a esa dirección.

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

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

-I, --source-address IP-address
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 seconds
Especifica el tiempo de espera. Rango válido: 1-300 segundos (predeterminado: 60)

-s, --host host
Especifica el nombre del 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 usa junto con --config, sobrescribe el parámetro Hostname especificado en el archivo de configuración de agentd.

-k, --key key
Especifica la clave del item al que se enviará el valor.

-o, --value value
Especifica el valor del item.

-i, --input-file input-file
Carga valores desde el archivo de entrada. Especifique - como <input-file> para leer valores desde la entrada estándar. Cada línea del archivo contiene entradas delimitadas por espacios en blanco: <hostname> <key> <value>. Cada valor debe especificarse en su propia línea. Cada línea debe contener 3 entradas delimitadas por espacios en blanco: <hostname> <key> <value>, donde "hostname" es el nombre del host monitoreado tal como está registrado en el frontend de Zabbix, "key" es la clave del item de destino y "value" es el valor que se enviará. Especifique - como <hostname> para usar el nombre del 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 estar configurado correctamente en la configuración del item en el frontend de Zabbix. Zabbix sender enviará hasta 250 valores en una sola 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 hacia abajo. Las entradas deben formatearse usando las siguientes reglas:

Se admiten entradas entre comillas y sin comillas.
La comilla doble es el carácter de entrecomillado.
Las entradas con espacios en blanco deben ir entre comillas.
Los caracteres de comilla doble y barra invertida dentro de una entrada entre comillas deben escaparse con una barra invertida.
El escape no se admite en entradas sin comillas.
Se admiten secuencias de escape de salto de línea (\n) en cadenas entre comillas.
Las secuencias de escape de salto de línea se recortan 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 delimitadas por espacios en blanco: <hostname> <key> <timestamp> <value>. La marca de tiempo debe especificarse en formato de marca de tiempo Unix. Si el item de destino tiene triggers que hacen referencia a él, todas las marcas de tiempo deben estar en orden ascendente; de lo contrario, el cálculo de eventos 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 mantenimiento de tipo “sin datos”, este valor se descartará; sin embargo, es posible enviar un valor con marca de tiempo para un período de mantenimiento ya 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 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 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 hosts y los envía a cada host en un lote separado.

--tls-connect value
Cómo conectarse al server o proxy. Valores:

[ ]{#lbAF}

sin cifrado
conectar sin cifrado (predeterminado)

<!-- -->

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 la CA o CA 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 server.

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

--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 posterior para TLS 1.3. Anula los criterios predeterminados de selección del conjunto de cifrado. Esta opción no está disponible si la versión de OpenSSL es inferior a 1.1.1.

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

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

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

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

[ ]{#lbAG}

ESTADO DE SALIDA

El estado de salida es 0 si los valores se enviaron y todos ellos fueron procesados correctamente por el server. Si los datos se enviaron, 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.

[ ]{#lbAH}

EJEMPLOS

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

Enviar 342.45 como el valor del item mysql.queries del host monitorizado. Utilice el host monitorizado y el servidor Zabbix definidos en el archivo de configuración del agent.

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

Enviar 342.45 como el valor del item mysql.queries del host Monitored Host utilizando el servidor Zabbix definido en el archivo de configuración del agent.

zabbix_sender -z 192.168.1.113 -i data_values.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 están definidos 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 agent. El guion en los datos de entrada indica que el nombre del host también debe utilizarse 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 un item 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 del item mysql.queries en el host Monitored Host al server 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 del item mysql.queries en el host Monitored Host al server con IP 192.168.1.113 usando TLS con clave precompartida (PSK).

[ ]{#lbAI}