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 de la métrica aquí contiene un espacio, por lo que se utilizan comillas para marcar la clave de la métrica en el shell. Las comillas no forman parte de la clave de la métrica; serán eliminadas por el shell y no se pasarán al agente Zabbix.
Si una clave de métrica 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 equipo o IP> Especifica el nombre de equipo o la dirección IP de un equipo
-p --port <número de puerto> Especifica el número de puerto del agente que se ejecuta en el equipo (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-30 segundos (por defecto: 30 segundos)
-k --key <clave de métrica> Especifica la clave de la métrica para recuperar el valor
-P --protocol <valor> Protocolo utilizado para comunicarse con el agente. Valores:
auto - conecta usando el protocolo JSON, si falla intenta 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 de la métrica (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 <asunto cert> Asunto 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 menor que 1.1.1
--tls-cipher <cadena-cifrado> Cadena de prioridad de GnuTLS (para TLS 1.2 y superior) o cadena de cifrado de OpenSSL (solo para TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado por defectoConsulte también la página man de Zabbix get para obtener más información.
Zabbix get en Windows puede ejecutarse de manera similar: