Use a Análise de registros para encontrar, filtrar e excluir entradas de registro que pertencem a grupos de erros para ajudar a identificar tendências e problemas recorrentes no seu ambiente. Os grupos de erros agregam entradas de registro que contêm erros com base em valores compartilhados, como tipo de exceção, frames ou mensagens.
Encontrar detalhes do grupo de erros para uma entrada de registro
Para acompanhar erros recorrentes no aplicativo e gerenciar o status de resolução deles, use a página Error Reporting do console do 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 e o status de resolução de cada grupo.
O Error Reporting define automaticamente o valor do campo de 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 visualizando a 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 do 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 exibe 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 grupo de erros.
Filtrar entradas de registro por grupo de erros
Se você estiver visualizando a página Análise de Registros e quiser encontrar entradas de registro associadas a um erro específico ou a qualquer 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 consulta:
errorGroups.id:*Para encontrar entradas de registro associadas a um grupo de erros específico, adicione o seguinte ao painel de consulta:
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, em seguida,
Ver detalhes do grupo de erros:
Também é possível usar as opções no botão Grupo de erros
para mudar quais entradas de registro são exibidas
pela Análise de registros:
Para investigar o grupo de erros em mais detalhes, selecione Mostrar entradas neste grupo de erros. A Análise de registros é atualizada e exibe 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. A Análise de registros é atualizada, 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 ele detectar um novo grupo de erros. Esse serviço também permite visualizar o histórico de erros de cada grupo de erros e gerenciá-los. Para mais informações, consulte estes 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 ou configurar um alerta com base em registros para notificar você quando uma entrada de registro
contiver 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 com base em registros ou um alerta com base em registros.