Obtener

Descripción general

Zabbix get es una utilidad de línea de comandos que se puede usar para comunicarse con el agent de Zabbix y recuperar la información requerida del agent.

La utilidad se usa normalmente para la resolución de problemas de los agents de Zabbix.

Consulte también la biblioteca de Python para Zabbix, que tiene funcionalidad integrada para actuar como Zabbix get.

Ejecutar Zabbix get

Un ejemplo de ejecución de Zabbix get en UNIX para obtener el valor de carga del procesador desde el agent:

cd bin
./zabbix_get -s 127.0.0.1 -p 10050 -k system.cpu.load[all,avg1]

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 item aquí contiene un espacio, por lo que se usan comillas para marcar la clave del item para la shell. Las comillas no forman parte de la clave del item; la shell las recortará y no se pasarán al agent de Zabbix.

Si una clave de item 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 <host name or IP>             Especifica el nombre de host o la dirección IP de un host
-p --port <port number>                 Especifica el número de puerto del agent que se ejecuta en el host (predeterminado: 10050)
-I --source-address <IP address>        Especifica la dirección IP de origen
-t --timeout <seconds>                  Especifica el tiempo de espera. Rango válido: 1-600 segundos (predeterminado: 30 segundos)
-k --key <item key>                     Especifica la clave del item del que se recuperará el valor
-P --protocol <value>                   Protocolo usado para comunicarse con el agent. Valores:
                                            auto - se conecta usando el protocolo JSON, con retroceso y reintento con el protocolo de texto plano (predeterminado)
                                            json - se conecta usando el protocolo JSON
                                            plaintext - se conecta usando el protocolo de texto plano, donde solo se envía la clave del item (versiones 6.4.x y anteriores)
-h --help                               Muestra este mensaje de ayuda
-V --version                            Muestra el número de versión

--tls-connect <value>                   Cómo conectarse al agent. Valores:
                                            unencrypted - se conecta sin cifrado (predeterminado)
                                            psk - se conecta usando TLS y una clave previamente compartida
                                            cert - se conecta usando TLS y un certificado
--tls-ca-file <CA file>                 Ruta completa de un archivo que contiene los certificados de la(s) CA raíz para la verificación del certificado del par
--tls-crl-file <CRL file>               Ruta completa de un archivo que contiene certificados revocados
--tls-agent-cert-issuer <cert issuer>   Emisor del certificado del agent permitido
--tls-agent-cert-subject <cert subject> Sujeto del certificado del agent permitido
--tls-cert-file <cert file>             Ruta completa de un archivo que contiene el certificado o la cadena de certificados
--tls-key-file <key file>               Ruta completa de un archivo que contiene la clave privada
--tls-psk-identity <PSK-identity>       Cadena única, sensible a mayúsculas y minúsculas, usada para identificar la clave previamente compartida
--tls-psk-file <PSK-file>               Ruta completa de un archivo que contiene la clave previamente compartida
--tls-cipher13 <cipher-string>          Cadena de cifrado para OpenSSL 1.1.1 o posterior para TLS 1.3. Anula los criterios de selección predeterminados del conjunto de cifrados. Esta opción no está disponible si la versión de OpenSSL es anterior a 1.1.1
--tls-cipher <cipher-string>            Cadena de prioridad de GnuTLS (para TLS 1.2 y superior) o cadena de cifrado de OpenSSL (solo para TLS 1.2). Anula los criterios de selección predeterminados del conjunto de cifrados

Consulte también la página de manual de Zabbix get para obtener más información.

Zabbix get en Windows se puede ejecutar de forma similar:

zabbix_get.exe [options]