Ler a ficha de um serviço
Percorra as abas de um serviço do APM para ver seu desempenho, endpoints, erros, logs, dependências e incidentes, e vincule-o ao inventário.
Nesta página
A ficha reúne tudo o que o APM sabe sobre um serviço. Ela é aberta em APM → Serviços, no mapa de dependências ou em qualquer link para o serviço.
Antes de começar
Permissão Ver no módulo APM. Para alterar o vínculo ou os limites, permissão Operar.
Passos
Entre em APM → Serviços e clique no nome do serviço.
Escolha o período no seletor da direita. O APM mostra até os últimos 14 dias.
Percorra as abas.
As abas
Aba | O que tem |
|---|---|
Resumo | Requisições, erros, p50, p95 (com o valor de 7 dias atrás) e p99 do período; a disponibilidade (requisições sem erro); Onde roda (plataforma, tipo, linguagem, primeira e última vez, versões implantadas e instâncias); o cartão Inventário e o risco de falha do Cerebro, se o seu plano incluir |
Monitoramentos | A telemetria e os testes associados ao serviço |
Gráficos | Requisições e erros, Latência (p50, p95 e p99) e Métricas da aplicação: escolha uma métrica na lista para ver o gráfico dela |
Endpoints e traces | Cada endpoint com seu tráfego, erros e latência. Clique em um para ver o gráfico de latência e os traces dele; filtre por erros |
Erros e logs | Os erros do período com seu status, e os Logs recentes de advertência e erro, com link para o trace |
Dependências | Depende de (bancos de dados, HTTP, filas, RPC e outros serviços) e Chamado por, cada um com seu tráfego, erros e p95 |
Eventos | O que aconteceu com o serviço no período |
Incidentes | Os incidentes do serviço |
Relações | Suas relações no inventário |
Comentários | Notas da equipe sobre o serviço |
Se a aba Gráficos disser que o serviço não envia métricas próprias, verifique se OTEL_METRICS_EXPORTER=otlp está definido na aplicação.
Vincular o serviço ao inventário
Um serviço sem grupo não aparece no Inventário nem nos painéis de grupo, e seus incidentes não têm grupo. O ARGUNIS tenta vinculá-lo sozinho; se não conseguir, você faz isso no cartão Inventário (em Resumo ou em Configurar → Geral).
Escolha um Grupo próprio, ou vincule-o a um Servidor, Serviço web ou TCP (um
wss://ou uma porta própria é monitorado como TCP) ou Serviço de nuvem (do Railway, AWS, Azure ou Google Cloud) que já tenha grupo: o serviço o herda.Se houver Sugestões, clique em Vincular na que corresponder. As marcadas como segura se encaixam sem dúvida.
Para desfazer o que você definiu manualmente, clique em Voltar ao automático. Para soltá-lo de tudo, Remover vínculo.
O que foi definido manualmente fica como definido manualmente e o ARGUNIS não o altera.
Limites e silêncio do serviço
Cada serviço usa os limites de alerta da empresa, a menos que você defina os dele.
Na ficha, clique em Configurar e abra a aba Limites.
Clique em Editar limites e ajuste p95 máximo (ms), Erros máximo (%), Mínimo de requisições na janela, Janela (min), Notificar se não enviar dados por (min) e Fechar erros que não se repetem (dias) (de 1 a 90: depois desses dias sem que o erro volte, o incidente dele se fecha sozinho). Clique em Salvar.
Para voltar aos da empresa, clique em Usar os da empresa.
Para que o serviço não abra incidentes por um tempo (por exemplo, durante uma migração), clique em Silenciar alertas. Volte com Reativar alertas.
Relacionado
O que você altera na aba Relações do serviço também altera o Mapa de dependências e o APM ao vivo: uma dependência que você oculta deixa de ser desenhada e uma que você adiciona manualmente aparece tracejada (sem tráfego).