Guía de inicio rápido: Usa Cloud Datalab con Stackdriver

Esta guía de inicio rápido te muestra cómo configurar Cloud Datalab para usarlo con tus proyectos de Monitoring. Las notebooks dinámicas de Cloud Datalab te permiten realizar análisis y visualizaciones ad hoc que van más allá de las características actuales de Monitoring.

Para obtener una vista previa de los instructivos de Monitoring en Cloud Datalab, consulta los instructivos de Monitoring. No puedes interactuar con los instructivos, a menos que estés ejecutando Cloud Datalab.

Antes de comenzar

Para esta guía de inicio rápido, necesitas lo siguiente:

  • Acceso a un lugar de trabajo que supervisa una o más instancias de VM. La cuenta se usa como algo para observar en Cloud Datalab; pero no se modifica. Si no tienes acceso a este tipo de cuenta, puedes crear una con la Guía de inicio rápido para Compute Engine o la Guía de inicio rápido para Amazon EC2.

  • Una instancia de Cloud Datalab que se ejecute localmente:

    • Cloud Datalab debe ser accesible como http://127.0.0.1:8081/.

    • Cloud Datalab debe tener los instructivos de Monitoring en datalab > docs > tutorials > Stackdriver Monitoring.

    Si no tienes una instancia de Cloud Datalab en ejecución, puedes instalar una localmente con las instrucciones de esta guía de inicio rápido.

Configura Cloud Datalab

Si tienes una instancia de Cloud Datalab en ejecución, como se describe en Antes de comenzar, pasa a la sección La interfaz de Cloud Datalab. De lo contrario, sigue las siguientes instrucciones tomadas de Ejecuta Cloud Datalab localmente, de la Guía de inicio rápido de Cloud Datalab. Para completar la instalación, se debe instalar Docker y, a continuación, cargar el contenedor de Cloud Datalab Docker.

Instala Docker

Si tienes Docker instalado en tu estación de trabajo local, puedes pasar a la sección Ejecuta Cloud Datalab. De lo contrario, sigue las instrucciones a continuación, tomadas de la sección Instala Docker Engine.

Ubuntu y Debian

Ejecuta los comandos siguientes en tu estación de trabajo:

sudo apt-get update
sudo apt-get install docker-engine
sudo service docker start

Para verificar la instalación, carga una imagen de prueba del contenedor con el comando siguiente:

sudo docker run hello-world

Red Hat y CentOS

Ejecuta los comandos siguientes en tu estación de trabajo:

sudo yum install docker-engine
sudo systemctl enable docker.service
sudo systemctl start docker

Para verificar la instalación, carga una imagen de prueba del contenedor con el comando siguiente:

sudo docker run hello-world

Mac OS

Si deseas realizar la instalación en MacOS, consulta Comienza a usar Docker para Mac.

Ejecuta Cloud Datalab

Para obtener instrucciones detalladas, consulta Ejecuta Cloud Datalab localmente. De lo contrario, el siguiente comando inicia Cloud Datalab en un contenedor de Docker en Linux o MacOS. Ejecuta el comando en una ventana de terminal separada, ya que el contenedor permanecerá ejecutándose en la terminal y esto te impedirá realizar otros trabajos allí:

sudo docker run -it -p "127.0.0.1:8081:8080" -v "${HOME}:/content"  \
    -e "PROJECT_ID=[YOUR_PROJECT_ID]"  gcr.io/cloud-datalab/datalab:local

Cuando uses Monitoring, [YOUR_PROJECT_ID] se debe configurar en el lugar de trabajo a cuyos recursos accederás. De manera opcional, puedes configurar o cambiar este ID desde Cloud Datalab.

La interfaz de Cloud Datalab

Para ver la interfaz de Cloud Datalab, navega hasta la URL http://127.0.0.1:8081/ o haz clic en el siguiente botón. Si esta es la primera vez que usas Cloud Datalab, se te solicitará que aceptes las Condiciones del Servicio.

Ir a tu Cloud Datalab en ejecución

Interfaz de Cloud Datalab

