Recopila datos de errores con Error Reporting

Puedes enviar excepciones de aplicaciones y eventos de error a Error Reporting para que pueda analizar los datos de error en tu proyecto deGoogle Cloud . Según tu entorno de procesamiento, lenguaje de programación y requisitos de autenticación, puedes recopilar datos de errores de las siguientes maneras:

  • Recopilación automática de registros: Los entornos de procesamiento compatibles envían automáticamente datos de errores a Cloud Logging para que Error Reporting los analice. Por ejemplo, Cloud Run envía automáticamente las excepciones escritas en stderr a Logging.
  • Bibliotecas cliente: Puedes instrumentar el código de la aplicación con bibliotecas cliente específicas del lenguaje para enviar informes de errores directamente desde tu app.
  • APIs de REST: Puedes llamar a la API de Error Reporting o a la API de Cloud Logging para escribir eventos de error y seguimientos de pila con formato, incluso cuando requieras autenticación con clave de API.

Cuándo Error Reporting analiza las entradas de registro

Error Reporting es un servicio global creado en Cloud Logging y puede analizar entradas de registro cuando se cumplen todas las siguientes condiciones:

  • Assured Workloads está inhabilitado. Para obtener más información, consulta la descripción general de Assured Workloads.
  • Las claves de encriptación administradas por el cliente (CMEK) están inhabilitadas en todos los buckets de registros que almacenan la entrada de registro. Error Reporting no puede almacenar entradas de registro en buckets de registros que tengan habilitada la CMEK. Para obtener información sobre cómo determinar la configuración de CMEK de un bucket de registros, consulta Verifica la habilitación de la clave.
  • El bucket de registros satisface 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 enrutaron a un proyecto y, luego, ese proyecto las almacenó en un bucket de registros que le pertenece.

Compatibilidad con los Controles del servicio de VPC

Los Controles del servicio de VPC admiten Error Reporting.

Para reducir el riesgo de robo de datos, usa los Controles del servicio de VPC para crear un perímetro de servicio en torno a tus servicios administrados por Google. Para obtener información sobre los Controles del servicio de VPC y cómo crear un perímetro de servicio, consulta la documentación de los Controles del servicio de VPC.

Configura entornos para informar datos de errores automáticamente

Para obtener información sobre los requisitos de configuración específicos del entorno, consulta las siguientes guías:

Instrumenta apps con bibliotecas cliente

Para obtener información sobre cómo configurar tu aplicación para que envíe informes de errores, consulta las guías de configuración específicas para cada lenguaje:

Escribe datos de error con una API

Puedes informar eventos de error a tu proyecto de Google Cloud ejecutando el método de la API de Error Reportingreport o el método de la API de Loggingwrite.

  • Si necesitas autenticación basada en claves de API, debes usar la API de Error Reporting. Para informar un evento de error con la API de Error Reporting, ejecuta el método report y formatea el cuerpo de la solicitud del método como un objeto ReportedErrorEvent.

    Cuando usas la API de Error Reporting, se generan automáticamente entradas de registro con mensajes de error con el formato adecuado y se escriben en Logging. Estas entradas de registro se escriben en un registro cuyo logName tiene el siguiente formato:

    projects/PROJECT_ID/clouderrorreporting.googleapis.com%2Freported_errors

    Debido a que las entradas de registro se generan a partir de llamadas a report, es posible que incurras en costos de transferencia de registros de Logging. Para controlar qué entradas de registro se transfieren, consulta Filtros de exclusión.

  • Si deseas usar la API de Logging, debes darle formato al objeto LogEntry para que incluya un seguimiento de pila o un objeto ReportedErrorEvent. Para obtener más información sobre los requisitos de formato, consulta Errores de formato en los registros.