Table of Contents
7 Obtener
Descripción general
Zabbix get es una utilidad de línea de comandos que puede utilizarse para comunicarse con el agente de Zabbix y recuperar la información requerida del agente.
Normalmente, la utilidad se utiliza para la resolución de problemas de los agentes de Zabbix.
Consulte también zabbix_utils, una biblioteca de Python que tiene funcionalidad incorporada para actuar como Zabbix get.
Ejecutando Zabbix get
Un ejemplo de ejecución de Zabbix get en UNIX para obtener el valor de carga del procesador desde el agente:
Otro ejemplo de ejecución de Zabbix get para capturar una cadena de un sitio web:
cd bin
./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"USA: ([a-zA-Z0-9.-]+)\",,\1]"Tenga en cuenta que la clave del elemento aquí contiene un espacio, por lo que se utilizan comillas para marcar la clave del elemento en el shell. Las comillas no forman parte de la clave del elemento; serán eliminadas por el shell y no se pasarán al agente Zabbix.
Si una clave de elemento no es compatible, Zabbix get devolverá el código de salida 1.
Zabbix get acepta los siguientes parámetros de línea de comandos:
-s --host <nombre de host o IP> Especifica el nombre de host o la dirección IP de un host
-p --port <número de puerto> Especifica el número de puerto del agente que se ejecuta en el host (por defecto: 10050)
-I --source-address <dirección IP> Especifica la dirección IP de origen
-t --timeout <segundos> Especifica el tiempo de espera. Rango válido: 1-600 segundos (por defecto: 30 segundos)
-k --key <clave de elemento> Especifica la clave del elemento para recuperar el valor
-P --protocol <valor> Protocolo utilizado para comunicarse con el agente. Valores:
auto - conecta usando el protocolo JSON, retrocede y reintenta con el protocolo de texto plano (por defecto)
json - conecta usando el protocolo JSON
plaintext - conecta usando el protocolo de texto plano donde solo se envía la clave del elemento (versiones 6.4.x y anteriores)
-h --help Muestra este mensaje de ayuda
-V --version Muestra el número de versión
--tls-connect <valor> Cómo conectarse 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 de un archivo que contiene los certificados de CA de nivel superior para la verificación del certificado del par
--tls-crl-file <archivo CRL> Ruta completa de un archivo que contiene certificados revocados
--tls-agent-cert-issuer <emisor cert> Emisor de certificado de agente permitido
--tls-agent-cert-subject <sujeto cert> Sujeto de certificado de agente permitido
--tls-cert-file <archivo cert> Ruta completa de un archivo que contiene el certificado o la cadena de certificados
--tls-key-file <archivo clave> Ruta completa de un archivo que contiene la clave privada
--tls-psk-identity <identidad PSK> Cadena única y sensible a mayúsculas utilizada para identificar la clave precompartida
--tls-psk-file <archivo PSK> Ruta completa de un archivo que contiene la clave precompartida
--tls-cipher13 <cadena-cifrado> 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 inferior a 1.1.1
--tls-cipher <cadena-cifrado> Cadena de prioridad GnuTLS (para TLS 1.2 y superiores) o cadena de cifrado OpenSSL (solo para TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado por defectoConsulte también la página de manual de Zabbix get para más información.
Zabbix get en Windows puede ejecutarse de manera similar: