Table of Contents
2 Agente
Visão geral
O agente Zabbix é implantado em um alvo de monitoramento para monitorar ativamente recursos locais e aplicativos (discos rígidos, memória, estatísticas do processador, etc.).
O agente coleta informações operacionais localmente e envia os dados para o servidor Zabbix para processamento posterior. Em caso de falhas (como um disco rígido ficando cheio ou um processo de serviço travado), o servidor Zabbix pode alertar ativamente os administradores da máquina em questão que reportou a falha.
Os agentes Zabbix são extremamente eficientes devido ao uso de chamadas de sistema nativas para coletar informações estatísticas.
Verificações passivas e ativas
Os agentes do Zabbix podem realizar verificações passivas e ativas.
Em uma passive check o agente responde a uma solicitação de dados. O servidor (ou proxy) do Zabbix solicita dados, por exemplo, carga de CPU, e o agente Zabbix envia o resultado de volta.
As Active checks exigem um processamento mais complexo. O agente deve primeiro obter uma lista de itens do servidor Zabbix para processamento independente. Em seguida, ele enviará periodicamente novos valores ao servidor.
A escolha entre realizar verificações passivas ou ativas é configurada selecionando o item type de monitoramento respectivo. O agente Zabbix processa itens do tipo 'Zabbix agent' ou 'Zabbix agent (active)'.
Plataformas suportadas
O Zabbix agente é suportado supported nas seguintes plataformas:
- Windows (todas as versões desktop e server desde o XP)
- Linux (também disponível em distribution packages)
- macOS
- IBM AIX
- FreeBSD
- OpenBSD
- Solaris
Também é possível baixar binários legados do agente Zabbix para NetBSD e HP-UX, sendo estes compatíveis com a versão atual do servidor/proxy Zabbix.
Agente em sistemas tipo UNIX
O agente Zabbix em sistemas tipo UNIX é executado no host que está sendo monitorado.
Instalação
Consulte a seção de package installation para instruções sobre como instalar o agente Zabbix como pacote.
Alternativamente, veja as instruções para instalação manual manual installation se você não quiser usar pacotes.
Em geral, agentes Zabbix de 32 bits funcionarão em sistemas de 64 bits, mas podem falhar em alguns casos.
Se instalado como pacote
O agente Zabbix é executado como um processo daemon. O agente pode ser iniciado executando:
Isso funcionará na maioria dos sistemas GNU/Linux. Em outros sistemas, você pode precisar executar:
Da mesma forma, para parar, reiniciar ou visualizar o status do agente Zabbix, use os seguintes comandos:
Inicialização manual
Se o método acima não funcionar, você precisará iniciá-lo manualmente. Encontre o caminho para o binário zabbix_agentd e execute:
Agente em sistemas Windows
O Zabbix Agent no Windows é executado como um Serviço do Windows.
Preparação
O agente Zabbix é distribuído como um arquivo zip. Após baixar o arquivo, você precisa descompactá-lo. Escolha qualquer pasta para armazenar o agente Zabbix e o arquivo de configuração, por exemplo:
Copie os arquivos bin\zabbix_agentd.exe e conf\zabbix_agentd.conf para c:\zabbix.
Edite o arquivo c:\zabbix\zabbix_agentd.conf conforme necessário, certificando-se de especificar corretamente o parâmetro "Hostname".
Instalação
Após isso, use o seguinte comando para instalar o agente Zabbix como serviço do Windows:
Agora você deverá ser capaz de configurar o serviço "Zabbix agent" normalmente, como qualquer outro serviço do Windows.
Veja mais detalhes more details sobre como instalar e executar o agente Zabbix no Windows.
Outras opções para o agente
É possível executar várias instâncias do agente em um host.
Uma única instância pode usar o arquivo de configuração padrão ou um arquivo de configuração especificado na linha de comando.
No caso de múltiplas instâncias, cada instância do agente deve ter seu próprio arquivo de configuração (uma das instâncias pode usar o arquivo de configuração padrão).
Os seguintes parâmetros de linha de comando podem ser usados com o agente Zabbix:
| Parâmetro | Descrição |
|---|---|
| Agente UNIX e Windows | |
| -c --config <arquivo-configuração> | Caminho para arquivo de configuração. Você pode usar esta opção para especificar um arquivo de configuração que não seja o padrão. No UNIX, o padrão é /usr/local/etc/zabbix_agentd.conf ou conforme definido por variáveis de tempo como compile-time --sysconfdir ou --prefix No Windows, o padrão é c:\zabbix_agentd.conf |
| -p --print | Imprimir os itens conhecidos e sair. Note: Para retornar resultados de user parameter é necessário especificar o arquivo de configuração (se ele não estiver no local padrão). |
| -t --test <item key> | Testar o item especificado e sair. Note: Para retornar resultados de user parameter é necessário especificar o arquivo de configuração (se ele não estiver no local padrão). |
| -h --help | Exibir informações de ajuda. |
| -V --version | Exibir o número da versão. |
| Somente para agentes UNIX | |
| -R --runtime-control <option> | Executar funções administrativas. Consulte runtime control. |
| Somente agentes para Windows | |
| -m --multiple-agents | Permite várias instâncias do agente (com as funções -i,-d,-s,-x). Para distinguir os nomes de serviço das instâncias, cada nome incluirá o valor de Hostname do arquivo de configuração especificado. |
| Somente para funções do agente Windows | |
| -i --install | Instalar o agente Zabbix para Windows como serviço. |
| -d --Desinstalar o serviço do agente Zabbix para Windows. | |
| -s --start | Iniciar o serviço do agente Zabbix para Windows. |
| -x --stop | Parar o serviço do agente Zabbix para Windows. |
Exemplos específicos de uso dos parâmetros de linha de comando:
- Imprimir todos os itens integrados do agente com valores
- Testar um parâmetro definido pelo usuário com a chave "mysql.ping" especificada no arquivo de configuração
- Instalar o serviço "Zabbix Agent" no Windows usando o caminho padrão para o arquivo de configuração c:\zabbix_agentd.conf
- Instalar o serviço "Zabbix Agent [Hostname]" no Windows usando o arquivo de configuração zabbix_agentd.conf localizado na mesma pasta que o executável do agente e tornar o nome do serviço único ao incluir o valor do Hostname do arquivo de configuração
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.confControle em tempo de execução
Com as opções de controle em tempo de execução, você pode alterar o nível de log dos processos do agente.
| Opção | Descrição | Alvo |
|---|---|---|
| log_level_increase[=<target>] | Aumenta o nível de log. Se nenhum alvo for especificado, todos os processos serão afetados. |
O alvo pode ser especificado como: tipo de processo - todos os processos do tipo especificado (por exemplo, listener). Consulte todos os tipos de processo do agente agent process types. tipo de processo,N - tipo de processo e número (por exemplo, listener,3) pid - identificador do processo (1 a 65535). Para valores maiores, especifique o alvo como 'tipo-de-processo,N'. |
| log_level_decrease[=<target>] | Reduz o nível de log. Se nenhum alvo for especificado, todos os processos serão afetados. |
|
| userparameter_reload | Recarrega os valores das opções UserParameter e Include a partir do arquivo de configuração atual. |
Exemplos:
- Aumentar o nível de log de todos os processos
- Aumentar o nível de log do terceiro processo listener
- Aumentar o nível de log do processo com PID 1234
- Reduzir o nível de log de todos os processos de active checks
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"O controle em tempo de execução não é suportado em OpenBSD, NetBSD e Windows.
Tipos de processos do agente
active checks- processo responsável por realizar verificações ativascollector- processo responsável pela coleta de dadoslistener- processo responsável por escutar verificações passivas
O arquivo de log do agente pode ser usado para monitorar esses tipos de processos.
Usuário do processo
O agente Zabbix no UNIX é projetado para ser executado como um usuário não root. Ele será executado como qualquer usuário não root que o iniciar. Portanto, você pode executar o agente como qualquer usuário não root sem problemas.
Se você tentar executá-lo como "root", ele será alterado para o usuário "zabbix", que deve estar presente no sistema. Você só pode executar o agente como "root" se modificar o parâmetro "AllowRoot" no arquivo de configuração do agente.
Arquivo de configuração
Para obter detalhes sobre a configuração do agente Zabbix, consulte as opções de configuração para zabbix_agentd ou Windows agent.
Localização
Observe que o agente requer uma configuração de localidade (locale) em UTF-8 para que alguns itens textuais do agente possam retornar o conteúdo esperado. A maioria dos sistemas modernos do tipo Unix já utiliza UTF-8 como padrão; no entanto, em alguns sistemas, pode ser necessário configurá-lo especificamente.
Código de saída
Antes da versão 2.2, o agente Zabbix retornava 0 em caso de saída bem-sucedida e 255 em caso de falha. A partir da versão 2.2 e superiores, o agente Zabbix retorna 0 em caso de saída bem-sucedida e 1 em caso de falha.