2 Agent

Visão geral

O agent do Zabbix é implantado em um alvo de monitoramento para monitorar ativamente recursos e aplicativos locais (discos rígidos, memória, estatísticas do processador etc.).

O agent coleta informações operacionais localmente e envia dados ao server do Zabbix para processamento posterior. Em caso de falhas (como um disco rígido cheio ou um processo de serviço travado), o server do Zabbix pode alertar ativamente os administradores da máquina específica que relatou a falha.

Os agents do Zabbix são altamente eficientes devido ao uso de chamadas de sistema nativas para coletar informações estatísticas.

É possível executar várias instâncias do agent em um host.

Verificações passivas e ativas

Os agents do Zabbix podem executar verificações passivas e ativas:

  • Verificações passivas - o agent do Zabbix responde a uma solicitação do server do Zabbix (ou proxy). Por exemplo, o server solicita dados (por exemplo, uso de CPU), e o agent retorna o resultado.
  • Verificações ativas - o agent do Zabbix coleta e envia dados sem aguardar uma solicitação do server do Zabbix (ou proxy). Primeiro, ele obtém uma lista de itens de monitoramento do server (uso de CPU, memória disponível etc.), depois coleta os dados necessários e envia periodicamente novos valores de volta para ele.

O tipo de verificação do agent é configurado selecionando o respectivo tipo de item de monitoramento. O agent do Zabbix processa itens do tipo Zabbix agent ou Zabbix agent (active).

Plataformas suportadas

Para plataformas suportadas, consulte a página Requisitos.

Agent em sistemas Unix-like

O agent do Zabbix em sistemas Unix-like é executado no host monitorado.

Instalação

O agent do Zabbix pode ser instalado em sistemas baseados em Linux usando um dos seguintes métodos:

  • Pacotes do Zabbix - selecione o componente Agent (após selecionar sua versão do Zabbix, distribuição do SO e versão do SO) e siga as instruções fornecidas.
  • Fontes do Zabbix - baixe os arquivos fonte e compile o agent do Zabbix configurando as fontes com a opção --enable-agent.

Em geral, agents Zabbix de 32 bits funcionarão em sistemas de 64 bits, mas podem falhar em alguns casos.

Binários pré-compilados do agent do Zabbix estão disponíveis para download para macOS, IBM AIX, FreeBSD, OpenBSD e Solaris. Binários legados, compatíveis com a versão atual do server/proxy do Zabbix, estão disponíveis para NetBSD e HP-UX.

Se instalado como pacote

O agent Zabbix é executado como um processo daemon. O agent pode ser iniciado executando:

systemctl start zabbix-agent

Isso funcionará na maioria dos sistemas GNU/Linux. Em outros sistemas, pode ser necessário executar:

/etc/init.d/zabbix-agent start

Para parar, reiniciar ou verificar o status do agent Zabbix, use os seguintes comandos:

systemctl stop zabbix-agent
systemctl restart zabbix-agent
systemctl status zabbix-agent
Iniciar manualmente

Você pode iniciar o agent do Zabbix localizando o binário zabbix_agentd e executando-o diretamente; por exemplo:

zabbix_agentd
Agent em sistemas Windows

O Zabbix Agent no Windows é executado como um Serviço do Windows.

Instalação

O Zabbix agent pode ser instalado no Windows usando um dos seguintes métodos:

Consulte a página Zabbix agent no Microsoft Windows para obter detalhes adicionais sobre a instalação do Zabbix agent (a partir de um arquivo ZIP) como um serviço do Windows.

Opções

Os seguintes parâmetros de linha de comando podem ser usados com o Zabbix agent:

Parameter Description
agent UNIX e Windows
-c --config <config-file> Caminho para o arquivo de configuração.
Você pode usar esta opção para especificar um arquivo de configuração que não seja o padrão.
-f --foreground Executa o Zabbix agent em primeiro plano (padrão: true).
-p --print Exibe os items conhecidos e encerra.
Observe que, para retornar também os resultados de user parameter, você deve especificar o arquivo de configuração (se ele não estiver no local padrão).
-t --test <item key> Testa o item especificado e encerra.
Observe que, para retornar também os resultados de user parameter, você deve especificar o arquivo de configuração (se ele não estiver no local padrão).
-T --test-config Valida o arquivo de configuração e encerra.
-h --help Exibe informações de ajuda.
-V --version Exibe o número da versão.
Somente agent UNIX
-R --runtime-control <option> Executa funções administrativas. Veja runtime control.
Somente agent Windows
-m --multiple-agents Usa múltiplas instâncias do agent (com as opções -i, -d, -s, -x).
Para distinguir os nomes dos serviços das instâncias, cada nome de serviço incluirá o valor de Hostname do arquivo de configuração especificado.
-S --startup-type <value> Define o tipo de inicialização do serviço do Zabbix agent Windows. Valores permitidos:
automatic - (padrão) inicia o serviço automaticamente na inicialização do Windows;
delayed - adia o início do serviço até que os serviços iniciados automaticamente concluam a inicialização (disponível no Windows Server 2008/Vista e versões posteriores);
manual - inicia o serviço manualmente (por um usuário ou aplicativo);
disabled - desabilita o serviço, de modo que ele não possa ser iniciado por um usuário ou aplicativo.
Você pode usar esta opção junto com a opção -i, ou separadamente para modificar o tipo de inicialização de um serviço já instalado.
-i --install Instala o Zabbix agent Windows como serviço.
-d --uninstall Desinstala o serviço do Zabbix agent Windows.
-s --start Inicia o serviço do Zabbix agent Windows.
-x --stop Para o serviço do Zabbix agent Windows.

