Explora los resultados del monitor sintético

En este documento, se describe cómo explorar el historial de ejecución de tus monitores sintéticos y cómo ver las métricas y los registros recopilados.

Antes de comenzar

Si quieres obtener los permisos que necesitas para ver los resultados de la ejecución de los monitores sintéticos con la consola de Google Cloud, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Cómo ver el historial de ejecución de un monitor sintético

Para comprender el historial de ejecuciones aprobadas y con errores, consulta la página Detalles del monitor sintético:

  1. En el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego, elige  Supervisión sintética:

    Ir a Supervisión sintética

  2. Para abrir la página Detalles del monitor sintético, ubica el monitor sintético que deseas ver y, luego, haz clic en su nombre.

En la página Detalles del supervisor sintético, se muestra información de resumen, como la tasa de éxito, la duración y el estado más reciente. En esta página, también se muestra la duración registrada de la ejecución, y contiene una tabla que muestra una fila por cada ejecución.

Cada fila de la tabla enumera el estado, la fecha y la duración, y se vincula a una página que muestra el código actual y los registros relevantes para esa ejecución.

Visualiza registros y seguimientos de una ejecución

Para ver los registros, los seguimientos y la información resumida de una ejecución, en la página Detalles del supervisor sintético, haz clic en el vínculo a la ejecución. Desde esta página, puedes hacer lo siguiente:

  • Consulta datos de registro.
  • Consulta los datos de seguimiento.

  • Consulta el código actual.

  • Accede a la Cloud Function.

  • En el caso de la prueba Mocha, ve los resultados de cada prueba. Por ejemplo, si tu monitor sintético contiene cuatro pruebas de Mocha, el panel Test results contendrá cuatro entradas. Cada entrada de la lista se anotó como aprobada o fallida.

    Si seleccionas una entrada marcada como con errores, el código con errores se muestra y se destaca.

Ver datos de registros

Cloud Monitoring recopila los registros automáticamente. Estos registros contienen información sobre los detalles de la prueba y las fallas. Los registros disponibles dependen de tu Cloud Function. Por ejemplo, si usas Mocha, los registros incluyen información sobre si la prueba se aprobó o falló, la duración de la prueba y, en caso de fallas, un seguimiento de pila completa. El seguimiento de pila incluye la línea de código que falló, los tipos de errores y los mensajes de error.

Para ver los detalles de tus registros relacionados, en el panel Registros de ejecución, expande una entrada de registro.

La entrada de registro se muestra en formato JSON. Si prefieres ver los registros con el Explorador de registros, haz clic en Abrir en el Explorador de registros. Se abre el Explorador de registros y se preconfigura una consulta.

Visualiza datos de seguimiento

Los datos de seguimiento se recopilan automáticamente cuando se ejecuta la Cloud Function. En la siguiente captura de pantalla, se muestra el tipo de datos que captura el seguimiento cuando usas la plantilla genérica:

Cloud Trace muestra detalles de un seguimiento de una Cloud Function.

En la captura de pantalla anterior, la primera fila del diagrama de Gantt muestra la solicitud HTTP que inició Cloud Monitoring. Los datos de seguimiento muestran el texto que se pasó al registrador de winston y la solicitud HTTP saliente emitida por la llamada get de axios.

En el menú flotante de seguimiento, si haces clic en Ver en seguimiento, podrás ver tus datos de seguimiento con el explorador de Cloud Trace. El seguimiento ya está expandido para mostrar detalles. Cuando el seguimiento o el intervalo muestran un círculo, puedes hacer clic en él para mostrar la entrada de registro. Para identificar la función de Cloud Functions, observa el campo resource.labels.service_name.

Console