En la carpeta docs/ de Cloud Datalab, encontrarás varias notebooks para comenzar a usar Datalab que puedes explorar. Para ir directamente a Stackdriver Monitoring en Cloud Datalab, continúa leyendo este documento.

Cómo acceder a Cloud Datalab

Para usar los servicios de Google Cloud Platform como Stackdriver Monitoring desde Cloud Datalab, debes acceder para otorgarle permiso como se indica a continuación:

  1. En la interfaz de Cloud Datalab, haz clic en el ícono Cuenta ubicado en la parte superior derecha y selecciona Acceso.

  2. Acepta los permisos de GCP necesarios.

Stackdriver Monitoring

Cloud Datalab se instala con varios instructivos interactivos de Monitoring:

Cómo comenzar
Muestra cómo importar la API de Stackdriver de Python en Cloud Datalab y configurar tu ID del proyecto de lugar de trabajo predeterminado. Hay código de muestra que llama a la API y recupera los datos de supervisión de tu proyecto.
Métricas de grupo
Muestra cómo se debe ver la estructura de un grupo en un proyecto y cómo usar los grupos para filtrar y agregar datos de métrica. Si tu lugar de trabajo no tiene grupos, cambia a otro lugar de trabajo que los tenga.
Datos desplazados en el tiempo
Muestra cómo transformar los datos de las series temporales de formas interesantes. Dado que tu proyecto podría no tener instancias de VM suficientes para ser un buen ejemplo, el instructivo está configurado a fin de usar, de manera opcional, datos extraídos previamente de un proyecto de demostración.

Puedes ejecutar los instructivos y, de manera opcional, modificarlos como se explica en la sección siguiente.

Cómo ejecutar los instructivos

Para ejecutar los instructivos, haz lo siguiente:

  1. Haz clic en docs, tutorials y Stackdriver Monitoring en la interfaz de Cloud Datalab. Deberías ver la siguiente página:

    Instructivos de Stackdriver

  2. Selecciona el instructivo. Haz clic en el nombre del instructivo que deseas ejecutar.

  3. Configura el ID del proyecto. Cuando uses Monitoring con Cloud Datalab, el "ID del proyecto" siempre debería ser el ID de un lugar de trabajo. Si no configuraste tu ID del proyecto cuando ejecutaste el contenedor de Cloud Datalab Docker, o si quieres cambiar el ID del proyecto, quita el comentario y edita la línea set_datalab_project_id cerca del principio del instructivo. Por ejemplo, si tu lugar de trabajo se llama wonderful-project, la línea editada debería verse como se indica a continuación:

    set_datalab_project_id('wonderful-project')
    
  4. Ejecuta el código del instructivo. En la barra de menús ubicada en la parte superior de la interfaz, selecciona Ejecutar > Ejecutar todas las celdas. Esta acción ejecuta nuevamente todo el código del instructivo con tu ID del proyecto actual.

Si quieres, puedes modificar el código de los instructivos y probar tus cambios. Para ejecutar el código en una sola celda, haz clic en la celda y selecciona Ejecutar en el menú ubicado en la izquierda de la celda. También puedes crear tus propias notebooks.

Cómo realizar una limpieza

Para evitar que se apliquen cargos a tu cuenta de GCP por los recursos usados en esta guía de inicio rápido, haz lo siguiente:

  1. Haz clic en el ícono Sesiones en ejecución ubicado en la esquina superior derecha de la interfaz de Cloud Datalab, y cierra las notebooks que no estés usando. Puedes reiniciarlas más tarde si las necesitas. Cierra las pestañas o ventanas del navegador asociado.

  2. Si no deseas dejar el contenedor de Cloud Datalab en ejecución, escribe CTRL-C en la ventana de la terminal en la que iniciaste Cloud Datalab.

  3. Si instalaste Docker solo para esta guía de inicio rápido y no deseas conservarlo, detente y desinstálalo.

  4. Si creaste lugares de trabajo, proyectos o instancias de VM que no deseas conservar, quítalos.

¿Qué sigue?

Consulta el siguiente material de referencia de API:

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Stackdriver Monitoring
¿Necesitas ayuda? Visita nuestra página de asistencia.