Descripción general de Error Reporting

Error Reporting agrega los errores producidos en los servicios en la nube que se estén ejecutando. Estos errores se notifican mediante la API Error Reporting o se infieren cuando Error Reporting inspecciona las entradas de registro en busca de patrones de texto habituales, como los rastreos de pila. Error Reporting agrupa los errores 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 errores

Cuando Error Reporting evalúa las entradas de registro, ignora las que cumplen las siguientes condiciones:

  • En el entorno estándar de App Engine, los errores registrados con una gravedad inferior a ERROR se ignoran.
  • Se ignoran los marcos de pila que no son propiedad del usuario (por ejemplo, los que pertenecen a bibliotecas públicas).
  • Cualquier secuencia repetida de uno o varios marcos de pila se sustituye por una sola aparición de esa secuencia.
  • Se eliminan los métodos y símbolos introducidos 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 rastreo de la pila se ignora en las excepciones que normalmente no están relacionadas con la ubicación de origen en la que se producen.
  • Los errores sin un stack de excepciones se agrupan si se han creado con la misma entrada de registro, aproximada por la ubicación de origen desde la que se ha informado (reportLocation).

En concreto, se aplican las siguientes reglas de agrupación en este orden:

Tipo de error Agrupado por
Errores 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.
Errores con un rastreo de la 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.
Errores sin rastreo 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 de 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 registros 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, seleccione un valor en el menú Región. El valor predeterminado de este menú es global.

El menú Región de la página Grupos de errores.

Siguientes pasos