Documentation
Table of Contents
7 Obtener
Descripción general
Zabbix get es una utilidad de línea de comandos que se puede utilizar para comunicarse con el agente de Zabbix y recuperar la información requerida del agente.
La utilidad se utiliza generalmente para la resolución de problemas de los agentes de Zabbix.
Consulte también zabbix_utils, una biblioteca de Python que tiene una funcionalidad integrada 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 ítem aquí contiene un espacio, por lo que se utilizan comillas para marcar la clave del ítem en el shell. Las comillas no forman parte de la clave del ítem; serán eliminadas por el shell y no se pasarán al agente Zabbix.
Si una clave de ítem 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> Especificar el nombre de host o la dirección IP de un host
-p --port <número de puerto> Especificar el número de puerto del agente que se ejecuta en el host (por defecto: 10050)
-I --source-address <dirección IP> Especificar la dirección IP de origen
-t --timeout <segundos> Especificar el tiempo de espera. Rango válido: 1-30 segundos (por defecto: 30 segundos)
-k --key <clave de ítem> Especificar la clave del ítem para recuperar el valor
-P --protocol <valor> Protocolo utilizado para comunicarse con el agente. Valores:
auto - conectar usando el protocolo JSON, retroceder y reintentar con el protocolo de texto plano (por defecto)
json - conectar usando el protocolo JSON
plaintext - conectar usando el protocolo de texto plano donde solo se envía la clave del ítem (versiones 6.4.x y anteriores)
-h --help Mostrar este mensaje de ayuda
-V --version Mostrar el número de versión
--tls-connect <valor> Cómo conectarse al agente. Valores:
unencrypted - conectar sin cifrado (por defecto)
psk - conectar usando TLS y una clave precompartida
cert - conectar 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, sensible a mayúsculas y minú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 GnuTLS (para TLS 1.2 y superior) 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 obtener más información.
Zabbix get en Windows se puede ejecutar de manera similar: