Consultar los resultados de los monitores sintéticos

En este documento se describe cómo consultar el historial de ejecución de tus monitores sintéticos, así como las métricas y los registros recogidos.

Esta función solo se admite en proyectos de Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

Antes de empezar

Completa los siguientes pasos en el Google Cloud proyecto que almacena tu monitor sintético:

Ver el historial de ejecuciones de un monitor sintético

Para consultar el historial de ejecuciones correctas y fallidas, ve a la página Detalles del monitor sintético del monitor sintético:

  1. En la Google Cloud consola, ve a la página  Monitorización sintética:

    Ve a Monitorización sintética.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. Para abrir la página Detalles del monitor sintético, busca el monitor sintético que quieras ver y 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 muestra un gráfico con la duración registrada de la ejecución y una tabla con una fila por cada ejecución.

En cada fila de la tabla se indica el estado, la fecha y la duración, y se incluye un enlace a una página que muestra el código actual y los registros relevantes para esa ejecución.

Ver registros y trazas de una ejecución

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

  • Ver datos de registro.
  • Ver datos de la traza.

  • Consulta el código actual.

  • Accede a la función de Cloud Run.

  • En la prueba 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 contendrá cuatro entradas. Cada entrada de la lista se anota como aprobada o no aprobada.

    Si seleccionas una entrada marcada como fallida, se mostrará y resaltará el código fallido.

Ver datos de registro

Cloud Monitoring recoge los registros automáticamente. Estos registros contienen información sobre la prueba y los detalles de los errores. 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 ha superado o no, la duración de la prueba y, en caso de fallo, un rastreo de pila completo. El rastreo de la pila incluye la línea de código que ha fallado, los tipos de error y los mensajes de error.

Para ver los detalles de los registros relacionados, en el panel Registros de ejecución, amplía 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 Explorador de registros. Se abre Explorador de registros y se preconfigura una consulta.

Ver datos de traza

Los datos de traza se recogen cuando se ejecuta tu función de Cloud Run. Para ver los datos de traza, usa la Google Cloud consola o la API Cloud Trace.

Consola

Para ver los datos de la traza, tienes estas opciones:

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

    Se abre el panel Detalles, que muestra un gráfico de Gantt con información sobre cada intervalo, que es un registro de una operación, en el rastreo. Para obtener información completa sobre el rastreo y sus intervalos, haga clic en Ver en Cloud Trace, que abre la página Explorador de rastreos.

  • Para ver tus trazas en Cloud Trace, sigue estos pasos:

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

      Ir a Explorador de trazas

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

    2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
    3. En el gráfico de mapa de calor o en la tabla, selecciona un rastro.

Tu traza y tus intervalos pueden incluir círculos en la línea de tiempo que representan entradas de registro o eventos que se han producido durante la ejecución. Haz clic en el círculo para ver información sobre la entrada de registro o el evento. Para identificar una función de Cloud Run en una entrada de registro, consulta el campo resource.labels.service_name.

Para obtener más información sobre cómo explorar los datos de seguimiento, consulta el artículo Buscar y explorar seguimientos.

API

Te recomendamos que uses la Google Cloud consola para ver los datos de la traza. Sin embargo, si quieres usar la API Cloud Trace, usa el método traces.list para enumerar las trazas disponibles y, a continuación, el método traces.get para obtener los detalles de una traza.

Ver registros y 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 el valor GoogleStackdriverMonitoring-UptimeChecks indican que tu servicio ha recibido una solicitud del servicio de comprobación del tiempo de actividad.

En el resto de esta sección se describe cómo ver los registros y las métricas que recogen las funciones de Cloud Run.

Ver registros de funciones

Consola

Para ver los registros de una función 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 de un gráfico con más detalle, despliega una entrada de registro y, a continuación, selecciona Abrir en Explorador de registros. En el Explorador de registros, puedes realizar acciones como refinar 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 funciones de Cloud Run de forma programática, consulta Escribir, ver y responder a registros.

Ver métricas de funciones

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

  • Cloud Monitoring recoge 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 éxitos. Para obtener información sobre cómo ver estas métricas, consulta Ver el historial de ejecuciones de un monitor sintético.

  • Cloud Run Functions recoge métricas sobre cada función de Cloud Run. Estas métricas registran el tiempo de ejecución, el uso de memoria, el número de instancias y el número de invocaciones por sección. En el resto de esta sección se describe cómo ver estas métricas.

Consola

Para ver las métricas de Cloud Run Functions, 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 ampliar un intervalo de tiempo específico, haz lo siguiente:

  1. En un gráfico, coloca el puntero en un extremo del periodo y, a continuación, haz clic con el botón izquierdo.
  2. Arrastra el puntero horizontalmente hasta el otro extremo del intervalo de tiempo y, a continuación, suelta el botón del puntero.

Para ver los datos que se muestran en un gráfico con más detalle, en la barra de herramientas del gráfico, seleccione Más opciones del gráfico y, a continuación, haga una selección. Las opciones son las siguientes:

  • Descargar el gráfico como PNG o CSV
  • Guardar el gráfico en un panel de control personalizado
  • Abrir el explorador de métricas
  • Mostrar u ocultar la leyenda del gráfico
  • Restablecer el zoom