Guia de início rápido do Datalab

Este guia de início rápido mostra como configurar o Datalab para usar com projetos do Cloud Monitoring. Com os notebooks dinâmicos do Datalab, você realiza análises e visualizações ad hoc que vão além dos recursos atuais do Monitoring.

Para visualizar os tutoriais do Monitoring no Datalab, consulte esta página (em inglês). Só será possível interagir com os tutoriais se você estiver executando o Datalab.

Antes de começar

  1. Faça login na sua conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. No Console do Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

    Acessar a página do seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

  4. Ative as APIs Compute Engine and Cloud Source Repositories.

    Ative as APIs

  5. Instale e inicialize o SDK do Cloud..

Configurar o Datalab

Execute as etapas a seguir em uma janela de terminal na sua máquina local:

  1. Consiga o comando gcloud mais recente:
    gcloud components update
    
  2. Instale o componente gcloud datalab:
    gcloud components install datalab
    
  3. Para configurar a gcloud para se conectar ao seu ID do projeto do Google Cloud, execute o comando a seguir substituindo [PROJECT_ID] por esse ID:

    gcloud config set project [PROJECT_ID]
    

    Para verificar a configuração, execute o comando a seguir:

    gcloud config get-value project
    

  4. Para criar uma instância do Datalab, execute o comando a seguir substituindo [DATALAB-INSTANCE-NAME] pelo nome da instância: Os nomes precisam começar com uma letra minúscula seguida de, no máximo, 62 letras minúsculas, hifens ou números e não podem terminar com um hífen:

    datalab create [DATALAB-INSTANCE-NAME]
    

    • Se solicitado, selecione uma zona na lista.
    • Se for solicitado que você defina uma senha longa SSH, digite uma frase. Salve esta senha.
    • Depois de alguns minutos, uma mensagem semelhante a esta é exibida.

      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/
      

      Se solicitado, digite sua senha:

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

      Após alguns minutos, o comando de criação é concluído com êxito, e uma mensagem semelhante a esta é exibida:

      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. A conexão com a instância do Datalab permanecerá aberta enquanto o comando datalab estiver ativo. Se a janela de comando do terminal for fechada ou interrompida, a conexão será encerrada. Para restabelecer a conexão, execute o comando a seguir:

    datalab connect [DATALAB-INSTANCE-NAME]
    

A interface do Datalab

Quando você executa o comando datalab connect, uma janela do navegador é aberta com o URL definido como http://127.0.0.1:8081/. A página inicial do Datalab é exibida:

Interface do Datalab

Na pasta docs/ do Datalab, há vários notebooks de primeiros passos do Datalab que você pode explorar, incluindo para o Cloud Monitoring.

Datalab e Cloud Monitoring

O Monitoring usa espaços de trabalho para organizar recursos incluídos em um ou mais projetos do Google Cloud. Com um espaço de trabalho, é possível criar alertas e painéis, configurar grupos e muito mais.

É necessário criar um espaço de trabalho para usar grupos com o Datalab. Para criar um espaço de trabalho, acesse o Monitoring:

Acessar o Monitoring

Se o projeto do Google Cloud já estiver associado a um espaço de trabalho, a página inicial do Cloud Monitoring será exibida. Caso contrário, um espaço de trabalho será criado automaticamente. Em geral, esse processo não requer nenhuma ação sua, mas ele leva algum tempo para ser concluído. Em algumas situações, a caixa de diálogo Add your project to a Workspace é exibida. Nesse caso, selecione a opção para criar um novo espaço de trabalho. Para mais detalhes, consulte Espaços de trabalho.

Tutoriais do Monitoring

O Datalab é instalado com vários tutoriais interativos do Monitoring:

Primeiros passos
Mostra como importar a API do pacote de operações do Python para Google Cloud no Datalab e definir seu código de projeto padrão do Google Cloud. Há um código de amostra que chama a API e recupera os dados de monitoramento do projeto.
Métricas de grupo
Mostra como examinar a estrutura de grupo em um projeto e como usar grupos para filtrar e agregar dados de métricas. Para usar métricas de grupo, é necessário ter um espaço de trabalho. Se seu espaço de trabalho não tiver grupos, mude para outro que tenha. Para mais detalhes, consulte Espaços de trabalho.
Dados temporizados
Mostra como transformar dados de série temporal de maneiras inovadoras. Como o projeto pode não ter instâncias de VM suficientes para ser um bom exemplo, o tutorial é configurado para, opcionalmente, usar dados extraídos anteriormente de um projeto de demonstração.

É possível executar os tutoriais e, opcionalmente, modificá-los, conforme explicado na seção a seguir.

Executar os tutoriais

Para executar os tutoriais, faça o seguinte:

  1. Clique em docs, tutorials e Stackdriver Monitoring na interface do Datalab. Você verá a página a seguir:

    Tutoriais do Stackdriver

  2. Selecione o tutorial. Clique no nome do tutorial a ser executado.

  3. Defina o ID do projeto editando a célula que contém set_datalab_project_id('my-project-id') da seguinte maneira:

    • Se você criou um espaço de trabalho, substitua my-project-id pelo nome dele. É necessário ter um espaço de trabalho para usar métricas de grupo.
    • Se você não tiver um espaço de trabalho, substitua my-project-id pelo ID do projeto do Google Cloud.
  4. Execute o código do tutorial. Na barra de menus na parte superior da interface, selecione Run > Run all cells. Isso executará novamente todo o código no tutorial usando o código do projeto atual.

Sinta-se à vontade para modificar o código nos tutoriais e testar as alterações. Para executar o código em uma única célula, clique nele e escolha Executar no menu à esquerda da célula. Você também pode criar seus próprios notebooks.

Fazer a limpeza

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

  1. Clique no ícone Running Sessions no canto superior direito da interface do Datalab e encerre os notebooks que você não está usando. Se necessário, é possível reiniciá-los depois. Feche as guias ou janelas do navegador associado.

  2. Insira CTRL-C na janela em que o Datalab está sendo executado e feche a guia do Datalab no seu navegador.

  3. Haverá cobranças desde o momento da criação até a exclusão da instância de VM do Datalab. Consulte Preços do Cloud Datalab. Também haverá cobranças pelo disco permanente em que os notebooks são armazenados. O disco permanente é mantido após a exclusão da VM do Datalab até você excluí-lo.

    Para excluir a instância de VM do Datalab e o disco permanente dela, execute o comando a seguir:

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

  4. Há mais recursos criados pelo comando datalab create que são reutilizados por outras instâncias do Datalab geradas por você. Execute os comandos a seguir para excluir os recursos extras listados abaixo se não quiser criar mais instâncias do Datalab:

    • Exclua a regra de firewall datalab-network-allow-ssh, que permite conexões SSH com as instâncias do Datalab:
      gcloud compute firewall-rules delete datalab-network-allow-ssh
      
    • Exclua a rede datalab-network da nuvem privada virtual (VPC, na sigla em inglês), que está conectada às instâncias do Datalab por padrão:
      gcloud compute networks delete datalab-network
      
    • Exclua o datalab-notebooks do repositório de origem do Google Cloud que está configurado para armazenar os notebooks. Consulte Como trabalhar com notebooks se quiser fazer o backup dos notebooks antes de excluir o repositório:
      gcloud source repos delete datalab-notebooks
      
  5. Se você criou espaços de trabalho, projetos ou instâncias de VM que não quer manter, remova-os.

A seguir

Consulte o material de referência da API a seguir: