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

Para 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:

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 Synthetic monitor details 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 deseas ver y, luego, 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 y 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 el vínculo a una página que muestra el código actual y los registros relevantes para esa ejecución.

Visualiza los registros y seguimientos de una ejecución

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

  • Ver datos de registro.
  • Ver datos de seguimiento.

  • Consulta 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 tu 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 aprobada o no aprobada.

    Si seleccionas una entrada marcada como fallida, 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 la prueba y los detalles de la falla. Los registros disponibles dependen de tu 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 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, expande una entrada de registro en el panel Registros de ejecución.

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 tu función de Cloud Run. 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 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 el texto que se pasó al registrador winston y la solicitud HTTP saliente que emitió la llamada get de axios.

En el menú flotante de seguimiento, si haces clic en Ver en seguimiento, puedes ver tus datos de seguimiento con el explorador de Cloud Trace. El seguimiento 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. Para identificar la función de Cloud Run, consulta el campo resource.labels.service_name.

Console

Para ver tus datos de seguimiento, haz lo siguiente:

  • Para ver la información de resumen 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.

  • Consulta 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 gráfico 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.

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 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.

Cómo ver 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 realiza tu función de Cloud Run. 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 recopilan las funciones de Cloud Run.

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 registros de la función de Cloud Run de forma programática, consulta Escribe, visualiza y responde registros.

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

En el caso de los monitores sintéticos, las métricas se recopilan tanto en Cloud Monitoring como en las funciones de Cloud Run:

  • Cloud Monitoring recopila métricas sobre cada ejecución de un monitor sintético. Estas métricas incluyen la latencia de la ejecución de código y 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. 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 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 de forma horizontal hasta el otro extremo del intervalo de tiempo y, luego, suelta 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, realiza una selección. Las opciones incluyen las siguientes:

  • Descarga el gráfico como PNG o CSV
  • Guarda el gráfico en un panel personalizado
  • Abre 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 las métricas de las funciones de Cloud Run de forma programática, consulta Cómo ver las métricas supervisadas.