Cómo encontrar entradas de registro con grupos de errores
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se describe cómo encontrar, filtrar y excluir entradas de registro que forman parte de grupos de errores cuando se usa el Explorador de registros.
Los grupos de errores te ayudan a identificar tendencias y problemas recurrentes en tu entorno, ya que agrupan las entradas de registro que tienen errores por valores como el tipo de excepción, los marcos o los mensajes.
Cómo encontrar detalles del grupo de errores para una entrada de registro
Para hacer un seguimiento de los errores recurrentes en tu aplicación y administrar su estado de resolución, usa la página Error Reporting de la consola de Google Cloud .
En la página Error Reporting, se enumeran los grupos de errores, incluida información sobre el tipo específico de error, la cantidad de casos de error y el estado de resolución de cada grupo.
Error Reporting establece automáticamente el valor del campo ID de error_groups durante la creación de un grupo de errores. El campo contiene caracteres alfanuméricos, - y _.
Para consultar un grupo de errores específico, haz lo siguiente:
En la consola de Google Cloud , ve a la página Error Reporting:
También puedes usar la barra de búsqueda para encontrar esta página.
Haz clic en el nombre del error.
En el panel Muestras recientes, haz clic en Ver registros en cualquier entrada de registro para que se te redireccione a la página del Explorador de registros.
En el Explorador de registros, el campo del editor de consultas se propaga con el campo de ID error_groups. Por ejemplo, errorGroups.id="CJqhkd7Qvsbj2QE".
La lista de entradas de registro que contribuyen a ese grupo de errores se muestra en el panel Resultados de la consulta.
Para consultar las entradas de registro que pertenecen a cualquier grupo de errores y encontrar los detalles del grupo de errores, haz lo siguiente:
En la consola de Google Cloud , ve a la página Explorador de registros.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
Para ver las entradas de registro asociadas con cualquier grupo de errores, ingresa el siguiente filtro en el campo del editor de consultas:
errorGroups.id:*
En el panel Resultados de la consulta, selecciona una entrada de registro que muestre el botón Error group.
Haz clic en el botón Grupo de errores y selecciona Ver detalles del grupo de errores:
Por ejemplo, en la siguiente captura de pantalla, se muestran dos entradas de registro con un nivel de gravedad de, al menos, error.
Una de estas entradas está anotada con el botón Grupo de errores. En la siguiente captura de pantalla, también se ilustran las opciones disponibles con este botón:
Después de seleccionar Ver detalles del grupo de errores, se abrirá la página Error Reporting y se mostrará información sobre el grupo de errores.
También puedes usar las opciones del botón Grupo de errores para cambiar las entradas de registro que muestra el Explorador de registros:
Para investigar el grupo de errores con más detalle, selecciona Mostrar entradas en este grupo de errores. Se actualiza el Explorador de registros y solo se muestran las entradas de registro del mismo grupo de errores. Ahora puedes aplicar parámetros de consulta adicionales a las entradas de registro del grupo de errores.
Para quitar un grupo de errores específico de los resultados de la búsqueda, selecciona Ocultar entradas en este grupo de errores. El Explorador de registros se actualiza y todas las entradas de registro de este grupo de errores se ocultan de la pantalla.
Supervisa grupos de errores
Puedes configurar Error Reporting para que te envíe notificaciones cuando detecte un grupo de error nuevo. Este servicio también te permite ver el historial de errores de cada grupo y administrarlos. Para obtener más información, consulta los siguientes documentos:
No puedes crear métricas basadas en registros que cuenten la cantidad de entradas de registro con grupos de errores ni configurar una alerta basada en registros para que te notifique cuando una entrada de registro contenga un grupo de errores. Del mismo modo, no puedes extraer valores del campo errorGroups en una etiqueta adjunta a una métrica basada en registros o una alerta basada en registros.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[],[],null,["# Find log entries with error groups\n\nThis document describes how to find, filter, and exclude log entries that are\npart of error groups when using the Logs Explorer.\n[Error groups](/error-reporting/docs/grouping-errors)\nhelp you identify trends and recurring problems in your environment by grouping\nlog entries that have errors by values such\nas exception type, frames, or messages.\n\nFind error group details for a log entry\n----------------------------------------\n\nTo track recurring errors across your application and to manage their resolution\nstatus, use the **Error Reporting** page of the Google Cloud console.\nThe **Error Reporting** page lists error groups, including\ninformation about the specific type of error, the number of error occurrences,\nand the resolution status of each group.\n\nError Reporting automatically sets the value of the\n`error_groups` ID field during the creation of an error group. The field\ncontains alphanumeric characters, `-` and `_`.\n\nTo query for a specific error group, do the following:\n\n1. In the Google Cloud console, go to the **Error Reporting** page:\n\n [Go to **Error Reporting**](https://console.cloud.google.com/errors)\n\n \u003cbr /\u003e\n\n You can also find this page by using the search bar.\n2. Click the error name.\n3. In the **Recent samples** panel, click **View Logs** from any log entry to redirect you to the **Logs Explorer** page.\n4. In the **Logs Explorer** , the query-editor field is populated with the\n `error_groups` ID field. For example, `errorGroups.id=\"CJqhkd7Qvsbj2QE\"`.\n\n The list of log entries contributing to that error group is shown in the\n **Query results** pane.\n\nTo query for log entries that belong to any error group and to find the error\ngroup details, do the following:\n\n1. In the Google Cloud console, go to the **Logs Explorer** page:\n\n [Go to **Logs Explorer**](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. To view log entries associated with any error group, enter the following\n filter into the query-editor field:\n\n errorGroups.id:*\n\n3. In the **Query results** pane, select a log entry that displays the\n **Error group** button.\n\n4. Click the **Error group** button and\n select **View error group details**:\n\n For example, the following screenshot shows two log entries with a\n severity level of at least error.\n One of these entries is annotated with the\n **Error group** button. The following screenshot also illustrates the\n options available with this button:\n\n After you select **View error group details** , the **Error reporting**\n page opens and displays information about the error group.\n\nYou can also use the options in the\n**Error group** button to change which log entries the Logs Explorer\ndisplays:\n\n- To investigate the error group in more detail, select\n **Show entries in this error group**. Logs Explorer is refreshed and\n displays only those log entries in the same error group. You can now apply\n additional query parameters to the error group's log entries.\n\n- To remove a specific error group from your query results,\n select **Hide entries in this error group**. Logs Explorer is refreshed\n and all log entries in this error group are hidden from the display.\n\nMonitor error groups\n--------------------\n\nYou can configure Error Reporting to notify you when it detects a\nnew error group. This service also lets you view the history of errors for\neach error group and to manage those errors. For more information,\nsee the following documents:\n\n- [Configure and manage notifications](/error-reporting/docs/notifications)\n- [View and filter errors](/error-reporting/docs/viewing-errors)\n\nYou can't create log-based metrics that count the number of log entries with\nerror groups or configure a log-based alert to notify you when a log entry\ncontains an error group. Similarly, you can't extract values from the\n`errorGroups` field into a label attached to a log-based metric or\nlog-based alert."]]