Guía de inicio rápido para Datalab

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

Para obtener una vista previa de los instructivos de Monitoring en Datalab, consulta dichos instructivos. No puedes interactuar con los instructivos, a menos que ejecutes Datalab.

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página de selección de proyectos de Cloud Console, selecciona o crea un proyecto de Cloud.

    Ir a la página Selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud. Obtén información sobre cómo confirmar que tienes habilitada la facturación para tu proyecto.

  4. Habilita las API de Compute Engine and Cloud Source Repositories.

    Habilita las API

  5. Instala e inicializa el SDK de Cloud.

Configura Datalab

Realiza los siguientes pasos desde una ventana de la terminal en tu máquina local:

  1. Obtén el comando gcloud más reciente:
    gcloud components update
    
  2. Instala el componente gcloud datalab:
    gcloud components install datalab
    
  3. Cuando tengas que configurar gcloud para que se conecte a tu ID del proyecto de Google Cloud, ejecuta el siguiente comando después de reemplazar [PROJECT_ID] con tu ID del proyecto de Google Cloud:

    gcloud config set project [PROJECT_ID]
    

    Para verificar la configuración, ejecuta el siguiente comando:

    gcloud config get-value project
    

  4. Para crear una instancia de Datalab, ejecuta el siguiente comando después de reemplazar [DATALAB-INSTANCE-NAME] con el nombre de tu instancia. Los nombres deben comenzar con una letra minúscula, seguidos de no más de 62 letras en minúscula, números o guiones; además, no deben terminar con un guion:

    datalab create [DATALAB-INSTANCE-NAME]
    

    • Si se te solicita, selecciona una zona de la lista.
    • Si se te solicita establecer una frase de contraseña SSH, ingresa una contraseña. Asegúrate de guardar esta frase de contraseña.
    • Después de unos minutos, aparece un mensaje similar al siguiente.

      Created [https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[DATALAB-INSTANCE-NAME]].
      Connecting to [DATALAB-INSTANCE-NAME].
      This will create an SSH tunnel and may prompt you to create an rsa key pair. To manage these keys, see https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys
      Waiting for Datalab to be reachable at http://localhost:8081/
      

      Si se te solicita, ingresa tu frase de contraseña:

      Enter passphrase for key '[...]/.ssh/google_compute_engine':
      

      Después de unos minutos, el comando de creación se completa correctamente y se muestra un mensaje similar al siguiente:

      The connection to Datalab is now open and will remain until this command is killed.
      You can connect to Datalab at http://localhost:8081/
      

  5. La conexión con tu instancia de Datalab permanece abierta mientras el comando datalab está activo. Si la ventana de comandos de la terminal se cierra o se interrumpe, la conexión finaliza. Para restablecer la conexión, ejecuta el siguiente comando:

    datalab connect [DATALAB-INSTANCE-NAME]
    

La interfaz de Datalab

Cuando ejecutas el comando datalab connect, se abre una ventana del navegador con la URL establecida en http://127.0.0.1:8081/. Esta página muestra la página principal de Datalab:

Interfaz de Datalab

En la carpeta docs/ de Datalab, hay varios notebooks de Datalab que puedes explorar, incluidos los notebooks para Cloud Monitoring.

Datalab y Cloud Monitoring

Monitoring usa los lugares de trabajo para organizar los recursos contenidos en uno o más proyectos de Google Cloud. Con un lugar de trabajo, puedes crear alertas y paneles y configurar grupos, entre otras acciones.

Para usar grupos con Datalab, debes crear un lugar de trabajo. Para crear un lugar de trabajo, ve a Monitoring:

Ir a Monitoring

Si tu proyecto de Google Cloud ya está asociado a un espacio de trabajo, se mostrará la página principal de Cloud Monitoring. De lo contrario, se creará un lugar de trabajo automáticamente. En general, este proceso no requiere interacción de tu parte, pero tarda unos minutos en completarse. En algunos casos, se muestra el cuadro de diálogo Agrega tu proyecto a un lugar de trabajo. En este caso, selecciona la opción para crear un nuevo lugar de trabajo. Para obtener más información, consulta Lugares de trabajo.

Instructivos de Monitoring

Datalab se instala con varios instructivos interactivos de Monitoring:

Comenzar
Muestra cómo importar la API del paquete de operaciones de Google Cloud de Python a Datalab y establecer tu ID del proyecto de Google Cloud predeterminado. Un código de muestra llama a la API y recupera los datos de tu proyecto de Monitoring.
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étricas. Para usar las métricas de grupo, debes tener un lugar de trabajo. Si tu lugar de trabajo no tiene grupos, cambia a otro lugar de trabajo que sí los tenga. Para conocer más detalles, consulta Lugares de trabajo.
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 documentos (docs), instructivos (tutorials) y Stackdriver Monitoring en la interfaz de 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. Edita la celda que contiene set_datalab_project_id('my-project-id') de la siguiente manera:

    • Si creaste un lugar de trabajo, reemplaza my-project-id con el nombre de tu lugar de trabajo. Debes tener un lugar de trabajo para usar las métricas del grupo.
    • Si no tienes un lugar de trabajo, reemplaza my-project-id con tu ID del proyecto de Google Cloud.
  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.

Limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

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

  2. Ingresa CTRL-C en la ventana donde se ejecuta Datalab y cierra la pestaña de Datalab en su navegador.

  3. Se aplican cargos desde el momento de la creación hasta el momento de la eliminación de la instancia de VM de Datalab (consulta Precios de Cloud Datalab). Además, los discos persistentes donde se almacenan los notebooks también se cobran. Después de la eliminación de la VM de Datalab, el disco persistente permanece hasta que lo borres.

    Para borrar la instancia de VM de Datalab y su disco persistente, ejecuta lo siguiente:

    datalab delete --delete-disk [DATALAB-INSTANCE-NAME]
    

  4. El comando datalab create crea recursos adicionales que se reutilizan en otras instancias de Datalab que usted crea. Si no esperas crear instancias adicionales de Datalab, puedes ejecutar los siguientes comandos para borrar los recursos adicionales que aparecen a continuación:

    • Borra la regla de firewall datalab-network-allow-ssh, que permite conexiones SSH a tus instancias de Datalab:
      gcloud compute firewall-rules delete datalab-network-allow-ssh
      
    • Borra la red de nube privada virtual (VPC) datalab-network a la que se conectan las instancias de Datalab de forma predeterminada:
      gcloud compute networks delete datalab-network
      
    • Borra el Cloud Source Repository datalab-notebooks, que está configurado para almacenar tus notebooks (consulta Trabaja con notebooks si deseas crear copias de seguridad antes de borrar el repositorio).
      gcloud source repos delete datalab-notebooks
      
  5. Si creaste alguna instancia de lugar de trabajo, proyecto o VM que no deseas conservar, quita dichas instancias.

Próximos pasos

Consulta el siguiente material de referencia de la API: