Primeiros passos
O Farol reúne métricas de servidores, logs, traces, erros e verificações de disponibilidade. Você pode configurar cada sinal separadamente: instalar o agente para acompanhar um servidor não exige instrumentar sua aplicação com OpenTelemetry.
Antes de começar
- Acesse o Farol e entre na organização correta.
- Confira se seu usuário tem permissão para cadastrar os recursos e emitir as credenciais necessárias. Se os controles estiverem indisponíveis, peça ajuda ao administrador da organização.
- Escolha um servidor ou serviço para a primeira integração.
Para uma aplicação, cadastre o serviço e o ambiente no catálogo. Use um nome estável, como checkout-api, e mantenha esse nome na configuração dos sinais. Veja identidade da aplicação.
Escolha o primeiro sinal
| Quero acompanhar | Por onde começar | Como validar |
|---|---|---|
| CPU, memória e disco de um servidor | Instalar o agente | Confira o host e suas métricas no período recente |
| Logs de um arquivo ou container | Configurar o agente | Gere uma linha e encontre-a no explorador de logs |
| Disponibilidade de um endpoint público | Criar um monitor | Aguarde uma verificação e confira seu resultado |
| Execução de um job agendado | Heartbeat de cron | Envie um ping depois da execução bem-sucedida |
| Exceções de uma aplicação | Configurar erros | Envie um erro controlado e abra a issue |
| Caminho e duração de uma requisição | Configurar traces | Faça uma requisição e localize sua trace |
Confirme cada integração
O recebimento de um sinal não comprova que os outros chegaram. Um agente pode estar conectado sem haver logs configurados; uma aplicação pode enviar erros sem exportar traces.
Valide o nome do serviço, o ambiente e o período da consulta, além da presença do dado. Para relacionar logs ou erros com uma trace, compare o trace_id completo: os valores precisam ser iguais.
Depois da validação, configure alertas e notificações. Se um dado não aparecer, siga o diagnóstico de problemas comuns.