View and filter error groups

This guide shows you how to view and filter error groups with the Google Cloud console. You can filter, sort, and view additional details about error groups, as well as restrict the display to a specific time range.

The Error Reporting page displays a list of error groups. Each row shows information such as the resolution status, response code, error name, and the occurrences over time:

For information on how Error Reporting organizes error events into error groups, see How error events are grouped.

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.

Before you begin

• Make sure that you have least one error group. For more information, see Collect error data by using Error Reporting.

• To get the permissions that you need to view and filter errors, ask your administrator to grant you the Error Reporting Viewer (roles/errorreporting.viewer) IAM role on your project. For more information about granting roles, see Manage access to projects, folders, and organizations.

  You might also be able to get the required permissions through custom roles or other predefined roles.

View error details

The details of an error group include the history of error events, the resolution status, the number of occurrences, and a timestamped list of error events. Each entry in the list contains a link to relevant logs and when available, a stacktrace.

To view the details of an error group, do the following:

1. In the Google Cloud console, go to the Error Reporting page:

   Go to Error Reporting

   You can also find this page by using the search bar.

2. Click the error name.

   The Error Group Details page displays information about the error group, including the history of error events and diagnostic information from previous error events. If Gemini is enabled in the project, then you can use Gemini to get troubleshooting suggestions.

View associated log entries

Note: Only log entries stored in a log bucket can include the errorGroups field. The value of this field is derived by the log-bucket destination. Log data sent to your project or that is routed by log sinks doesn't contain an error group field.

To view the log entry associated with an error event, in the Recent samples panel, click View Logs.

The Logs Explorer page opens and displays log entries associated with the error group. The query-editor field specifies the error group ID. For example, this field might include something like errorGroups.id="ERROR_GROUP_ID", where ERROR_GROUP_ID is the ID of your error group.

If you use the Logs Explorer, then you can filter your log data by an error group. You can also identify log entries that are associated with an error group by the presence of the Error group button. To open the error group, select the button.

For more information, see the following:

• Find log entries with error groups.
• View logs by using the Logs Explorer.

Filter error groups

You can use the filters on the Error Reporting toolbar to filter by the status, the affected resources, and the region of the log buckets that store your log entries.

Filter error groups by resource

To filter error groups by resource, select the All Resources menu and then select a resource. Some resources let you further filter by error group labels. The type and number of available error group labels vary depending on the resource. For example, if you have error groups for the Kubernetes Container Services resource, then you can filter first by service and then by version:

To save your selections, click Apply.

To clear your resource filters and reset the list of filtered error groups, select Reset and then select Apply.

Filter error groups by text

To filter error groups by text, enter a value in the Filter errors text field. The text filter can perform a text match on any of the following fields:

• Error information
• HTTP Response Code
• Exception stack
• Request URL
• Report location
• HTTP method

What's next

• Manage error groups
• Manage service error groups