zabbix_get

Sección: Comandos de usuario (1)
Actualizado: 2021-06-01
Índice Volver a Contenidos Principales

NOMBRE

zabbix_get - Utilidad de obtención de Zabbix

SINOPSIS

zabbix_get -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] -k item-key
zabbix_get -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file] [--tls-agent-cert-issuer cert-issuer] [--tls-agent-cert-subject cert-subject] --tls-cert-file cert-file --tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
zabbix_get -s host-name-or-IP [-p port-number] [-I IP-address] [-t timeout] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
zabbix_get -h
zabbix_get -V

DESCRIPCIÓN

zabbix_get es una utilidad de línea de comandos para obtener datos del agente Zabbix.

OPCIONES

-s, --host nombre-de-equipo-o-IP
Especifica el nombre de equipo o dirección IP de un equipo.

-p, --port número-de-puerto
Especifica el número del puerto del agente que se ejecuta en el equipo. Por defecto es el 10050.

-I, --source-address dirección-IP
Especifica una dirección IP origen.

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

-k, --key clave-de-la-métrica
Especifica la clave de la métrica de la que se desea recibir el valor.

-P, --protocol valor Protocolo usado para comunicar con el agente. Valores:

auto conecta usado el protocolo JSON, si no puede, lo reintenta usando el protocolo de texto (por defecto)

json conecta usando el protocolo JSON

plaintext conecta usando el protocolo de texto sin formato donde solamente se envia la clave de la métrica (versiones 6.4 y posteriores)

--tls-connect valor
Cómo conectar al agente. Valores:

unencrypted
conecta sin cifrado (por defecto)

psk
conecta usando TLS y una clave precompartida

cert
conecta usando TLS y un certificado

--tls-ca-file archivo-CA
Ruta completa a un archivo que contenga los certificados de las CA(s) de nivel superior para la verificación de pares.

--tls-crl-file archivo-CRL
Ruta completa a un archivo que contenga los certificados revocados.

--tls-agent-cert-issuer emisor-cert
Emisor del certificado del agente permitido.

--tls-agent-cert-subject asunto-cert
Asunto del certificado del agente permitido.

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

--tls-key-file archivo-clave
Ruta completa a un archivo que contenga la clave privada.

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

--tls-psk-file archivo-PSK
Ruta completa a un archivo que contenga la clave precompartida.

--tls-cipher13 cadena-del-cifrado
Cadena del cifrado para OpenSSL 1.1.1 o superior para TLS 1.3. Anula los criterios de selección por defecto del conjunto de cifrados. Esta opción no está disponible si la versión de OpenSSL es inferior a 1.1.1.

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

-h, --help
Muestra esta ayuda y termina la ejecución.

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

EJEMPLOS

zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix_get.crt --tls-key-file /home/zabbix/zabbix_get.key
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix_agentd.psk