Obter

Visão geral

Zabbix get é um utilitário de linha de comando que pode ser usado para se comunicar com o agent do Zabbix e recuperar as informações necessárias do agent.

O utilitário é normalmente usado para solucionar problemas em agents do Zabbix.

Veja também a biblioteca Python para Zabbix, que possui funcionalidade integrada para agir como o Zabbix get.

Executando o Zabbix get

Um exemplo de execução do Zabbix get no UNIX para obter o valor de carga do processador do agent:

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

Outro exemplo de execução do Zabbix get para capturar uma string de um website:

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 do 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 o 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. Intervalo válido: 1-600 segundos (padrão: 30 segundos)
-k --key <item key>                     Especifica a chave do item para a qual recuperar o valor
-P --protocol <value>                   Protocolo usado para se comunicar com o agent. Valores:
                                            auto - conecta usando o protocolo JSON, com fallback e nova tentativa usando o protocolo plaintext (padrão)
                                            json - conecta usando o protocolo JSON
                                            plaintext - conecta usando o protocolo plaintext, em que 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 se 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 de um arquivo contendo os certificados da CA de nível superior para verificação do certificado do par
--tls-crl-file <CRL file>               Caminho completo de um arquivo contendo certificados revogados
--tls-agent-cert-issuer <cert issuer>   Emissor do certificado do agent permitido
--tls-agent-cert-subject <cert subject> Assunto do certificado do agent permitido
--tls-cert-file <cert file>             Caminho completo de um arquivo contendo o certificado ou a cadeia de certificados
--tls-key-file <key file>               Caminho completo de um arquivo contendo a chave privada
--tls-psk-identity <PSK-identity>       String exclusiva, sensível a maiúsculas e minúsculas, usada para identificar a chave pré-compartilhada
--tls-psk-file <PSK-file>               Caminho completo de 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 do conjunto de cifras. 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 e superior) ou string de cifra do OpenSSL (somente para TLS 1.2). Substitui os critérios padrão de seleção do conjunto de cifras

Veja também a página de manual do Zabbix get para mais informações.

O Zabbix get no Windows pode ser executado de forma semelhante:

zabbix_get.exe [options]