Table of Contents
7 Obter
Visão geral
Zabbix get é uma ferramenta de linha de comando, que pode ser usada para se comunicar com o agent do Zabbix e recuperar informações necessárias do agent.
A ferramenta geralmente é usada para solução de problemas de agents do Zabbix.
Veja também zabbix_utils - uma biblioteca Python que possui funcionalidade integrada para agir como o Zabbix get.
Executando o Zabbix get
Um exemplo de execução do Zabbix get em UNIX para obter o valor de carga do processador do agent:
Outro exemplo de execução do Zabbix get para capturar uma string de um site:
cd bin
./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"USA: ([a-zA-Z0-9.-]+)\",,\1]"Observe que a chave do item aqui contém um espaço, então aspas são usadas para marcar a chave do item para o shell. As aspas não fazem parte da chave do item; elas serão removidas pelo shell e não serão passadas para o agent do Zabbix.
Se uma chave de item não for suportada, o Zabbix get retornará o código de saída 1.
O Zabbix get aceita os seguintes parâmetros de linha de comando:
-s --host <host name or IP> Especifica o nome do host ou endereço IP de um host
-p --port <port number> Especifica o número da porta do agent em execução no host (padrão: 10050)
-I --source-address <IP address> Especifica o endereço IP de origem
-t --timeout <seconds> Especifica o tempo limite. Faixa válida: 1-600 segundos (padrão: 30 segundos)
-k --key <item key> Especifica a chave do item para recuperar o valor
-P --protocol <value> Protocolo usado para se comunicar com o agent. Valores:
auto - conecta usando o protocolo JSON, faz fallback e tenta novamente com o protocolo em texto simples (padrão)
json - conecta usando o protocolo JSON
plaintext - conecta usando o protocolo em texto simples, onde apenas a chave do item é enviada (versões 6.4.x e anteriores)
-h --help Exibe esta mensagem de ajuda
-V --version Exibe o número da versão
--tls-connect <value> Como conectar ao agent. Valores:
unencrypted - conecta sem criptografia (padrão)
psk - conecta usando TLS e uma chave pré-compartilhada
cert - conecta usando TLS e um certificado
--tls-ca-file <CA file> Caminho completo para um arquivo contendo o(s) certificado(s) da(s) CA(s) de nível superior para verificação do certificado do peer
--tls-crl-file <CRL file> Caminho completo para um arquivo contendo certificados revogados
--tls-agent-cert-issuer <cert issuer> Emissor do certificado do agent permitido
--tls-agent-cert-subject <cert subject> Sujeito do certificado do agent permitido
--tls-cert-file <cert file> Caminho completo para um arquivo contendo o certificado ou cadeia de certificados
--tls-key-file <key file> Caminho completo para um arquivo contendo a chave privada
--tls-psk-identity <PSK-identity> String exclusiva e sensível a maiúsculas/minúsculas usada para identificar a chave pré-compartilhada
--tls-psk-file <PSK-file> Caminho completo para um arquivo contendo a chave pré-compartilhada
--tls-cipher13 <cipher-string> String de cifra para OpenSSL 1.1.1 ou mais recente para TLS 1.3. Substitui os critérios padrão de seleção de ciphersuite. Esta opção não está disponível se a versão do OpenSSL for inferior a 1.1.1
--tls-cipher <cipher-string> String de prioridade do GnuTLS (para TLS 1.2 ou superior) ou string de cifra do OpenSSL (apenas para TLS 1.2). Substitui os critérios padrão de seleção de ciphersuiteVeja também a manpage do Zabbix get para mais informações.
O Zabbix get no Windows pode ser executado de forma semelhante: