Encontrar entradas de registro com grupos de erros
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, descrevemos como encontrar, filtrar e excluir entradas de registro que fazem parte de grupos de erros ao usar o Explorador 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 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 ID error_groups durante a criação de um grupo de erros. O campo contém caracteres alfanuméricos, - e _.
Para consultar um grupo de erros específico, faça o seguinte:
No console Google Cloud , acesse a página Error Reporting:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Para ver as entradas de registro associadas a qualquer grupo de erros, insira o filtro a seguir no campo do editor de consultas:
errorGroups.id:*
No painel Resultados da consulta, selecione uma entrada de registro que mostre 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 tela a seguir mostra duas entradas de registro com um nível de gravidade de pelo menos "erro".
Uma dessas entradas é anotada com o botão Grupo de erros. A captura de tela a seguir também ilustra as opções disponíveis com esse botão:
Depois de selecionar Ver detalhes do grupo de erros, a página Error Reporting será aberta e vai mostrar informações sobre o grupo de erros.
Você também pode usar as opções no botão Grupo de erros para mudar quais entradas de registro o Explorador de registros
mostra:
Para investigar o grupo de erros com mais detalhes, selecione
Mostrar entradas nesse 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. 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 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 UTC."],[],[],null,["# Find log entries with error groups\n\nThis document describes how to find, filter, and exclude log entries that are\npart of error groups when using the Logs Explorer.\n[Error groups](/error-reporting/docs/grouping-errors)\nhelp you identify trends and recurring problems in your environment by grouping\nlog entries that have errors by values such\nas exception type, frames, or messages.\n\nFind error group details for a log entry\n----------------------------------------\n\nTo track recurring errors across your application and to manage their resolution\nstatus, use the **Error Reporting** page of the Google Cloud console.\nThe **Error Reporting** page lists error groups, including\ninformation about the specific type of error, the number of error occurrences,\nand the resolution status of each group.\n\nError Reporting automatically sets the value of the\n`error_groups` ID field during the creation of an error group. The field\ncontains alphanumeric characters, `-` and `_`.\n\nTo query for a specific error group, do the following:\n\n1. In the Google Cloud console, go to the **Error Reporting** page:\n\n [Go to **Error Reporting**](https://console.cloud.google.com/errors)\n\n \u003cbr /\u003e\n\n You can also find this page by using the search bar.\n2. Click the error name.\n3. In the **Recent samples** panel, click **View Logs** from any log entry to redirect you to the **Logs Explorer** page.\n4. In the **Logs Explorer** , the query-editor field is populated with the\n `error_groups` ID field. For example, `errorGroups.id=\"CJqhkd7Qvsbj2QE\"`.\n\n The list of log entries contributing to that error group is shown in the\n **Query results** pane.\n\nTo query for log entries that belong to any error group and to find the error\ngroup details, do the following:\n\n1. In the Google Cloud console, go to the **Logs Explorer** page:\n\n [Go to **Logs Explorer**](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. To view log entries associated with any error group, enter the following\n filter into the query-editor field:\n\n errorGroups.id:*\n\n3. In the **Query results** pane, select a log entry that displays the\n **Error group** button.\n\n4. Click the **Error group** button and\n select **View error group details**:\n\n For example, the following screenshot shows two log entries with a\n severity level of at least error.\n One of these entries is annotated with the\n **Error group** button. The following screenshot also illustrates the\n options available with this button:\n\n After you select **View error group details** , the **Error reporting**\n page opens and displays information about the error group.\n\nYou can also use the options in the\n**Error group** button to change which log entries the Logs Explorer\ndisplays:\n\n- To investigate the error group in more detail, select\n **Show entries in this error group**. Logs Explorer is refreshed and\n displays only those log entries in the same error group. You can now apply\n additional query parameters to the error group's log entries.\n\n- To remove a specific error group from your query results,\n select **Hide entries in this error group**. Logs Explorer is refreshed\n and all log entries in this error group are hidden from the display.\n\nMonitor error groups\n--------------------\n\nYou can configure Error Reporting to notify you when it detects a\nnew error group. This service also lets you view the history of errors for\neach error group and to manage those errors. For more information,\nsee the following documents:\n\n- [Configure and manage notifications](/error-reporting/docs/notifications)\n- [View and filter errors](/error-reporting/docs/viewing-errors)\n\nYou can't create log-based metrics that count the number of log entries with\nerror groups or configure a log-based alert to notify you when a log entry\ncontains an error group. Similarly, you can't extract values from the\n`errorGroups` field into a label attached to a log-based metric or\nlog-based alert."]]
.