Plataforma

Solução de problemas

Faça as primeiras verificações de acesso, coleta e envio de métricas.

O agente não aparece no portal#

Confirme o workspace selecionado e o Agent ID que foi configurado.
Confira se o serviço do agente está em execução.
Verifique a URL completa: https://ingest.nebria.com.br/v1/metrics.
Confira se a chave completa está correta, ativa e pertence ao workspace. O campo api_key exige a chave completa.
Verifique DNS e saída HTTPS TCP 443. Depois, aguarde alguns minutos e confira os logs.

Interprete erros de envio#

Sinal	O que verificar
HTTP 401	A chave foi rejeitada. Confira se está correta e ainda ativa em Secrets.
HTTP 503 ou timeout	Pode haver indisponibilidade ou falha de comunicação. O buffer é preservado para nova tentativa.
HTTP 400 ou 422	O lote foi rejeitado. Confira os arquivos da área de rejeitados e a compatibilidade da versão do agente.
Serviço ativo, sem métricas recentes	Ativo não confirma entrega. Compare logs, configuração, conexão e horário da última coleta.

Consulte o serviço#

No Windows, abra PowerShell como administrador:

PowerShell

Get-Service -Name NebriaAgentMetrics

No Linux:

Terminal

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

Uma tela ou um módulo não está disponível#

Confirme sua sessão, o workspace e os módulos habilitados. Se o acesso foi removido, atualizar a página não concede novas permissões. Solicite a revisão ao responsável pelo workspace.

Quando acionar o suporte#

Se o problema continuar, abra um ticket com o Agent ID, o horário, o sistema operacional e a mensagem de erro. Remova senhas, chaves, cookies e dados pessoais antes de anexar qualquer informação. Veja como abrir uma solicitação.