Este documento descreve como encontrar, filtrar e excluir entradas de registo que fazem parte de grupos de erros quando usa o Explorador de registos. Os grupos de erros ajudam a identificar tendências e problemas recorrentes no seu ambiente agrupando as entradas do registo que têm erros por valores, como o tipo de exceção, as frames ou as mensagens.
Encontre detalhes do grupo de erros para uma entrada de registo
Para acompanhar os erros recorrentes na sua aplicação e gerir o respetivo estado de resolução, use a página Relatórios de erros da Google Cloud consola. A página Relatório de erros apresenta grupos de erros, incluindo informações sobre o tipo específico de erro, o número de ocorrências de erros e o estado de resolução de cada grupo.
Os relatórios de erros definem automaticamente o valor do campo de ID error_groups durante a criação de um grupo de erros. O campo contém carateres alfanuméricos, - e _.
Para consultar um grupo de erros específico, faça o seguinte:
-
Na Google Cloud consola, aceda à página Error Reporting:
Também pode encontrar esta página através da barra de pesquisa.
- Clique no nome do erro.
- No painel Exemplos recentes, clique em Ver registos em qualquer entrada de registo para ser redirecionado para a página do Explorador de registos.
No Explorador de registos, o campo do editor de consultas é preenchido com o campo de ID
error_groups. Por exemplo,errorGroups.id="CJqhkd7Qvsbj2QE".A lista de entradas de registo que contribuem para esse grupo de erros é apresentada no painel Resultados da consulta.
Para consultar entradas de registo que pertencem a qualquer grupo de erros e encontrar os detalhes do grupo de erros, faça o seguinte:
-
Na Google Cloud consola, aceda à página Explorador de registos:
Aceda ao Explorador de registos
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.
Para ver as entradas do registo associadas a qualquer grupo de erros, introduza o seguinte filtro no campo do editor de consultas:
errorGroups.id:*No painel Resultados da consulta, selecione uma entrada de registo que apresente o botão
Grupo de erros.Clique no botão
Grupo de erros e selecione Ver detalhes do grupo de erros:Por exemplo, a captura de ecrã seguinte mostra duas entradas de registo com um nível de gravidade de, pelo menos, erro. Uma destas entradas está anotada com o botão
Grupo de erros. A seguinte captura de ecrã também ilustra as opções disponíveis com este botão:
Depois de selecionar Ver detalhes do grupo de erros, a página Relatório de erros é aberta e apresenta informações sobre o grupo de erros.
Também pode usar as opções no botão
Grupo de erros para alterar as entradas de registo que o Explorador de registos
apresenta:
Para investigar o grupo de erros mais detalhadamente, selecione Mostrar entradas neste grupo de erros. O Explorador de registos é atualizado e apenas apresenta as entradas de registo no mesmo grupo de erros. Agora, pode aplicar parâmetros de consulta adicionais às entradas do registo do grupo de erros.
Para remover um grupo de erros específico dos resultados da consulta, selecione Ocultar entradas neste grupo de erros. O Explorador de registos é atualizado e todas as entradas de registo neste grupo de erros são ocultadas da apresentação.
Monitorize grupos de erros
Pode configurar os Relatórios de erros para receber uma notificação quando detetar um novo grupo de erros. Este serviço também lhe permite ver o histórico de erros de cada grupo de erros e gerir esses erros. Para mais informações, consulte os seguintes documentos:
Não pode criar métricas baseadas em registos que contabilizem o número de entradas de registo com grupos de erros nem configurar um alerta baseado em registos para receber uma notificação quando uma entrada de registo contém um grupo de erros. Da mesma forma, não pode extrair valores do campo errorGroups para uma etiqueta anexada a uma métrica baseada em registos ou a um alerta baseado em registos.