Descripción general de Error Reporting

Error Reporting agrupa los errores producidos en tu nube en ejecución de Google Cloud. Estos errores son informados por el API de Error Reporting o se infieren que haya errores cuando Error Reporting inspecciona las entradas de registro en busca patrones de texto, como seguimientos de pila. Errores de grupos de Error Reporting que se considera que tienen la misma causa raíz.

Error Reporting se habilita de forma automática.

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 hay demasiados eventos recibidos, Error Reporting muestra hasta 100 errores por hora y seguir extrapolando los recuentos

Cuando Error Reporting analiza entradas de registro

Error Reporting es un servicio global Cloud Logging y puede analizar entradas de registro cuando todas las siguientes afirmaciones sean verdaderas:

  • Las Assured Workloads están inhabilitadas. Para obtener más información, consulta Descripción general de Assured Workloads.
  • Claves de encriptación administradas por el cliente (CMEK) está inhabilitada en todos los buckets de registros que almacenan la entrada de registro. Para obtener información sobre cómo determinar la configuración de CMEK para un bucket de registros, consulta Verifica la habilitación de la clave.
  • El bucket de registros cumple con una de las siguientes condiciones:
    • El bucket de registros se almacena en el mismo proyecto en el que se originaron las entradas de registro.
    • Las entradas de registro se enrutan a un proyecto y, luego, ese proyecto almacenó esas entradas de registro en uno de sus bucket de registros.
Si almacenas tus entradas de registro en buckets de registros con CMEK habilitadas, aún puedes usar Error Reporting. Sin embargo, debes usar el cliente de Error Reporting las bibliotecas o la API de Error Reporting. Para obtener más información, consulta la Descripción general de la API de Error Reporting y Cliente de Error Reporting bibliotecas.

Cómo se agrupan los errores

Cuando Error Reporting evalúa entradas de registro, ignora 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 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 una pila de excepciones se agrupan si fueron creados por la misma entrada de registro, aproximada por la ubicación de origen sobre la que se informó de (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 configuraste Assured Workloads para la residencia de datos o nivel de impacto 4 (IL4) Google Cloud inhabilita automáticamente Error Reporting.

En Cloud Logging, puedes regionalizar tus registros enrutando a una ubicación específica. En la página Grupos de errores, Error Reporting organiza y muestra grupos de errores según el región del bucket de registros que contiene las entradas de registro. Como Error Reporting es un servicio global, se puede acceder a ellos desde cualquier región. Este comportamiento no se puede configurar.

¿Qué sigue?