Instalar o agente

O agente coleta métricas do servidor e, quando configurado, logs e métricas de aplicações. Ele envia os dados ao Farol e mantém uma fila local para tentar novamente quando a conexão falha.

Requisitos

• Servidor Linux com systemd, nas arquiteturas amd64 ou arm64.
• Acesso administrativo com sudo para a instalação.
• curl, tar e sha256sum disponíveis no servidor.
• Saída HTTPS para os endpoints de controle, distribuição e ingestão do seu ambiente Farol.
• Permissão no Farol para emitir um token de instalação do agente.

O agente não precisa abrir uma porta de entrada no servidor. O Docker é opcional e só é necessário para coletar dados dos containers pelo socket local.

1. Obtenha o comando no Farol

Na tela Primeiro acesso ou Credenciais, emita um token de instalação para o servidor. Escolha os escopos correspondentes aos sinais que pretende enviar; para logs, habilite também a permissão de envio de logs.

Copie o comando de instalação exibido. Ele contém a URL de uma versão publicada do instalador, o checksum esperado e o token de uso único.

Guarde o token com cuidado

O segredo é mostrado no momento da emissão. Cole o comando somente no servidor que será instalado. Não o envie para tickets, chats ou repositórios. O token tem validade e é consumido na instalação; emita outro se ele expirar ou já tiver sido usado.

2. Execute no servidor

Execute o comando copiado, completo, incluindo a conferência SHA-256. O instalador obtém o pacote para a arquitetura do servidor, verifica as assinaturas do release, cria o usuário farol-agent e registra o serviço.

Não substitua a URL por um endereço de exemplo nem remova a verificação do checksum. A versão recomendada pode mudar; o comando gerado pelo Farol é a referência para a instalação.

3. Confira o serviço

sudo systemctl status farol-agent --no-pager
sudo journalctl -u farol-agent -n 50 --no-pager

O serviço deve estar ativo. Consulte os logs se houver uma falha de configuração, conectividade ou registro.

Caminho	Conteúdo
/etc/farol-agent/config.yaml	Configuração de coleta
/var/lib/farol-agent/identity.json	Identidade emitida para esta instalação
/var/lib/farol-agent/	Estado e fila persistente de entrega

Os endpoints são recebidos no registro da instalação. Não adicione URLs de ingestão ou tokens ao config.yaml e não edite manualmente o identity.json.

4. Confirme no Farol

Abra a lista de servidores, encontre o host e selecione um período recente. Confira a presença do agente e pelo menos uma métrica de CPU ou memória. O registro do host, sozinho, não comprova o recebimento das métricas.

Se nada aparecer, confira a organização, o período selecionado e os problemas comuns. Depois, siga para logs, Docker e métricas de aplicação.