Explora los resultados del monitor sintético

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

Antes de comenzar

A fin de obtener los permisos que necesitas para ver los resultados de la ejecución de la supervisión sintética 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 funciones personalizadas o, también, otras funciones predefinidas.

Visualiza 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 la consola de Google Cloud, ve a la página  Supervisión sintética:

    Ir a Supervisión sintética

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

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

En la página Detalles del monitor 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 representa un gráfico con la duración registrada de la ejecución y contiene una tabla en la que se 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.

Ver registros y seguimientos de una ejecución

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

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

  • Ver el código actual

  • Acceder a la Cloud Function.

  • En la prueba Mocha, consulta los resultados de cada prueba. Por ejemplo, si el monitor sintético contiene cuatro pruebas de Mocha, el panel Resultados de la prueba contendrá cuatro entradas. Cada entrada de la lista se anota como aprobado o reprobado.

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

Ver datos de registros

Cloud Monitoring recopila los registros automáticamente. Estos registros contienen información sobre los detalles de las pruebas y los errores. Los registros disponibles dependen de tu Cloud Function. Por ejemplo, si usas Mocha, los registros incluirán información sobre si la prueba se aprobó o falló, la duración de la prueba y, en el caso de fallas, un seguimiento de pila completa. El seguimiento de pila incluye la línea de código que falló, los tipos de error 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 configura una consulta previamente.

Visualiza datos de seguimiento

Los datos de seguimiento se recopilan automáticamente cuando se ejecuta tu 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 en el que se muestran los detalles del seguimiento de una Cloud Function.

En la captura de pantalla anterior, la primera fila del gráfico 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 muestran 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 los datos de seguimiento con el explorador de Cloud Trace. El registro ya está expandido para mostrar los detalles. Cuando el seguimiento o el intervalo muestren un círculo, podrás hacer clic en él para mostrar la entrada de registro. La función de Cloud Functions se puede identificar mediante la visualización del 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 View trace details.

    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 tus seguimientos en Cloud Trace:

    1. En la consola de Google Cloud, ve a la página Explorador de seguimiento:

      Ve al Explorador de seguimiento

      También puedes usar la barra de búsqueda para encontrar esta página.

    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 quieres 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, utiliza 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 tu 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 del 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, luego, selecciona Abrir en el Explorador de registros. En 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.

Ver métricas de funciones

En el caso de los monitores sintéticos, Cloud Monitoring y Cloud Functions recopilan las 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 Visualiza 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 del 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 hacer zoom en 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.
  2. Arrastra el puntero horizontalmente hasta el otro extremo del intervalo 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:

  • Descargar 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 métricas supervisadas.