Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste guia, mostramos como visualizar e filtrar erros com o
consoleGoogle Cloud . É possível filtrar, classificar e visualizar outros detalhes sobre erros, bem como restringir os erros a um intervalo de tempo específico.
A página Error Reporting mostra uma lista de grupos de erros que correspondem ao filtro atual. Cada linha mostra informações como o status de resolução, o código de resposta e o nome do erro de um grupo de erros.
A coluna Ocorrências mostra um gráfico de barras com barras azuis que representam o
número de vezes que um erro ocorreu no período
selecionado. Quando você filtra grupos de erros por texto, os gráficos de barras mostram barras cinzas para representar o número de erros que não corresponderam ao filtro de texto:
Para informações sobre como o Error Reporting organiza
erros em grupos, consulte
Como os erros são agrupados.
Para receber as permissões necessárias para visualizar e filtrar erros,
peça ao administrador para conceder a você o
papel do IAM de Leitor do Error Reporting (roles/errorreporting.viewer)
no seu projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Os detalhes de um grupo de erros incluem o histórico de erros, o status de resolução, o número de ocorrências e uma lista de erros com carimbo de data/hora.
Cada entrada na lista contém um link para os registros relevantes e, quando disponível, um rastreamento de pilha.
Para ver os detalhes de um grupo de erros, 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.
A página Detalhes do grupo de erros mostra informações sobre o grupo de erros, incluindo o histórico de um erro, instâncias específicas de erros e informações de diagnóstico de amostras de erros. Se o Gemini estiver ativado no projeto, você poderá usar o recurso para receber sugestões de solução de problemas.
Ver entradas de registro associadas
Para visualizar a entrada de registro associada a um erro de amostra, clique em Visualizar registros em qualquer entrada no painel Amostras recentes. Isso leva você à página do
Explorador de registros.
No Explorador de registros, o painel do editor de consultas é pré-preenchido com um
filtro que contém o campo de ID error_groups. A lista de entradas de registro que contribuem para esse grupo de erros é mostrada no painel Resultados da consulta.
Quando uma entrada de registro faz parte de um grupo de erros, o Explorador de registros adiciona o botão do grupo de erros () à exibição da entrada de registro. Clique no botão para acessar os detalhes do agrupamento ou mudar as entradas de registro mostradas. Para mais informações, consulte
Encontrar entradas de registro com grupos de erros.
Para mais informações sobre como usar o console do Google Cloud para visualizar esses registros,
consulte Como usar o Explorador de registros.
Filtrar grupos de erros
Use os filtros na barra de ferramentas do Error Reporting para filtrar por status, recursos afetados e região dos buckets de registros que armazenam suas entradas.
Filtrar grupos de erros por recurso
Para filtrar grupos de erros por recurso, selecione o menu Todos os recursos e escolha um recurso. Alguns recursos permitem filtrar ainda mais por rótulos de grupo de erros.
O tipo e o número de rótulos de grupo de erros disponíveis variam de acordo com o recurso. Por exemplo, se você tiver grupos de erros para o recurso
Serviços de contêiner do Kubernetes, filtre primeiro por
serviço e depois por versão:
Para salvar as seleções, clique em Aplicar.
Para limpar os filtros de recursos e redefinir a lista de grupos de erros filtrados, selecione Redefinir e Aplicar.
Filtrar grupos de erros por texto
Para filtrar erros por texto, insira um valor no campo de texto Filtrar erros.
O filtro de texto pode fazer uma correspondência de texto em qualquer um dos seguintes campos:
[[["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."],[[["\u003cp\u003eThis guide explains how to use the Google Cloud console's Error Reporting page to view and filter error groups, including sorting and viewing detailed error information.\u003c/p\u003e\n"],["\u003cp\u003eThe Error Reporting page displays error groups with details like resolution status, response code, error name, and a bar graph showing error occurrences within a selected time range.\u003c/p\u003e\n"],["\u003cp\u003eTo view detailed information about an error group, click on the error name to access the Error Group Details page, which includes error history, instances, and diagnostic data, with Gemini offering troubleshooting suggestions.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter error groups by status, resources, region, or text-based criteria, including error information, HTTP response code, exception stack, request URL, report location, and HTTP method.\u003c/p\u003e\n"],["\u003cp\u003eThe Log Explorer allows you to view the log entries related to a specific error, with a pre-populated filter containing the \u003ccode\u003eerror_groups\u003c/code\u003e ID, but this field is only usable in Logs Explorer and Log Analytics, not in sinks, alerts, or metrics.\u003c/p\u003e\n"]]],[],null,["# View and filter errors\n\nThis guide shows you how to view and filter errors with the\nGoogle Cloud console. You can filter, sort, and view additional\ndetails about errors, as well as restrict errors to a specific time range.\n\nThe **Error Reporting** page displays a list of\nerror groups that match the current filter. Each row shows\ninformation such as the resolution status, response code, and error name for an\nerror group.\nThe **Occurrences** column shows a bar graph with blue bars that represent the\nnumber of times an error occurred within the selected\ntime range. When you filter error groups by text, the bar graphs show grey bars\nto represent the number of errors that didn't match the text filter:\n\nFor information on how Error Reporting organizes\nerrors into error groups, see\n[How errors are grouped](/error-reporting/docs/grouping-errors).\n\n\u003cbr /\u003e\n\n| **Note** : If you see the message \"Set up Error Reporting\" on the **Error Reporting** page, then your Google Cloud project has no error groups to display.\n\n\u003cbr /\u003e\n\nBefore you begin\n----------------\n\n- Ensure that you have least one error group. For more information, see [Collect error data by using Error Reporting](/error-reporting/docs/setup).\n\n\u003c!-- --\u003e\n\n-\n\n To get the permissions that\n you need to view and filter errors,\n\n ask your administrator to grant you the\n\n\n [Error Reporting Viewer](/iam/docs/roles-permissions/errorreporting#errorreporting.viewer) (`roles/errorreporting.viewer`)\n IAM role on your project.\n\n\n For more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\n You might also be able to get\n the required permissions through [custom\n roles](/iam/docs/creating-custom-roles) or other [predefined\n roles](/iam/docs/roles-overview#predefined).\n\nView error details\n------------------\n\nThe details of an error group include the history of errors, the\nresolution status, the number of occurrences, and a timestamped list of errors.\nEach entry in the list contains a link to relevant logs and, when available,\na stacktrace.\n\nTo view the details of an 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.\n\n The **Error Group Details** page displays information about the error group,\n including the history of an error, specific error instances, and diagnostic\n information from error samples. If Gemini is enabled in the\n project, then you can use Gemini to\n [get troubleshooting suggestions](/error-reporting/docs/troubleshoot-errors-gemini).\n\n### View associated log entries\n\nTo view the log entry associated with a sample error, click **View Logs** from\nany entry in the **Recent samples** panel. This takes you to the\n**Logs Explorer** page.\n\nIn the **Logs Explorer** , the query-editor pane is pre-populated with a\nfilter that contains the `error_groups` ID field. The list of log entries\ncontributing to that error group is shown in the **Query results** pane.\n| **Note:** You can filter by the `error_groups` ID field only when querying logs, for example, when you are using the **Logs Explorer** and **Log Analytics** pages. You can't use this field in log sinks, log-based alerts, or log-based metrics.\n\nWhen a log entry is part of an error group, Logs Explorer adds the\nerror group button () to the display of the\nlog entry. Click the button to access grouping details or to change which log\nentries are shown. For more information, see\n[Find log entries with error groups](/logging/docs/analyze/find-logs-error-groups).\n\nFor more information on using the Google Cloud console to view these logs,\nsee [Using the Logs Explorer](/logging/docs/view/logs-explorer-interface).\n\nFilter error groups\n-------------------\n\nYou can use the filters on the Error Reporting toolbar to filter\nby the status, the affected resources, and the region of the log buckets\nthat store your log entries.\n\n### Filter error groups by resource\n\nTo filter error groups by resource, select the **All Resources** menu and then\nselect a resource. Some resources let you further filter by error group labels.\nThe type and number of available error group labels vary depending on the\nresource. For example, if you have error groups for the\n**Kubernetes Container Services** resource, then you can filter first by\nservice and then by version:\n\nTo save your selections, click **Apply**.\n\nTo clear your resource filters and reset the list of\nfiltered error groups, select **Reset** and then select **Apply**.\n\n### Filter error groups by text\n\nTo filter errors by text, enter a value in the **Filter errors** text field.\nThe text filter can perform a text match on any of the following fields:\n\n- Error information\n- HTTP Response Code\n- Exception stack\n- Request URL\n- Report location\n- HTTP method\n\nWhat's next\n-----------\n\n- [Learn more about managing errors](/error-reporting/docs/managing-errors)\n- [Learn more about managing service errors](/error-reporting/docs/service-errors)"]]