Exemplos específicos de uso dos parâmetros de linha de comando:

  • Exibindo todos os items integrados do agent com valores.
  • Testando um user parameter com a key mysql.ping definida no arquivo de configuração especificado.
  • Instalando um serviço do Zabbix Agent para Windows usando o caminho padrão para o arquivo de configuração C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf.
  • Instalando um serviço do Zabbix Agent [Hostname] para Windows usando o arquivo de configuração zabbix_agentd.conf localizado na mesma pasta do executável do agent e tornando o nome do serviço exclusivo ao estendê-lo com o valor de Hostname do arquivo de configuração.
  • Modificando o tipo de inicialização de um serviço do Zabbix Agent para Windows já instalado usando o arquivo de configuração zabbix_agentd.conf localizado na mesma pasta do executável do agent.
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.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
Controle 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 agent.

Option Description Target
log_level_increase[=<target>] Aumenta o nível de log.
Se o target não for especificado, todos os processos serão afetados.		 O target pode ser especificado como:
tipo de processo - todos os processos do tipo especificado (por exemplo, listener)
Veja todos os tipos de processo do agent.
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 target como 'tipo de processo,N'.
log_level_decrease[=<target>] Diminui o nível de log.
Se o target não for especificado, todos os processos serão afetados.
userparameter_reload Recarrega os valores das opções UserParameter e Include do arquivo de configuração atual.

Exemplos:

  • Aumentando o nível de log de todos os processos
  • Aumentando o nível de log do terceiro processo listener
  • Aumentando o nível de log do processo com PID 1234
  • Diminuindo 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 no OpenBSD, NetBSD e Windows.

Tipos de processo do agent

Os tipos de processo do agent são os seguintes:

  • active checks - processo para executar active checks;
  • collector - processo para coleta de dados;
  • listener - processo para escutar passive checks.

O arquivo de log do agent pode ser usado para observar esses tipos de processo.

Desde o Zabbix 7.4.6, o arquivo de log do agent é criado com permissões de leitura e gravação apenas para o proprietário do arquivo. Além disso, o arquivo pode ser lido pelo grupo do proprietário. Todas as outras permissões são negadas.

Usuário do processo

O agent do Zabbix no UNIX foi projetado para ser executado como um usuário não root. Ele será executado como qualquer usuário não root com o qual for iniciado. Portanto, você pode executar o agent como qualquer usuário não root sem problemas.

Se você tentar executá-lo como 'root', ele mudará para um usuário 'zabbix' definido no código, que deve estar presente no seu sistema. Você só pode executar o agent como 'root' se modificar o parâmetro AllowRoot no arquivo de configuração do agent de acordo com isso.

Arquivo de configuração

O caminho padrão para o arquivo de configuração é:

  • No UNIX, o padrão é /usr/local/etc/zabbix_agentd.conf ou, conforme definido pelas variáveis de tempo de compilação --sysconfdir ou --prefix.
  • No Windows, o padrão é C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf.

Se uma única instância do agent estiver em execução em um host, ela pode usar o arquivo de configuração padrão ou um arquivo de configuração especificado na linha de comando. No caso de várias instâncias, cada instância do agent deve ter seu próprio arquivo de configuração (uma das instâncias pode usar o arquivo de configuração padrão).

Para detalhes sobre a configuração do Zabbix agent, consulte as opções do arquivo de configuração para Zabbix agent Unix ou Zabbix agent Windows.

Localidade

Observe que o agent requer uma localidade UTF-8 para que alguns itens textuais do agent possam retornar o conteúdo esperado. A maioria dos sistemas modernos semelhantes ao Unix tem uma localidade UTF-8 como padrão, no entanto, há alguns sistemas onde isso pode precisar ser definido especificamente.

Código de saída

O Zabbix agent retorna 0 em caso de saída bem-sucedida e 1 em caso de falha.