Documentation
Table of Contents
3 Agente
Vis?o geral
O agente Áú»¢¶Ä²© ¨¦ instalado no dispositivo alvo da monitora??o. Possui capacidade de monitorar de monitorar ativamente os recursos e aplica??es locais (discos e parti??es, mem¨®ria, estat¨ªsticas do processador, etc).
O agente concentra as informa??es locais sobre o dispositivo monitorado para posterior envio ao servidor ou proxy Áú»¢¶Ä²© (dependendo da configura??o). Em caso de falhas (como um disco cheio ou a interrup??o de um processo) o servidor Áú»¢¶Ä²© pode alertar ativamente os administradores do ambiente sobre o ocorrido.
Os agentes Áú»¢¶Ä²© s?o extremamente eficientes pois utilizam chamadas nativas do sistema operacional para obter as informa??es estat¨ªsticas.
Verifica??es passivas e ativas
Os agentes Áú»¢¶Ä²© podem executar verifica??es passivas ou ativas.
Em uma verifica??o passiva o agente responde ¨¤ uma requisi??o de informa??es. O servidor ou o proxy Áú»¢¶Ä²© requisitam o dado toda vez que ¨¦ necess¨¢rio (uso de CPU, mem¨®ria, disco, etc), o agente responde com o resultado do teste solicitado.
O processo de verifica??o ativa requer um processamento mais complexo. O agente precisa primeiro receber a lista de itens a monitorar e o intervalo entre coletas pretendido. Esta informa??o vem do servidor Áú»¢¶Ä²© atrav¨¦s de requisi??es peri¨®dicas do agente.
A verifica??o ativa permite que o agente continue executando o perfil de monitora??o mesmo quando o servidor Áú»¢¶Ä²© est¨¢ indispon¨ªvel, enviando posteriormente e de forma retroativa o resultado dos testes.
A defini??o se a verifica??o deve ocorrer de forma passiva ou ativa ¨¦ configurada atrav¨¦s do tipo do item, na interface web do Áú»¢¶Ä²©. Um agente Áú»¢¶Ä²© pode processar itens do tipo 'Agente Áú»¢¶Ä²©' ou "Agente Áú»¢¶Ä²© (ativo)".
Plataformas suportadas
O agente Áú»¢¶Ä²© ¨¦ 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
Instala??o
Veja as instru??es de instala??o para o agente.
Em geral os agentes 32bits do Áú»¢¶Ä²© conseguir?o ser executados em ambientes 64bits, mas em alguns casos poder¨¢ ocorrer falha.
Processo do agente para UNIX (servi?o de segundo plano - daemon)
O agente Áú»¢¶Ä²© deve ser executado no host que se deseja monitorar. O agente Áú»¢¶Ä²© ¨¦ executado como um processo daemon.
Para iniciar o agente, execute:
S?o poss¨ª±¹±ð¾±²õ alguns par?metros na linha de comando do agente:
-c --config <arquivo> caminho absoluto (completo) para o arquivo de configura??o (o padr?o ¨¦ /etc/zabbix/zabbix_agentd.conf)
-R --runtime-control <op??o> executa fun??es administrativas
-h --help apresenta o help de par?metros
-V --version apresenta o n¨²mero de vers?o
-p --print apresenta todos os itens (chaves) poss¨ª±¹±ð¾±²õ
-t --test <chave do item> testa um item espec¨ªfico e retorna o resultadoO controle em tempo de execu??o n?o ¨¦ suportado em OpenBSD e em NetBSD.
Para obter este help, execute:
Outros exemplos com os par?metros em linha de comando:
shell> zabbix_agentd -c /usr/local/etc/zabbix_agentd.conf
shell> zabbix_agentd --help
shell> zabbix_agentd --print
shell> zabbix_agentd -t "system.cpu.load[all,avg1]"Controle em tempo de execu??o
Op??es de controle em tempo de execu??o:
| Op??o | Descri??o | Alvo |
|---|---|---|
| log_level_increase[=<alvo>] | Aumenta o n¨ªvel de log, afeta todos os processos se o alvo n?o for especificado. | pid - Identificador do processo (1 a 65535) tipo do processo - Restringe a todos os processos de determinado tipo (Ex.: poller) tipo do processo,N - Restringe a determinado processo de um tipo espec¨ªfico (Ex.: poller,3) |
| log_level_decrease[=<alvo>] | Reduz o n¨ªvel de log, afeta todos os processos se o alvo n?o for especificado. |
O PID do processo a se modificar o n¨ªvel de log dever¨¢ estar entre 1 e 65535. Em ambientes com muitos processos a modifica??o poder¨¢ ser feita em um processo espec¨ªfico.
Exemplo de utiliza??o do controle em tempo de execu??o para modificar o n¨ªvel de log:
Increase log level of all processes:
shell> zabbix_agentd -c /usr/local/etc/zabbix_agentd.conf -R log_level_increase
Aumenta o n¨ªvel de log do segundo processo do ouvinte (listener):
shell> zabbix_agentd -c /usr/local/etc/zabbix_agentd.conf -R log_level_increase=listener,2
Aumenta o n¨ªvel de log do processo com PID 1234:
shell> zabbix_agentd -c /usr/local/etc/zabbix_agentd.conf -R log_level_increase=1234
Reduz o n¨ªvel de log de todas os processos de verifica??o ativa:
shell> zabbix_agentd -c /usr/local/etc/zabbix_agentd.conf -R log_level_decrease="active checks"Processo de usu¨¢rio
O agente Áú»¢¶Ä²© foi desenhado para ser executado como um processo ¡°n?o-root¡±. Ele pode ser executado com a permiss?o do usu¨¢rio que o iniciou. Neste cen¨¢rio ele ir¨¢ executar sem nenhum problema.
Se voc¨º tentar inicia-lo com o usu¨¢rio 'root', ele alternar¨¢ seu permissionamento de execu??o para o usu¨¢rio 'zabbix', que dever¨¢ existir em seu ambiente. Voc¨º s¨® poder¨¢ rodar o Servidor Áú»¢¶Ä²© como 'root' se modificar o par?metro 'AllowRoot' no arquivo de configura??o.
Arquivo de configura??o
Veja as op??es do arquivo de configura??o para detalhes sobre sua configura??o.
Executando o agente em ambiente Microsoft Windows
Veja o manual do agente no Windows para detalhes sobre como instalar, configurar e executar o agente neste sistema operacional.
Sintaxe de linha de comando do agente no Windows:
zabbix_agentd.exe [-c arquivo-de-configura??o]
zabbix_agentd.exe [-c arquivo-de-configura??o] -p
zabbix_agentd.exe [-c arquivo-de-configura??o] -t chave-do-item
zabbix_agentd.exe [-c arquivo-de-configura??o] -i [-m]
zabbix_agentd.exe [-c arquivo-de-configura??o] -d [-m]
zabbix_agentd.exe [-c arquivo-de-configura??o] -s [-m]
zabbix_agentd.exe [-c arquivo-de-configura??o] -x [-m]
zabbix_agentd.exe -h
zabbix_agentd.exe -VOs par?metros a seguir podem ser utilizados.
Options:
-c --config <arquivo> caminho absoluto (completo) para o arquivo de configura??o (o padr?o ¨¦ c:\zabbix_agentd.conf)
-h --help apresenta o help de par?metros
-V --version apresenta o n¨²mero de vers?o
-p --print apresenta todos os itens (chaves) poss¨ª±¹±ð¾±²õ
-t --test <chave do item> testa um item espec¨ªfico e retorna o resultadoFunctions:
-i --install Instala o servi?o do agente Áú»¢¶Ä²©
-d --uninstall Desinstala o servi?o do agente Zabbis
-s --start Inicia o servi?o do agente Áú»¢¶Ä²©
-x --stop Finaliza o servi?o do agente Áú»¢¶Ä²©
-m --multiple-agents Nome do servi?o com o hostnameArquivo de configura??o
Veja o manual do arquivo de configura??o para detalhes de op??es de configura??o do agente Áú»¢¶Ä²© no Windows.
C¨®digos de sa¨ªda
Antes da vers?o 2.2 do Áú»¢¶Ä²© 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.