Recopila datos de errores con Error Reporting

En este documento, se enumeran los entornos compatibles con Error Reporting y se vincula a guías específicas de cada lenguaje para desarrolladores de aplicaciones. Te recomendamos que uses las bibliotecas cliente específicas de un lenguaje o basarse en entradas de registro recopiladas automáticamente; Sin embargo, puedes escribir datos de errores con la API de Cloud Logging o la API de Error Reporting. Por ejemplo, si utilizas Cloud Run Luego, las excepciones que se escriben en stderr se envían automáticamente a Cloud Logging.

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.

Asistencia para la nube privada virtual

Error Reporting es una nube privada virtual (VPC) compatible servicio.

Para reducir el riesgo de robo de datos, usa los Controles del servicio de VPC para crear un perímetro de servicio alrededor de los servicios administrados por Google. Obtén información sobre los Controles del servicio de VPC y cómo crear un servicio. parámetro, consulta la Documentación de los Controles del servicio de VPC.

Configura entornos para informar automáticamente los datos de errores

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

Instrumenta las apps con bibliotecas cliente

Si quieres obtener información sobre cómo configurar tu aplicación para enviar informes de errores, consulta las guías de configuración específicas para cada lenguaje:

Escribe datos de errores con una API

Puedes informar eventos de errores a tu proyecto de Google Cloud de la siguiente manera: ejecutar el método de la API de Error Reporting report o el método de la API de Cloud Logging write

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

    Cuando uses la API de Error Reporting, registra entradas los mensajes de error con formato se generan y escriben automáticamente en Cloud 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 través de llamadas a report, puedes incurrir en Costos de transferencia de Cloud Logging Para controlar qué entradas de registro se transfieren, consulta Filtros de exclusión.

    Si informas eventos de errores mediante la API de Error Reporting, el resto de este documento no se aplica.

  • Si quieres usar la API de Cloud Logging, debes dar formato al archivo LogEntry para que incluya un seguimiento de pila. o un objeto ReportedErrorEvent. Más información sobre los requisitos de formato, consulta Errores de formato en los registros.