Explora los resultados del monitor sintético

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

Antes de comenzar

A fin de obtener los permisos necesarios para ver los resultados de la ejecución de la supervisión sintética con la consola de Google Cloud, solicita a tu administrador que te otorgue el los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

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

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

  1. En la consola de Google Cloud, ve a la página  Synthetic monitoring:

    Ve 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, busca el monitor sintético que quieres ver y, luego, haz clic en su nombre.

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

Cada fila de la tabla muestra el estado, la fecha, la duración y un vínculo 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, en la página Detalles del monitor sintético, haz clic en el vínculo a la ejecución. En esta página, puedes hacer lo siguiente:

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

  • Ver el código actual

  • Accede a la función de Cloud Run.

  • En el caso de la prueba de 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 contiene cuatro entradas. Cada entrada de la lista se anota como aprobado o reprobado.

    Si seleccionas una entrada marcada como con errores, se mostrará y destacará 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 la función de Cloud Run. Por ejemplo, si usas Mocha, los registros incluyen información sobre si la prueba se aprobó o no, su duración y, en caso de error, un seguimiento de pila completo. El el seguimiento de pila incluye la línea de código que falló, los tipos de error y mensajes de error.

Para ver los detalles de tus registros relacionados, en el panel Registros de ejecución, haz lo siguiente: expandir una entrada de registro.

La entrada de registro se muestra en formato JSON. Si prefieres ver con el Explorador de registros y, luego, 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 tu función de Cloud Run que se ejecute. En la siguiente captura de pantalla, se muestra el tipo de datos que captura el seguimiento cuando utilizas la plantilla genérica:

Cloud Trace muestra los detalles de un seguimiento de una función de Cloud Run.

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 la de texto que se pasó al registrador de winston y muestra la Solicitud HTTP 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 usando el comando Explorador de Cloud Trace. El registro ya está expandido para mostrar los detalles. Cuando el seguimiento o el intervalo muestren un círculo, puedes hacer clic en él para mostrar la entrada de registro. La función de Cloud Run se puede identificar con la resource.labels.service_name.

Console

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

  • Para ver la información de resumen de un seguimiento, en la barra de herramientas de la página de detalles En el caso 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 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 en un círculo. Para obtener detalles sobre el evento o el registro, selecciona el círculo.

Para obtener más información sobre cómo explorar tus datos de seguimiento, consulta Busca y explora seguimientos.

API

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

Visualiza los registros y las métricas de una función de Cloud Run

Los registros y las métricas te proporcionan información sobre las acciones que La función de Cloud Run está funcionando. 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 Run Functions.

Ver registros de funciones

Console

Para ver los registros de las funciones de Cloud Run, haz lo siguiente:

  1. En el panel con el nombre de tu monitor sintético, haz clic en el nombre de la función de Cloud Run.
  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 funciones de Cloud Run de manera programática, consulta Escribe, visualiza y responde registros.

Cómo ver las métricas de la función

Para los supervisores sintéticos, las métricas se recopilan a través de Cloud Monitoring y Funciones de Cloud Run:

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

  • Las funciones de Cloud Run recopilan métricas sobre cada función de Cloud Run. Estos registran el tiempo de ejecución, el uso de memoria, recuentos y la cantidad de invocaciones por sección. El resto de en esta sección, se describe cómo ver esas métricas.

Console

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

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

Para acercar un período específico, haz lo siguiente:

  1. En un gráfico, coloca el cursor 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 de tiempo y, luego, soltar el botón del puntero.

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

  • Descarga el gráfico como 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
  • Restablece el zoom

API

Para obtener información sobre cómo leer la función de Cloud Run de forma programática, consulta Visualiza métricas supervisadas.