Find log entries with error groups

This document describes how to find, filter, and exclude log entries that are part of error groups when using the Logs Explorer. Error groups help you identify trends and recurring problems in your environment by grouping log entries that have errors by values such as exception type, frames, or messages.

Find error group details for a log entry

To track recurring errors across your application and to manage their resolution status, use the Error Reporting page of the Google Cloud console. The Error Reporting page lists error groups, including information about the specific type of error, the number of error occurrences, and the resolution status of each group.

Error Reporting automatically sets the value of the error_groups ID field during the creation of an error group. The field contains alphanumeric characters, - and _.

To query for a specific error group, do the following:

  1. In the navigation panel of the Google Cloud console, select Error Reporting, and then select your Google Cloud project:

    Go to Error Reporting

  2. Click the error name.
  3. In the Recent samples panel, click View Logs from any log entry to redirect you to the Logs Explorer page.

  4. In the Logs Explorer, the query-editor field is populated with the error_groups ID field. For example, errorGroups.id="CJqhkd7Qvsbj2QE".

    The list of log entries contributing to that error group is shown in the Query results pane.

To query for log entries that belong to any error group and to find the error group details, do the following:

  1. In the navigation panel of the Google Cloud console, select Logging, and then select Logs Explorer:

    Go to Logs Explorer

  2. To view log entries associated with any error group, enter the following filter into the query-editor field:

    errorGroups.id:*

  3. In the Query results pane, select a log entry that displays the Error group button.

  4. Click the Error group button and select View error group details:

    For example, the following screenshot shows two log entries with a severity level of at least error. One of these entries is annotated with the Error group button. The following screenshot also illustrates the options available with this button:

    Example of log entry with error reporting grouping.

    After you select View error group details, the Error reporting page opens and displays information about the error group.

You can also use the options in the Error group button to change which log entries the Logs Explorer displays:

  • To investigate the error group in more detail, select Show entries in this error group. Logs Explorer is refreshed and displays only those log entries in the same error group. You can now apply additional query parameters to the error group's log entries.

  • To remove a specific error group from your query results, select Hide entries in this error group. Logs Explorer is refreshed and all log entries in this error group are hidden from the display.