Administra los errores

En esta página, se explica cómo puedes administrar los errores en Error Reporting.

Comenzar

Para ver los errores de los servicios y las apps en el proyecto de Google Cloud, ve a Error Reporting en Google Cloud Console:

Ir a Error Reporting

En el panel de Error Reporting, se muestra una lista con un resumen de cada error encontrado y la cantidad de casos de cada error.

La interfaz de usuario que muestra la lista de errores

Sugerencia: Trata esta lista como la carpeta Recibidos del correo electrónico. Para que sea claro y útil, corrige los errores subyacentes o silencia los errores esperados y recurrentes.

Para obtener más información sobre cómo ver y filtrar en tu lista de Error Reporting, consulta Ver errores.

A fin de obtener información sobre los permisos necesarios para administrar los errores, consulta Control de acceso con la IAM.

Muestras de errores

Por lo general, los errores que se agrupan son muy similares y, por ello, Error Reporting solo conserva 1,000 muestras y extrapola la información restante. Para mantener todos los casos de un error, considera enrutar tus registros a BigQuery a fin de que se guarden los casos futuros del error.

Para cada muestra, la IU permite ver los datos que la aplicación envía a Error Reporting. Por ejemplo, el entorno estándar de App Engine proporciona metadatos útiles, como el usuario-agente y la URL de la solicitud que generó el error. Si envías tus propios informes de error como entradas de registro, verifica la lista de campos que puedes proporcionar. Si usas la API de Error Reporting, consulta el objeto ReportedErrorEvent.

Para obtener más información, consulta Cómo se agrupan los errores.

Cambiar estado de resolución

Para administrar tu flujo de trabajo, sigue estos pasos y cambia el estado de la resolución de tus grupos de errores:

  1. Ve a la página Operaciones > Error Reporting en Cloud Console:

    Ir a la página de Error Reporting

  2. Para cada grupo de errores, aparece un Estado de resolución (Resolution Status):

    La interfaz de usuario muestra el estado de resolución de errores.

  3. En el panel anterior, expande la columna Resolution status para cambiar el estado de un grupo de errores. A continuación, se presentan los valores de estado posibles:

    • Open (Abierto): el estado inicial predeterminado de todos los grupos de errores. Los demás estados se configuran de forma manual. Puedes revertir el estado de un grupo de errores a Open en cualquier momento.
    • Acknowledged (Confirmado): un estado para clasificar grupos de errores.
    • Resolved (Resuelto): un estado para indicar que se ha solucionado un grupo de errores y ya no se espera que suceda. Si un grupo de errores marcado como Resuelto vuelve a ocurrir, Error Reporting cambia el estado de resolución a Abierto.
    • Silenciado (Muted): Un estado para ocultar un grupo de errores de la lista. Para obtener más información, consulta Cómo silenciar errores.

Silenciar errores

Puedes ocultar un grupo de errores de la lista de Error Reporting si cambias su estado de resolución a Silenciado. Los errores silenciados no volverán a aparecer en la lista, aunque vuelvan a producirse.

Para ver los grupos de errores silenciados (y dejar de silenciarlos si lo deseas), haz lo siguiente:

  1. Haz clic en Administrar errores silenciados (Manage muted errors):

    La interfaz de usuario que muestra el menú de errores silenciados.

  2. Aparecerá la página Errores silenciados (Muted Errors). En la barra de navegación superior, expande el panel Estado de resolución. Selecciona los tipos de estado de la resolución de los grupos de errores que deseas ocultar de tu lista.

    La interfaz de usuario que muestra la opción de silenciamiento del estado de resolución.

Para dejar de silenciar un grupo de errores, deselecciona su tipo de estado de la resolución del mismo panel de Resolution status.

Error Reporting no enviará notificaciones si se repite el error silenciado.

Vincula errores a problemas

Puedes vincular grupos de errores con problemas.

Para ver o cambiar los problemas asociados con un grupo de errores, haz clic en el ícono de informe de errores  junto a cada fila de la lista:

La interfaz de usuario que muestra el ícono de error.

Si el grupo de errores aún no está asociado con la URL de un problema, puedes hacer clic en el ícono de informe de errores  para que se abra el panel Vincular una URL de un problema a este error, en el que puedes ingresar la URL correspondiente.

Si un grupo de errores ya está asociado con una URL en el sistema de la Herramienta de seguimiento de errores, puedes hacer clic en el ícono de informe de errores  para que se abra ese vínculo en una nueva pestaña del navegador.

Notificaciones

Error Reporting puede notificarte cuando se producen errores nuevos y cuando los errores que se marcaron como Resueltos vuelven a ocurrir. Para obtener más información y obtener instrucciones sobre cómo configurar las notificaciones, consulta Administra notificaciones.

Borrar errores

Puedes borrar todos los eventos de errores que se almacenan para el proyecto de Cloud determinado y restablecer los recuentos de errores a cero mediante la herramienta de gcloud o la API de REST.

gcloud

Para borrar todos los eventos de errores, ejecuta este comando:

gcloud beta error-reporting events delete

API de REST

Para borrar todos los eventos de errores, usa el método projects.deleteEvents de API de REST.