Error Reporting agrega los eventos de error que se producen en los servicios en la nube que se están ejecutando. Un evento de error representa una sola instancia de un error en tu aplicación. Los datos almacenados de cada evento incluyen información sobre el error, como la hora en la que se produjo, el contexto en el que se produjo y el mensaje de error que se devolvió.
Los eventos de error se registran mediante la API Error Reporting o se infieren mediante Error Reporting cuando inspecciona las entradas de registro en busca de patrones de texto comunes, como los seguimientos de pila. Error Reporting agrupa los eventos de error que se considera que tienen la misma causa principal.
Error Reporting está habilitado automáticamente.
Error Reporting toma muestras de hasta 1000 errores por hora. Cuando se alcanza este límite, los recuentos que se muestran son estimaciones. Si se reciben demasiados eventos, Error Reporting toma una muestra de hasta 100 errores por hora y sigue extrapolando los recuentos.
Cuando Error Reporting analiza las entradas de registro
Error Reporting es un servicio global basado en Cloud Logging que puede analizar entradas de registro cuando se cumplen todas las condiciones siguientes:
- Las cargas de trabajo de Assured Workloads están inhabilitadas. Para obtener más información, consulta la descripción general de Assured Workloads.
- Las claves de cifrado gestionadas por el cliente (CMEK) están inhabilitadas en todos los segmentos de registro que almacenan la entrada de registro. Error Reporting no puede almacenar entradas de registro en segmentos de registro que tengan habilitada la CMEK. Para obtener información sobre cómo determinar la configuración de CMEK de un contenedor de registro, consulta Verificar la habilitación de claves.
- El contenedor de registro cumple una de las siguientes condiciones:
- El segmento de registro se almacena en el mismo proyecto en el que se originaron las entradas de registro.
- Las entradas de registro se enrutaron a un proyecto y, a continuación, ese proyecto almacenó las entradas de registro en un segmento de registro de su propiedad.
Cómo se agrupan los eventos de error
Cuando Error Reporting evalúa las entradas de registro para identificar eventos de error, ignora las entradas de registro que cumplen las siguientes condiciones:
- Entradas de registro escritas por el entorno estándar de App Engine que tienen un nivel de gravedad inferior a
ERROR. - Marcos de pila que no son propiedad del usuario (por ejemplo, los que pertenecen a bibliotecas públicas).
Cuando se analiza una entrada de registro, Error Reporting hace las siguientes modificaciones antes de inferir eventos de error:
- Sustituye cualquier secuencia repetida de uno o varios marcos de pila por una sola aparición de esa secuencia.
- Elimina los métodos y símbolos introducidos por el compilador.
Error Reporting aplica estas reglas, en el orden especificado, para agrupar eventos de error:
| Error Event | Agrupado por |
|---|---|
| Eventos de error causados por un problema general en el entorno.
Por ejemplo, problemas específicos de App Engine: com.google.apphosting.runtime.HardDeadlineExceededError com.google.appengine.api.datastore.DatastoreTimeoutException Problemas de Java: java.util.concurrent.CancellationException |
Se agrupa por tipo de excepción. |
| Eventos de error con un seguimiento de pila. En el caso de las excepciones anidadas, se tiene en cuenta la excepción más interna.
Por ejemplo: runtime error: index out of range
package1.func1()
file1:20
package2.func2()
file2:33 |
Agrupadas por tipo de excepción y los cinco marcos superiores. |
| Eventos de error sin un seguimiento de pila, pero con un mensaje.
Por ejemplo: runtime error: index out of range
func1() |
Agrupados por mensaje y, si está presente, por nombre de función. Solo se tienen en cuenta los tres primeros tokens literales del mensaje. En el ejemplo de la izquierda, estos
son runtime, error y index. |
Regiones de datos
Si configura Assured Workloads para cumplir los requisitos de residencia de datos o del nivel de impacto 4 (IL4), Error Reporting se Google Cloud inhabilitará automáticamente.
En Cloud Logging, puedes regionalizar tus registros dirigiéndolos a una ubicación específica. En la página Grupos de errores, Error Reporting organiza y muestra los grupos de errores en función de la región del bucket de registro que contiene las entradas de registro. Por ejemplo, un grupo de errores que aparece en us-central-1 solo contiene registros de errores que forman parte de un segmento de registros de us-central-1. Los grupos de errores globales solo contienen registros de errores que forman parte de un contenedor de registro de la región global.
Para filtrar la región de los grupos de errores que se muestran en la página Grupos de errores, selecciona un valor en el menú Región. El valor predeterminado de este menú es global.
