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:
The Error Reporting dashboard displays a list with a summary of each error found and the number of occurrences of each error.
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:
In Google Cloud console, select Error Reporting, or use the following button:
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:
To clear your resource filters and reset the error group list, select Reset and then select Apply.
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.
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:
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:
Go to the Operations > Error Reporting page in the Google Cloud console:
For each error group, Resolution status appears:
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:
Click Manage muted errors:
The Resolution status filters, only showing Resolved and Muted error groups.
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 add. Error groups that are associated with an issue link display a link icon link.
To view the issues associated with an error group, click the link icon link next to each row in your list:
If the error group isn't associated with an issue URL, clicking on the add icon add opens a Link an issue URL to this error panel, where you can enter a URL.
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.