Manage errors

Stay organized with collections Save and categorize content based on your preferences.

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.

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 the link icon.

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 Manage notifications.

Delete errors

You can delete all error events which are stored for the given 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 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.