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.
Ejecutar Zabbix get
Un ejemplo de ejecución de Zabbix get bajo UNIX para obtener el valor de la 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 entrecomillar la clave de la métrica para el shell. Las comillas no forman parte de la clave de la métrica; serán recortadas por el shell y no se pasarán al agente de Zabbix.
Zabbix get acepta los siguientes parámetros de línea de comando:
-s --host <nombre de equipo o IP> Especifique el nombre de equipo o la dirección IP de un equipo.
-p --port <número de puerto> Especifique el número de puerto del agente que se ejecuta en el equipo. El valor predeterminado es 10050.
-I --source-address <dirección IP> Especifique la dirección IP de origen.
-t --timeout <segundos> Especifica el tiempo de espera. Rango válido: 1-30 segundos (predeterminado: 30 segundos).
-k --key <clave del elemento> Especifica la clave de la métrica para recuperar el valor.
-P --protocol <valor> Protocolo utilizado para comunicarse con el agente. Valores:
auto - conexión mediante el protocolo JSON, respaldo y reintento con el protocolo de texto sin formato (predeterminado)
json - conectarse usando el protocolo JSON
plaintext - conexión mediante el protocolo de texto sin formato donde solo se envía la clave del lamétrica (versiones 6.4.x y anteriores)
-h --help Dar esta ayuda.
-V --version Muestra el número de versión.
-tls-connect <valor> Cómo conectarse al agente. Valores:
unencrypted: conectarse sin cifrado (predeterminado)
psk: conéctese mediante TLS y una clave previamente compartida
cert: conexión mediante TLS y un certificado
--tls-ca-file <archivo CA> Nombre de ruta completo de un archivo que contiene los certificados de CA de nivel superior para la verificación de certificados entre pares
--tls-crl-file <archivo CRL> Ruta de acceso completa de un archivo que contiene certificados revocados
--tls-agent-cert-issuer <emisor del certificado> Emisor del certificado de agente permitido--tls-agent-cert-subject <asunto del certificado> Asunto del certificado del agente permitido
--tls-cert-file <archivo de certificado> Nombre de ruta completo de un archivo que contiene el certificado o la cadena de certificados
--tls-key-file <archivo de clave> Nombre de ruta completo de un archivo que contiene la clave privada--tls-psk-identity <PSK-identity> Cadena única que distingue entre mayúsculas y minúsculas y se utiliza para identificar la clave previamente compartida
--tls-psk-file <archivo PSK> Ruta de acceso completa de un archivo que contiene la clave previamente compartida
--tls-cipher13 <cadena-cifrado> Cadena de cifrado para OpenSSL 1.1.1 o posterior para TLS 1.3. Anule los criterios de selección predeterminados del conjunto de cifrado. 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 versiones posteriores) o cadena de cifrado OpenSSL (solo para TLS 1.2). Anular los criterios de selección predeterminados del conjunto de cifradoConsulte también Zabbix get manpage para obtener más información.
Zabbix get en Windows se puede ejecutar de manera similar: