GSP092

Descripción general

En este lab, usarás Cloud Monitoring para visualizar detalles de Cloud Run Functions en la consola de Google Cloud. Los detalles incluyen los tiempos y recuentos de ejecución, y el uso de memoria.

Objetivos

Aprenderás a realizar las siguientes tareas:

• Crear una función de Cloud Run
• Crear una métrica basada en registros para una función de Cloud Run
• Usar el Explorador de métricas para ver los datos de tu función de Cloud Run
• Crear gráficos en la ventana Descripción general de Monitoring

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.

Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.

Para completar este lab, necesitarás lo siguiente:

• Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.

Nota: Usa una ventana del navegador privada o de incógnito (opción recomendada) para ejecutar el lab. Así evitarás conflictos entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.

• Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).

Nota: Usa solo la cuenta de estudiante para este lab. Si usas otra cuenta de Google Cloud, es posible que se apliquen cargos a esa cuenta.

Cómo iniciar tu lab y acceder a la consola de Google Cloud

1. Haz clic en el botón Comenzar lab. Si debes pagar por el lab, se abrirá un diálogo para que selecciones la forma de pago. A la izquierda, se encuentra el panel Detalles del lab, que tiene estos elementos:

   • El botón para abrir la consola de Google Cloud
   • El tiempo restante
   • Las credenciales temporales que debes usar para el lab
   • Otra información para completar el lab, si es necesaria

2. Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).

   El lab inicia recursos y abre otra pestaña en la que se muestra la página de acceso.

   Sugerencia: Ordena las pestañas en ventanas separadas, una junto a la otra.

   Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usar otra cuenta.

3. De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.

   {{{user_0.username | "Username"}}}

   También puedes encontrar el nombre de usuario en el panel Detalles del lab.

4. Haz clic en Siguiente.

5. Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.

   {{{user_0.password | "Password"}}}

   También puedes encontrar la contraseña en el panel Detalles del lab.

6. Haz clic en Siguiente.

   Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud. Nota: Usar tu propia cuenta de Google Cloud para este lab podría generar cargos adicionales.

7. Haz clic para avanzar por las páginas siguientes:

   • Acepta los Términos y Condiciones.
   • No agregues opciones de recuperación o autenticación de dos factores (esta es una cuenta temporal).
   • No te registres para obtener pruebas gratuitas.

Después de un momento, se abrirá la consola de Google Cloud en esta pestaña.

Nota: Para acceder a los productos y servicios de Google Cloud, haz clic en el menú de navegación o escribe el nombre del servicio o producto en el campo Buscar.

Activa Cloud Shell

Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.

1. Haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.

2. Haz clic para avanzar por las siguientes ventanas:

   • Continúa en la ventana de información de Cloud Shell.
   • Autoriza a Cloud Shell para que use tus credenciales para realizar llamadas a la API de Google Cloud.

Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu Project_ID, . El resultado contiene una línea que declara el Project_ID para esta sesión:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.

3. Puedes solicitar el nombre de la cuenta activa con este comando (opcional):

gcloud auth list

4. Haz clic en Autorizar.

Resultado:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. Puedes solicitar el ID del proyecto con este comando (opcional):

gcloud config list project

Resultado:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Nota: Para obtener toda la documentación de gcloud, en Google Cloud, consulta la guía con la descripción general de gcloud CLI.

Tarea 1. Visualiza los registros y las métricas de Cloud Run Functions en Cloud Monitoring

Para recopilar registros y alertas, necesitas tener algo que supervisar. En esta sección, crearás una función de Cloud Run Hello World para supervisarla.

1. En la consola de Cloud, selecciona el menú de navegación () > Cloud Run y, luego, haz clic en Escribir una función.

2. Establece lo siguiente:

   • Nombre del servicio: helloworld
   • Región:
   • Entorno de ejecución: Node.js 22
   • Autenticación: Selecciona el botón de selección junto a Permitir invocaciones no autenticadas

3. Expande Contenedores, volúmenes, Herramientas de redes y seguridad y establece lo siguiente:

   • Entorno de ejecución: Selecciona Segunda generación

   • En Escalamiento de revisión, establece el Número máximo de instancias en 5

4. Deja el resto de los campos con la configuración predeterminada. Haz clic en Crear

Nota: Es posible que aparezca una ventana emergente útil para validar que las APIs necesarias estén habilitadas en el proyecto. Haz clic en el botón Habilitar cuando se solicite.

5. Haz clic en Guardar y volver a implementar.

La función se implementará automáticamente y aparecerá en la página Cloud Run Function. Esto tardará algunos minutos. Cuando veas una marca de verificación verde junto al nombre, la función de Cloud Run estará lista.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si la completaste correctamente, se te otorgará una puntuación de evaluación.

Crear una función de Cloud Run

6. Para abrir una nueva ventana de Cloud Shell, haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.

7. En Cloud Shell, ejecuta lo siguiente para descargar una herramienta llamada vegeta, que te permitirá enviar tráfico de prueba a tu función de Cloud Run:

curl -LO 'https://github.com/tsenart/vegeta/releases/download/v12.12.0/vegeta_12.12.0_linux_386.tar.gz'

8. Descomprime la herramienta vegeta con el siguiente comando:

tar -xvzf vegeta_12.12.0_linux_386.tar.gz

9. En la página de Cloud Run, haz clic en el nombre de tu función y, luego, en la URL de helloworld.

Si ves Hello World! en la pestaña nueva que se abre en el navegador, significa que todo está listo.

10. Configura y verifica el vínculo de URL de Cloud Run:

CLOUD_RUN_URL=$(gcloud run services describe helloworld --region={{{ project_0.default_region }}} --format='value(status.url)') echo $CLOUD_RUN_URL

11. Ahora, envía tráfico a tu función de Cloud Run.

echo "GET $CLOUD_RUN_URL" | ./vegeta attack -duration=300s -rate=200 > results.bin

12. Mantén este proceso en segundo plano mientras completas las siguientes secciones.

Tarea 2. Crea una métrica basada en registros

Ahora, crearás una métrica basada en registros de tipo distribución para extraer el valor de latencia del campo httpRequest.latency de las entradas de registro.

1. En la consola, selecciona el menú de navegación > Ver todos los productos > Observabilidad > Registro > Explorador de registros. Cloud Logging se abrirá en la consola.

2. Para ver solo los registros de tu función de Cloud Run, selecciona Revisión de Cloud Run > helloWorld en el menú desplegable Todos los recursos y haz clic en Aplicar.

3. Haz clic en Ejecutar consulta.

4. En el menú desplegable Acciones, haz clic en Crear métrica.

5. Sigue estos pasos en el formulario Crear métrica basada en registros:

• Cambia el tipo de métrica a Distribución.
• En Nombre de la métrica basada en registros, ingresa CloudRunFunctionLatency-Logs.
• Ingresa httpRequest.latency en Nombre del campo.

La métrica basada en registros debería tener este aspecto:

6. Haz clic en Crear métrica.

Ahora, verás que se agregó tu métrica definida por el usuario a tu página Métricas basadas en registros.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si la completaste correctamente, se te otorgará una puntuación de evaluación.

Crear una métrica basada en registros

Tarea 3. Explorador de métricas

A continuación, usarás el Explorador de métricas para ver los datos de tu función de Cloud Run.

Crea un permiso de métricas de Monitoring

Configura un permiso de métricas de Monitoring que esté vinculado a tu proyecto de Google Cloud. Sigue estos pasos para crear una cuenta nueva que incluya una prueba gratuita de Monitoring.

• En la consola de Cloud, haz clic en el menú de navegación () > Ver todos los productos > Observabilidad > Monitoring.

Cuando se abra la página de Descripción general de Monitoring, tu proyecto de permisos de métricas estará listo.

1. En el menú de la izquierda, haz clic en Explorador de métricas.

2. Haz clic en el menú desplegable Seleccionar una métrica. Anula la selección del botón Activo.

3. Escribe CloudRunFunctionLatency-Logs en Filtrar por nombre de recurso o métrica y, luego, selecciona Revisión de Cloud Run > Métrica basada en registros > Logging/user/CloudRunFunctionLatency-Logs en las métricas sugeridas y haz clic en Aplicar.

Nota: Si no puedes ver la Revisión de Cloud Run en el menú desplegable, desmarca Activo. Es posible que, en un principio, las métricas basadas en registros aparezcan como "No activas" en el Explorador de métricas. Esto significa que la métrica aún no recibió suficientes datos para considerarse activa. Para que la métrica se active, puede que deban pasar varios minutos y que se deba generar tráfico suficiente.