Para ver los datos de seguimiento, realiza una de las siguientes acciones:

  • Para ver la información resumida de un seguimiento, en la barra de herramientas de la página de detalles de una ejecución, haz clic en Ver detalles de seguimiento.

    Se abrirá un menú flotante que muestra un resumen de los datos de latencia. Para obtener información completa sobre el seguimiento y sus intervalos, consulta los datos en Cloud Trace. Para abrir Cloud Trace, haz clic en Ver en seguimiento.

  • Visualiza los seguimientos en Cloud Trace:

    1. En el panel de navegación de la consola de Google Cloud, selecciona Trace y, luego, Explorador de seguimiento:

      Ve al Explorador de seguimiento

    2. En el diagrama de dispersión o en la tabla, selecciona un seguimiento.
    3. Para cada registro o evento asociado con un intervalo, el intervalo se anota con un círculo. Para obtener detalles sobre el evento o el registro, selecciona el círculo.

Si deseas obtener más información para explorar los datos de seguimiento, consulta Cómo buscar y explorar seguimientos.

API

Te recomendamos que uses la consola de Google Cloud para ver los datos de seguimiento. Sin embargo, si deseas usar la API de Cloud Trace, usa el método traces.list para enumerar los seguimientos disponibles y, luego, usa el método traces.get para obtener los detalles de un seguimiento.

Visualiza registros y métricas de una Cloud Function

Los registros y las métricas te proporcionan información sobre las acciones que realiza la Cloud Function. Por ejemplo, los registros que contienen un campo llamado userAgent con un valor de GoogleStackdriverMonitoring-UptimeChecks indican que tu servicio recibió una solicitud del servicio de verificación de tiempo de actividad.

En el resto de esta sección, se describe cómo ver los registros y las métricas que recopila Cloud Functions.

Ver registros de funciones

Console

Para ver los registros de Cloud Function, haz lo siguiente:

  1. En el panel con el nombre de tu monitor sintético, haz clic en el nombre de la Cloud Function.
  2. En la página Detalles de la función, selecciona la pestaña Registros.

Para explorar los datos de registro en un gráfico con más detalle, expande una entrada de registro y selecciona Abrir en el Explorador de registros (Open in Logs Explorer). Desde el Explorador de registros, puedes realizar acciones como definir mejor la consulta, crear una métrica basada en registros o crear una alerta basada en registros.

API

Para obtener información sobre cómo leer y escribir registros de Cloud Function de manera programática, consulta Escribe, visualiza y responde registros.

Visualiza las métricas de la función

En el caso de los monitores sintéticos, Cloud Monitoring y Cloud Functions recopilan métricas:

  • Cloud Monitoring recopila métricas sobre cada ejecución de un monitor sintético. Estas métricas incluyen la latencia de la ejecución del código y el historial de éxito. Si quieres obtener información para ver estas métricas, consulta Cómo ver el historial de ejecución de un monitor sintético.

  • Cloud Functions recopila métricas sobre cada Cloud Function. Estas métricas registran el tiempo de ejecución, el uso de memoria, el recuento de instancias y la cantidad de invocaciones por sección. En el resto de esta sección, se describe cómo ver estas métricas.

Console

Para ver las métricas de Cloud Function, haz lo siguiente:

  1. En el panel con el nombre de tu monitor sintético, haz clic en el nombre de la Cloud Function.
  2. En la página Detalles de la función, selecciona la pestaña Métricas.

Para acercar un intervalo de tiempo específico, haz lo siguiente:

  1. En un gráfico, coloca el puntero en un extremo del intervalo de tiempo y, luego, haz clic con el botón izquierdo en él.
  2. Arrastra el puntero de forma horizontal al otro extremo del intervalo de tiempo y, luego, suelta el botón del puntero.

Para explorar con más detalle los datos que se muestran en un gráfico, en la barra de herramientas del gráfico, selecciona Más opciones de gráfico y, luego, elige una opción. Las opciones son las siguientes:

  • Descarga el gráfico en formato PNG o CSV
  • Guarda el gráfico en un panel personalizado
  • Abrir el Explorador de métricas
  • Expandir o contraer la leyenda del gráfico
  • Restablecer el zoom

API

Para obtener información sobre cómo leer las métricas de Cloud Function de manera programática, consulta Visualiza las métricas supervisadas.