Error Reporting agrega los errores que se producen en los servicios de la nube en ejecución. La API de Error Reporting informa estos errores o se infiere que son errores cuando Error Reporting inspecciona las entradas de registro en busca de patrones de texto comunes, como los seguimientos de pila. Error Reporting agrupa los errores que se considera tienen la misma causa raíz.
Error Reporting se habilita automáticamente.
Error Reporting hace un muestreo de hasta 1,000 errores por hora. Cuando se llega a este límite, se estiman los recuentos mostrados. Si se reciben demasiados eventos, Error Reporting toma muestras de hasta 100 errores por hora y continúa con la proyección de recuentos.
Cuándo Error Reporting analiza las entradas de registro
Error Reporting es un servicio global compilado en Cloud Logging y puede analizar entradas de registro cuando se cumplen todas las siguientes condiciones:
- Las cargas de trabajo de Assured Workloads están inhabilitadas. Para obtener más información, consulta la descripción general de Assured Workloads.
- La opción Claves de encriptación administradas por el cliente (CMEK) está inhabilitada en todos los buckets de registro que almacenan la entrada de registro. Si deseas obtener información para determinar la configuración de CMEK de un bucket de registros, consulta Cómo verificar la habilitación de claves.
- El bucket de registros satisface una de las siguientes opciones:
- El bucket de registros 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, luego, ese proyecto las almacenó en un bucket de registros que le pertenece.
Cómo se agrupan los errores
Cuando Error Reporting evalúa las entradas de registro, ignora las entradas de registro con las siguientes condiciones:
- En un entorno estándar de App Engine, se ignoran los errores que se registran con una severidad menor que
ERROR
. - Se ignoran los marcos de pila que no son propiedad del usuario (p. ej., aquellos que pertenecen a bibliotecas públicas).
- Cualquier secuencia repetida de uno o más marcos de pila se reemplaza por un único caso de esa secuencia.
- Se quitan los métodos y símbolos ingresados por el compilador.
A continuación, Error Reporting sigue estas reglas para agrupar los errores:
- Las excepciones se agrupan si tienen el mismo tipo de excepción y pilas similares.
- El seguimiento de pila se ignora para excepciones que comúnmente no se relacionan con la ubicación de origen en que sucedieron.
- Los errores sin ninguna pila de excepciones se agrupan si fueron creados por la misma entrada de registro, calculado por la ubicación de origen de la cual se informó (
reportLocation
).
En específico, las siguientes reglas de agrupación se aplican en este orden:
Tipo de error | Agrupado por |
---|---|
Errores provocados por un problema general en el entorno.
Ejemplos de problemas específicos de App Engine: com.google.apphosting.runtime.HardDeadlineExceededError com.google.appengine.api.datastore.DatastoreTimeoutException Problemas de Java: java.util.concurrent.CancellationException |
Agrupado por tipo de excepción. |
Errores con seguimiento de pila. En el caso de excepciones anidadas, se considera la excepción más interna.
Por ejemplo: runtime error: index out of range package1.func1() file1:20 package2.func2() file2:33 |
Agrupado por tipo de excepción y los 5 marcos principales. |
Errores sin seguimiento de pila, pero con un mensaje.
Por ejemplo: runtime error: index out of range func1() |
Agrupado por mensaje y (si existe) nombre de función. Solo se consideran los primeros 3 tokens del mensaje. En el ejemplo de la izquierda, estos tokens son runtime , error y index . |
Regionalidad de los datos
Si configuras Assured Workloads para requisitos de residencia de datos o Impact Level 4 (IL4), Google Cloud inhabilita automáticamente Error Reporting.
En Cloud Logging, puedes regionalizar tus registros enrutálos
a una ubicación específica. En la página Error Groups,
Error Reporting organiza y muestra los grupos de errores según la
región del bucket de registros 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 bucket de registros en us-central-1
. Los grupos de errores globales solo contienen registros de errores que forman parte de un bucket de registros en la región global
.
Para filtrar la región de los grupos de errores que se muestran en la página Errores, selecciona un valor del menú Región. Este menú tiene un valor predeterminado de global
.