Si tienes problemas, sigue estos pasos:

• Verifica que seleccionaste el recurso y la métrica correctos en Cloud Monitoring.
• Asegúrate de que no se hayan aplicado filtros en Cloud Monitoring.
• Verifica que el intervalo de tiempo esté configurado correctamente en Cloud Monitoring.
• Genera más tráfico con la herramienta vegeta (aumenta la duración o la tasa).
• Espera un período más largo, ya que es posible que haya demoras en el procesamiento de registros.

4. En la esquina superior derecha, usa el menú desplegable para cambiar el Tipo de widget a Gráfico de barras apiladas.

5. Explora otras opciones de gráficos y prueba una métrica distinta. Por ejemplo, haz clic en la métrica actual de Revisión de Cloud Run para abrir el menú desplegable, selecciona Revisión de Cloud Run > Recuento de solicitudes y cambia el tipo de widget a Gráfico de áreas apiladas.

6. Sigue explorando y experimentando. Por ejemplo, vuelve a la métrica Revisión de Cloud Run y cambia la agregación al percentil 95. Selecciona el tipo de widget Gráfico de líneas.

Tarea 4. Crea gráficos en la ventana Descripción general de Monitoring

Crear gráficos en la ventana Descripción general de Monitoring es una buena forma de hacer un seguimiento de las métricas que consideras importantes. En esta sección, configurarás los mismos gráficos que creaste en la anterior, con la excepción de que ahora se guardarán en la ventana Descripción general de Monitoring.

1. En el menú de la izquierda, haz clic en Paneles.

2. Haz clic en Crea un panel personalizado.

3. Haz clic en Agregar widget.

4. En Visualización, selecciona Barras apiladas.

5. En el menú desplegable Selecciona una métrica, elige la métrica predeterminada Revisión de Cloud Run > Recuento de solicitudes para abrir el menú desplegable y cambiar la métrica. Haz clic en Aplicar en la parte superior derecha.

6. Haz clic en Agregar widget. En Visualización, selecciona Mapa de calor.

7. Comienza a escribir Revisión de Cloud Run en el menú desplegable Selecciona una métrica y, luego, selecciona Revisión de Cloud Run > Métrica basada en registros > Logging/user/CloudRunFunctionLatency-Logs en las métricas sugeridas y haz clic en Aplicar.

Nota: Si no puedes ver la métrica CloudRunFunctionLatency-Logs en el menú desplegable, desmarca Activo.

8. Haz clic en Agregar widget. En Visualización, selecciona Líneas.

9. Comienza a escribir Revisión de Cloud Run en el menú desplegable Selecciona una métrica y, luego, selecciona Revisión de Cloud Run > Request_latency en las métricas sugeridas. Establece Agregación en Media y haz clic en Aplicar.

10. Haz clic en Agregar widget. En Visualización, selecciona Barras apiladas.

11. Comienza a escribir Revisión de Cloud Run en el menú desplegable Selecciona una métrica y, luego, selecciona Revisión de Cloud Run > Contenedor > Asignación de CPU del contenedor en las métricas sugeridas. Haz clic en Aplicar.

De forma predeterminada, se asignará a los gráficos el nombre de la métrica que estás usando, pero puedes cambiarles el nombre si lo deseas.

12. Haz clic en el nombre del panel en la parte superior, que debería comenzar con New Dashboard - , y cámbiale el nombre a Cloud Run Function Custom Dashboard.

Como referencia rápida, haz clic en Paneles en el lado izquierdo de la página de Monitoring para ver los gráficos.

Tarea 5. Pon a prueba tus conocimientos

A continuación, se presentan algunas preguntas de opción múltiple para reforzar tus conocimientos de los conceptos de este lab. Trata de responderlas lo mejor posible.

¡Felicitaciones!

¡Felicitaciones! En este lab, usaste el Explorador de métricas y creaste una función de Cloud Run, una métrica basada en registros y gráficos en la ventana Descripción general de Monitoring.

Capacitación y certificación de Google Cloud

Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.

Última actualización del manual: 5 de marzo de 2025

Prueba más reciente del lab: 5 de marzo de 2025

Copyright 2025 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.