Solución de problemas

Si los errores de tu aplicación no aparecen en Error Reporting, y, luego, sigue estos pasos para solucionar el problema.

Antes de comenzar

  1. Verifica que Error Reporting pueda analizar tus 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. Si deseas obtener información para determinar la configuración de CMEK de un bucket de registro, consulta Cómo verificar la habilitación de claves.
    • El bucket de registro 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 registro que le pertenece.
    Si almacenas tus entradas de registro en buckets de registro con CMEK habilitada, puedes seguir usando informes de errores. 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 las bibliotecas cliente de Error Reporting.

    Para ver una lista de los receptores que configuraste, ejecuta el siguiente comando:

    gcloud logging sinks list
    

    El comando muestra un resultado similar al siguiente:

    NAME               DESTINATION                                                                                                FILTER
    _Default           logging.googleapis.com/projects/my-team-project/locations/global/buckets/_Default                          NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT LOG_ID("externalaudit.googleapis.com/activity") AND NOT LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT LOG_ID("externalaudit.googleapis.com/system_event") AND NOT LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT LOG_ID("externalaudit.googleapis.com/access_transparency")
    _Required          logging.googleapis.com/projects/my-team-project/locations/global/buckets/_Required                         LOG_ID("cloudaudit.googleapis.com/activity") OR LOG_ID("externalaudit.googleapis.com/activity") OR LOG_ID("cloudaudit.googleapis.com/system_event") OR LOG_ID("externalaudit.googleapis.com/system_event") OR LOG_ID("cloudaudit.googleapis.com/access_transparency") OR LOG_ID("externalaudit.googleapis.com/access_transparency")
    logs-from-samples  logging.googleapis.com/projects/my-team-project/locations/global/buckets/sample-bucket                     (empty filter)
    regional_logs      logging.googleapis.com/projects/my-team-project/locations/europe-west1/buckets/bucket_for_regional_logs    (empty filter)
    test-logs          logging.googleapis.com/projects/team-b-project/locations/global/buckets/test-bucket                        (empty filter)
    

    En este ejemplo, el proyecto de Google Cloud de origen de las entradas de registro es my-team-project Estos fueron algunos de los resultados:

    • Error Reporting puede analizar las entradas de registro enrutadas por _Default, _Required y logs-from-samples porque el bucket de registros está que almacena el mismo proyecto que enruta las entradas de registro.
    • Error Reporting no puede analizar las entradas de registro almacenadas en el bucket de registro llamado test-logs porque el receptor en my-team-project enruta las entradas de registro a un bucket de registro en un proyecto diferente.
  2. Asegúrate de tener las Google Cloud CLI está instalado.

  3. Asegúrate de tener las Se habilitó el componente beta para la CLI de gcloud.

Cuando usar los registros

En esta sección, se proporciona asistencia para solucionar problemas cuando tus datos de errores se escriben en buckets de Cloud Logging y dependes de Error Reporting para analizar automáticamente esos buckets de registro.

Genera una entrada de registro como ejemplo

Para confirmar la configuración de tu proyecto, puedes generar una entrada de registro de manera programática. que Error Reporting recogerá con los siguientes gcloud: :

gcloud logging write --payload-type=json test-errors-log \
  '{"serviceContext":
    {"service": "manual-testing"},
    "message": "Test Error\n at /test.js:42:42",
    "context": {"httpRequest":
      {"url": "/test","method": "GET","responseStatusCode": 500}}}'

A continuación, abre Error Reporting y confirma que ves el error creado recientemente.

Confirma el formato de entrada de registro

Navega a la página de Cloud Logging y busca una entrada de registro que contenga datos de excepción enviados desde tu aplicación.

Confirma que la entrada de registro utiliza el formato esperado.

Cuando usar una API de Error Reporting

  1. Enable the required API.

    Enable the API

  2. Envía un error de prueba

    Intenta enviar un error al servicio de forma manual.

    Puedes informar un error de prueba a Error Reporting con el siguiente comando gcloud:

    gcloud beta error-reporting events report --service Manual --service-version test1 \
      --message "java.lang.TestError: msg
        at com.example.TestClass.test(TestClass.java:51)
        at com.example.AnotherClass(AnotherClass.java:25)"
    

    Puedes usar un comando cURL para probar tus llamadas a la API de REST. Reemplaza PROJECT_ID y API_KEY con los valores válidos antes de enviar el siguiente comando:

    curl -X POST -H "Content-Type: application/json" \
      -d '{"message":"java.lang.TestError: msg\n\tat com.example.TestClass.test(TestClass.java:51)\n\tat com.example.AnotherClass(AnotherClass.java:25)","serviceContext":{"service":"manual-testing"}}' \
      https://clouderrorreporting.googleapis.com/v1beta1/projects/PROJECT_ID/events:report?key=API_KEY
    
  3. Confirma la carga útil enviada

    Asegúrate de que tu aplicación esté enviando datos de excepción a la API en el formato correcto y que contenga los atributos requeridos.