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.