O agente APM reporta automaticamente dados de erro para a estrutura suportada. Para otimizar relatórios e alertas de erros, você pode gerenciar ainda mais os erros para:
- Capture erros que não instrumentamos por padrão.
- Erro ignorado que você não deseja que seja relatado.
- Filtre o ruído de erros esperados para que você possa se concentrar nos erros que estão afetando o desempenho. (somente agente Java, Ruby, Node, Python e .NET)
Dica
Confira nosso tutorial de monitoramento de erros em três partes. O tutorial usa um cenário de exemplo para uma interrupção do aplicativo para orientá-lo na resposta e solução de erros críticos.
Coletar erros não instrumentados por padrão
Agente APM inclui chamada de API para reportar (ou "notificar") erros. Eles são úteis quando o APM não instrumenta sua framework automaticamente ou quando há erros específicos que não são detectados pela sua framework suportada.
Para saber como fazer com que um agente APM relate um erro, consulte a documentação da API específica do agente:
Go
Java
.NET
Node.js
PHP
Python
Ruby
Erro ignorado
Às vezes, o agente APM informa um erro que você não deseja que seja relatado, como erros que contêm informações confidenciais, como erros de login do usuário. Se não quiser que um erro seja relatado ao nosso coletor, você pode ignorar o erro e o agente APM descartará o erro completamente.
Dica
Para Java, .NET, Ruby, Node.js, Go e Python: se você deseja relatar erros ao APM, mas não deseja que esses erros afetem seu Apdex ou taxa de erros, marque-os como esperado .
Existem duas formas de erro ignorado: através da configuração do agente ou através da configuração no lado do servidor na interface:
Erro esperado (Java, Node.js, Somente Python, Ruby, Go e .NET)
Para o agente APM abaixo, você pode marcar os erros conforme esperado. Esses erros serão reportados ao APM e estarão disponíveis para visualização, mas não afetarão o Apdex ou taxa de erros (ou condição do alerta baseada em taxa de erros).
Para configurar os erros conforme esperado, consulte a documentação específica do agente:
Se erro esperado estiver habilitado, a página Error analytics do APM terá, por padrão, um filtro aplicado com o atributo error.expected definido como false, o que significa que erro esperado não será exibido. Para visualizar o erro esperado, desative o filtro error.expected .
Para visualizar o erro esperado, consulte seus dados:
- Para visualizar gráficos de erros esperados, crie uma consulta para o atributo
error.expected. - Para criar condição do alerta para consulta NRQL, utilize o atributo
error.expected.
Erro impressão digital com Errors Inbox
Errors Inbox agrupa de forma inteligente as ocorrências de erros para reduzir o ruído e destacar erros importantes.
Os eventos de erro são agrupados em um grupo de erros quando compartilham a mesma impressão digital. Embora nossas regras gerenciadas sejam capazes de fornecer agrupamento automático de erros com base em um conjunto predefinido de padrões, é impossível reconhecer todas as combinações possíveis. Por esse motivo, os clientes também podem definir sua própria impressão digital por meio de uma função de retorno de chamada se descobrirem que nossas regras gerenciadas não estão agrupando as ocorrências com precisão.
Para configurar a lógica de impressão digital personalizada, consulte a documentação específica do agente:
Ver erros na interface
Entre outros locais, dados de erro aparecem nestas partes da interface:
Página de análise de erros: mostra gráficos detalhados e análises visuais de erros.
do APM: mostra uma visualização de alto nível do seu aplicativo, que inclui erros.
condição do alerta: pode ser baseada em taxa de erros.
O evento
transactionError: contém dados de erro subjacentes, que podem ser usados na consulta NRQL.