Monitoramento

Agente Linux

Escolha a arquitetura, configure o agente e instale o serviço systemd.

Escolha o pacote correto#

Use uma distribuição Linux com systemd, os utilitários tar, install e useradd, além de acesso sudo. No portal, abra Monitoring → Agents → Linux. Confira a arquitetura:

Terminal

uname -m

x86_64: baixe Linux x64, pacote amd64.
aarch64 ou arm64: baixe Linux ARM64, pacote arm64.

Extraia e instale#

No diretório em que salvou o download, para x64:

Terminal

tar -xzf nebria-agent-linux-amd64.tar.gz
cd nebria-agent-linux-amd64
sudo ./install.sh
sudo nano /etc/nebria-agent/config.json

Para ARM64, substitua amd64 por arm64 no arquivo e no diretório. O instalador cria um usuário dedicado e instala os arquivos do serviço. Configure antes de iniciar.

Preencha os dados da máquina#

Use um Agent ID exclusivo e a chave completa criada em Secrets. Exemplo de estrutura — substitua os valores indicados:

JSON

{
  "agent_id": "srv-app01",
  "api_url": "https://ingest.nebria.com.br/v1/metrics",
  "api_key": "SUA-CHAVE-COMPLETA",
  "data_dir": "/var/lib/nebria-agent",
  "interval": "30s",
  "delivery_interval": "1m"
}

Inicie e confira o serviço#

Terminal

sudo systemctl enable --now nebria-agent
sudo systemctl status nebria-agent --no-pager
sudo journalctl -u nebria-agent -n 50 --no-pager

Depois de alguns minutos, procure o recurso no portal e confirme se as métricas são recentes. O buffer fica em /var/lib/nebria-agent/buffer. Falhas de envio preservam as amostras para novas tentativas.

Atualize ou reconfigure#

O instalador preserva a configuração existente e o buffer. Ao atualizar o binário, ou depois de editar o JSON, reinicie o serviço:

Terminal

sudo systemctl restart nebria-agent

Não execute duas instâncias usando o mesmo diretório de dados. Para trocar a chave sem interromper os demais agentes, consulte Chaves e rotação.