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 agente Zabbix é suportado por:
- Linux
- IBM AIX
- FreeBSD
- NetBSD
- OpenBSD
- HP-UX
- Mac OS X
- Solaris: 9, 10, 11
- Windows: 2000, Server 2003, XP, Vista, Server 2008, 7
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.
Códigos de saída
Antes da versão 2.2 do Zabbix o agente retornava 0 em caso de sucesso e 255 em caso de falha. A partir desta versão o agente passou a retornar 0 para sucesso e 1 para falha.
Runtime control
With runtime control options you may change the log level of agent processes.
| Option | Description | Target |
|---|---|---|
| log_level_increase[=<target>] | Increase log level. If target is not specified, all processes are affected. |
Target can be specified as: process type - all processes of specified type (e.g., listener) See all agent process types. process type,N - process type and number (e.g., listener,3) pid - process identifier (1 to 65535). For larger values specify target as 'process-type,N'. |
| log_level_decrease[=<target>] | Decrease log level. If target is not specified, all processes are affected. |
|
| userparameter_reload | Reload user parameters from the current configuration file. Note that UserParameter is the only agent configuration option that will be reloaded. |
|
Examples:
- increasing log level of all processes
- increasing log level of the third listener process
- increasing log level of process with PID 1234
- decreasing log level of all active check processes
shell> zabbix_agentd -R log_level_increase
shell> zabbix_agentd -R log_level_increase=listener,3
shell> zabbix_agentd -R log_level_increase=1234
shell> zabbix_agentd -R log_level_decrease="active checks"Runtime control is not supported on OpenBSD, NetBSD and Windows.
Agent process types
active checks- process for performing active checkscollector- process for data collectionlistener- process for listening to passive checks
The agent log file can be used to observe these process types.
Process user
Zabbix agent on UNIX is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run agent as any non-root user without any issues.
If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run agent as 'root' if you modify the 'AllowRoot' parameter in the agent configuration file accordingly.
Configuration file
For details on configuring Zabbix agent see the configuration file options for zabbix_agentd or Windows agent.
Locale
Note that the agent requires a UTF-8 locale so that some textual agent items can return the expected content. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically.
Exit code
Before version 2.2 Zabbix agent returned 0 in case of successful exit and 255 in case of failure. Starting from version 2.2 and higher Zabbix agent returns 0 in case of successful exit and 1 in case of failure.