zabbix_get

Sección: Comandos de usuario (1)
Actualizado: 2021-06-01
Índice Volver al contenido principal

NOMBRE

zabbix_get - Utilidad de obtención de Zabbix

SINOPSIS

zabbix_get -s nombre-equipo-o-IP [-p número-puerto] [-I dirección-IP] [-t timeout] -k clave-métrica
zabbix_get -s nombre-equipo-o-IP [-p número-puerto] [-I dirección-IP] [-t timeout] --tls-connect cert --tls-ca-file archivo-CA [--tls-crl-file archivo-CRL] [--tls-agent-cert-issuer emisor-certificado] [--tls-agent-cert-subject sujeto-certificado] --tls-cert-file archivo-certificado --tls-key-file archivo-clave [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] -k clave-métrica
zabbix_get -s nombre-equipo-o-IP [-p número-puerto] [-I dirección-IP] [-t timeout] --tls-connect psk --tls-psk-identity identidad-PSK --tls-psk-file archivo-PSK [--tls-cipher13 cadena-cifrado] [--tls-cipher cadena-cifrado] -k clave-métrica
zabbix_get -h
zabbix_get -V

DESCRIPCIÓN

zabbix_get es una utilidad de línea de comandos para obtener datos del agente de Zabbix.

OPCIONES

-s, --host nombre-equipo-o-IP
Especifica el nombre del equipo o la dirección IP de un equipo.

-p, --port número-puerto
Especifica el número de puerto del agente que se ejecuta en el equipo. El valor predeterminado es 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 (predeterminado: 30)

-k, --key clave-métrica
Especifica la clave de la métrica para recuperar su valor.

-P, --protocol valor
Protocolo utilizado para comunicarse con el agente. Valores:

auto conectar usando el protocolo JSON, si falla intenta con el protocolo de texto plano (predeterminado)

json conectar usando el protocolo JSON

plaintext conectar usando el protocolo de texto plano donde solo se envía la clave de la métrica (versiones 6.4.x y anteriores)

--tls-connect valor
Cómo conectarse al agente. Valores:

sin cifrar
conectar sin cifrado (por defecto)

psk
conectar usando TLS y una clave precompartida

cert
conectar usando TLS y un certificado

--tls-ca-file CA-file
Ruta completa de un archivo que contiene los certificados de la(s) CA(s) de nivel superior 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 de certificado de agente permitido.

--tls-agent-cert-subject cert-subject
Sujeto de certificado de agente 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 de identidad PSK.

--tls-psk-file PSK-file
Ruta completa de un archivo que contiene la clave precompartida.

--tls-cipher13 cipher-string
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 cipher-string
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 defecto.

-h, --help
Muestra esta ayuda y sale.

-V, --version
Muestra la información de la versión y sale.

EJEMPLOS

zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix_get.crt --tls-key-file /home/zabbix/zabbix_get.key
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix_agentd.psk