Manage errors

This page explains how you can manage your errors in Error Reporting.

Get started

To see the errors for the services and apps in your Google Cloud project, go to Error Reporting in the Google Cloud console:

Go to Error Reporting

The Error Reporting dashboard displays a list with a summary of each error found and the number of occurrences of each error.

The user interface showing the error list.

Tip: Treat this list like an email inbox. Keep it clean and useful by fixing underlying errors, or muting those errors that are expected and recurring.

For more information on viewing and filtering in your Error Reporting list, see View errors.

For information on the permissions needed to manage your errors, see Access control with IAM.

Error samples

Errors that are grouped together are usually very similar, so Error Reporting keeps only 1,000 samples and extrapolates the remaining information. To keep all occurrences of an error, consider routing your logs to BigQuery so that future occurrences of the error are saved.

For each sample, the UI shows the data that your application sends to Error Reporting. For example, App Engine standard provides useful metadata like the user agent and the URL of the request that led to the error. If you are sending your own error reports as log entries, check the list of fields you can provide. If you are using the Error Reporting API, refer to the ReportedErrorEvent object.

For more information, see How errors are grouped.

Filter errors

Use filter menus to filter and restrict the types of error groups that appear in the list page or details pages.

To filter your error groups, do the following:

  1. In Google Cloud console, select Error Reporting, or use the following button:

    Go to Error Reporting

  2. To filter errors by resource, expand All Resources, select the resource to filter by, and then select Apply. The menu shows only error groups from logs that are currently stored in Error Reporting. The name of the filter changes based on the selected statuses.

    The following screenshot shows the menu of project resources that appears after selecting All Resources:

    The error reporting Resource filter menu showing available resources in the project.

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

  3. To filter errors by error status, select the Open, Acknowledged filter and then select your error statuses. The name of the filter changes based on the selected statuses.

  4. To filter errors by text, enter a value in the Filter errors text field.

    The text filter performs a text match on the Error information, the HTTP Response Code, the exception stack, and the following attributes:

    • Request URL
    • Report location (that is, the location where the error was logged)
    • HTTP method

    On the Error Reporting list page, the bar graph under the Occurrences column updates to show filtered results in blue, versus the non-filtered total in grey:

    The user interface showing filtered error list.

    You can view the bar graph, in detail, on the Error Details page in the Errors section.

Change resolution status

To manage your workflow, change the resolution status of your error groups by doing the following:

  1. Go to the Operations > Error Reporting page in the Google Cloud console:

    Go to the Error Reporting page

  2. For each error group, Resolution status appears:

    The user interface showing the error resolution status.

  3. In the preceding panel, expand the Resolution status column to change the status of an error group. Following are the possible status values:

    • Open: The default initial state of all error groups. The other states are set manually. You can revert an error group's status back to Open at any time.
    • Acknowledged: A state for triaging error groups.
    • Resolved: A state for indicating that an error group is fixed and no longer expected to occur. If an error group marked as Resolved later reoccurs, Error Reporting changes the resolution status back to Open.
    • Muted: A state for hiding an error group from your list. For more information, see Mute errors.

Mute errors

You can hide an error group from your Error Reporting list by changing its resolution status to Muted. Muted errors won't reappear in your list, even if they reoccur.

To view your muted error groups (and unmute them if desired), do the following:

  1. Click Manage muted errors:

    The user interface showing the muted errors menu.

  2. The Resolution status filters, only showing Resolved and Muted error groups.

    The user interface showing the resolution status muting option.

To unmute an error group, deselect its resolution status type from the same Resolution status panel.

Error Reporting won't send notifications if the muted error reoccurs.

Link errors to issues

You can link error groups to issues. Error groups that aren't associated with an issue link display an add icon . Error groups that are associated with an issue link display a link icon .

To view the issues associated with an error group, click the link icon next to each row in your list:

The user interface showing the link icon.

If the error group isn't associated with an issue URL, clicking on the add icon opens a Link an issue URL to this error panel, where you can enter a URL.

The user interface showing bug icon viewing options.

Set notifications

Error Reporting can notify you when new errors occur and when errors that have been marked Resolved reoccur. To learn more, and for instructions on setting notifications, see Configure and manage notifications.

Delete errors

You can delete all error events which are stored for the given Google Cloud project, and reset error counts to zero, using either the gcloud tool or the REST API.

gcloud

To delete all error events, run this command:

gcloud beta error-reporting events delete

REST API

To delete all error events, use the projects.deleteEvents method of the REST API.

If you subscribed to error notifications for the Google Cloud project and then deleted errors with a Resolved status, then the resolution status changes back to Open and Error Reporting sends a notification if the errors reoccur.

If you deleted errors with a status of Open or Acknowledged, Error Reporting doesn't send a notification if the errors reoccur.