Operação e manutenção

Consulte o estado

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

A presença do agente e a entrega da telemetria são verificações distintas. Se o serviço está ativo, mas um sinal não chega, confira a configuração da fonte, as permissões e a conectividade.

Atualize o agente

Consulte Versões no Farol para identificar a versão recomendada. Obtenha o pacote correspondente ao sistema e à arquitetura pela distribuição oficial e confira os checksums e assinaturas antes de usar o binário.

Depois de obter e verificar o novo binário, o atualizador instalado aceita seu caminho local:

sudo farol-agent-update /caminho/do/pacote/farol-agent

O caminho acima é um exemplo: substitua-o pelo arquivo extraído do pacote verificado. Se a atualização exigir uma nova unit systemd, o atualizador aceita seu caminho como segundo argumento.

Após a atualização, confira o serviço, a versão reportada no Farol e o recebimento de métricas. Preserve /etc/farol-agent/ e /var/lib/farol-agent/.

Identidade e recuperação

Cada instalação tem uma identidade própria. Não copie identity.json para outro servidor. A restauração de um snapshot antigo pode reapresentar uma credencial que já foi renovada e exigir um novo registro.

Se a credencial expirar ou for revogada, gere um novo token. Pare o serviço antes de fazer um registro deliberado com enroll --force; não execute esse procedimento junto com o agente antigo em funcionamento.

Quando precisar dessa recuperação, confirme o procedimento com o administrador da organização. Não apague a fila local para tentar resolver uma falha de autenticação.

Desinstale

Para remover o serviço e os executáveis, preservando configuração, fila e usuário:

sudo farol-agent-uninstall

Para remover também o estado local, use --purge; esse comando pede confirmação:

sudo farol-agent-uninstall --purge

O purge descarta a fila ainda não enviada. A desinstalação do servidor não apaga os dados já recebidos pelo Farol.