Neste documento, descrevemos como encontrar, filtrar e excluir entradas de registro que fazem parte de grupos de erros ao usar a Análise de registros. Os grupos de erros ajudam a identificar tendências e problemas recorrentes no seu ambiente agrupando entradas de registro que têm erros por valores como tipo de exceção, frames ou mensagens.
Encontrar detalhes do grupo de erros para uma entrada de registro
Para rastrear erros recorrentes no aplicativo e gerenciar o status de resolução deles, use a página Error Reporting do console Google Cloud . A página Error Reporting lista grupos de erros, incluindo informações sobre o tipo específico de erro, o número de ocorrências de erros e o status de resolução de cada grupo.
O Error Reporting define automaticamente o valor do campo ID error_groups durante a criação de um grupo de erros. O campo contém caracteres alfanuméricos, - e _.
No Error Reporting, encontre entradas de registro para um grupo de erros
Se você estiver na página do Error Reporting e quiser encontrar as entradas de registro associadas a um grupo de erros específico, faça o seguinte:
-
No console Google Cloud , acesse a página Error Reporting:
Também é possível encontrar essa página usando a barra de pesquisa.
- Clique no nome do erro.
No painel Amostras recentes, clique em Ver registros em qualquer entrada de registro.
A página Análise de registros é aberta e mostra as entradas de registro associadas ao grupo de erros. O campo do editor de consultas especifica o ID do grupo de erros. Por exemplo, esse campo pode incluir algo como
errorGroups.id="ERROR_GROUP_ID", em que ERROR_GROUP_ID é o ID do seu grupo de erros.
Filtrar entradas de registro por grupo de erros
Se você estiver na página da Análise de registros e quiser encontrar entradas de registro associadas a um erro específico ou a um grupo de erros, faça o seguinte:
-
No console do Google Cloud , acesse a página Análise de registros:
Acessar a Análise de registros
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Escolha uma destas opções:
Para encontrar entradas de registro associadas a qualquer grupo de erros, adicione o seguinte ao painel de consultas:
errorGroups.id:*Para encontrar entradas de registro associadas a um grupo de erros específico, adicione o seguinte ao painel de consultas:
errorGroups.id: "ERROR_GROUP_ID"
Execute a consulta.
Investigar o grupo de erros de uma entrada de registro
Para abrir o grupo de erros de uma entrada de registro, selecione
Grupo de erros e depois
Ver detalhes do grupo de erros:
Você também pode usar as opções no botão
Grupo de erros para mudar quais entradas de registro a Análise de registros
mostra:
Para investigar o grupo de erros com mais detalhes, selecione Mostrar entradas neste grupo de erros. A Análise de registros é atualizada e mostra apenas as entradas de registro no mesmo grupo de erros. Agora é possível aplicar outros parâmetros de consulta às entradas de registro do grupo de erros.
Para remover um grupo de erros específico dos resultados da consulta, selecione Ocultar entradas nesse grupo de erros. O Análise de registros é atualizado, e todas as entradas de registro nesse grupo de erros são ocultadas da exibição.
Monitorar grupos de erros
É possível configurar o Error Reporting para enviar uma notificação quando um novo grupo de erros for detectado. Com ele, também é possível ver o histórico de erros de cada grupo e gerenciar esses erros. Para mais informações, consulte os seguintes documentos:
Não é possível criar métricas com base em registros que contam o número de entradas de registro com grupos de erros nem configurar um alerta com base em registros para notificar quando uma entrada de registro contém um grupo de erros. Da mesma forma, não é possível extrair valores do campo errorGroups para um rótulo anexado a uma métrica ou alerta com base em registros.