Guia de início rápido do Cloud Datalab

Neste guia de início rápido, você verá como configurar o Cloud Datalab para usá-lo com projetos do Monitoring. Os notebooks dinâmicos do Cloud Datalab permitem executar análises e visualizações ad hoc que vão além dos recursos atuais do Monitoring.

Para visualizar os tutoriais do Monitoring no Cloud Datalab, consulte este tópico. Você só poderá interagir com os tutoriais se estiver executando o Cloud Datalab.

Antes de começar

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

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

  2. Selecione ou crie um projeto do Google Cloud Platform.

    Acessar a página Gerenciar recursos

  3. Verifique se o faturamento foi ativado no projeto do Google Cloud Platform.

    Saiba como ativar o faturamento

  4. Ativar Compute Engine e Cloud Source Repositories APIs.

    Ativar as APIs

  5. Instale e inicialize o SDK do Cloud.

Configurar o Cloud Datalab

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

  1. Encontre o comando gcloud mais recente:
    gcloud components update
    
  2. Instale o componente gcloud datalab:
    gcloud components install datalab
    
  3. Para configurar o gcloud para se conectar ao seu ID do projeto do GCP, execute o seguinte comando depois de substituir [PROJECT_ID] pelo seu ID do projeto do GCP:

    gcloud config set project [PROJECT_ID]
    

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

    gcloud config get-value project
    

  4. Para criar uma instância do Cloud Datalab, execute o seguinte comando depois de substituir [DATALAB-INSTANCE-NAME] pelo nome da sua instância. Os nomes precisam começar com uma letra minúscula, seguida de, no máximo, 62 letras minúsculas, números ou hifens 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 sucesso 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 sua instância do Cloud Datalab permanece aberta enquanto o comando datalab está ativo. Se a janela de comando do terminal for fechada ou interrompida, a conexão será finalizada. Para restabelecer a conexão, execute o seguinte comando:

    datalab connect [DATALAB-INSTANCE-NAME]
    

Interface do Cloud Datalab

Para visualizar a interface do Cloud Datalab, navegue até o URL http://127.0.0.1:8081/ ou clique no botão a seguir. Na primeira vez que o Cloud Datalab é usado, você é solicitado a concordar com os termos de serviço.

Acesse o Cloud Datalab em execução

Interface do Cloud Datalab

Na pasta docs/ do Cloud Datalab, há vários blocos de notas de introdução ao Cloud Datalab que você pode explorar, incluindo blocos para o Stackdriver Monitoring.

Cloud Datalab e Stackdriver Monitoring

O Monitoring usa espaços de trabalho para organizar recursos contidos em um ou mais projetos do GCP. Com um espaço de trabalho, você pode, entre outras coisas, criar alertas e painéis e configurar grupos. É necessário criar um espaço de trabalho para usar grupos com o Cloud Datalab.

Recomendamos que você crie um espaço de trabalho para seus projetos do GCP. Os espaços de trabalho são gratuitos e fáceis de criar. Para detalhes, vá para Como conseguir um espaço de trabalho rapidamente.

Tutoriais do Monitoring

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

Primeiros passos
Mostra como importar a API Python Stackdriver para o Cloud Datalab e definir seu ID do projeto padrão do GCP. Há um código de amostra que chama a API e recupera os dados de monitoramento do seu 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 espaço de trabalho que tenha. Para detalhes sobre como criar um espaço de trabalho, vá para Como conseguir um espaço de trabalho rapidamente.
Dados temporizados
Mostra como transformar dados da série temporal de formas relevantes. 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, siga estas etapas:

  1. Clique em docs, tutoriais e Stackdriver Monitoring na interface do Cloud 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: edite 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 do seu espaço de trabalho. É 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 seu ID do projeto do GCP.
  4. Execute o código do tutorial. Na barra de menu na parte superior da interface, selecione Executar > Executar todas as células. 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.

Limpar

Para evitar cobranças na sua conta do GCP pelo uso de recursos neste guia de início rápido, siga estas etapas:

  1. Clique no ícone Executar sessões no canto superior direito da interface do Cloud Datalab e encerre os notebooks que não estiver usando. Se necessário, é possível reiniciá-los posteriormente. Feche as guias ou janelas do navegador associado.

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

  3. Haverá cobranças desde o momento da criação até a exclusão da instância da VM do Cloud Datalab (consulte Preços do Cloud Datalab). Também haverá cobranças pelo disco permanente no qual os blocos de notas são armazenados. O disco permanente permanece após a exclusão da VM do Cloud Datalab até você excluí-lo.

    Para excluir a instância da VM do Cloud Datalab e seu disco permanente, execute o seguinte:

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

  4. Existem recursos adicionais criados pelo comando datalab create que são reutilizados por outras instâncias do Cloud Datalab que você cria. Você pode executar os seguintes comandos para excluir os recursos adicionais listados abaixo, caso não espere criar instâncias adicionais do Cloud Datalab:

    • Exclua a regra de firewall datalab-network-allow-ssh, o que permite que o SSH se conecte às instâncias do Cloud Datalab:
      gcloud compute firewall-rules delete datalab-network-allow-ssh
      
    • Exclua a rede datalab-network da Nuvem Privada Virtual (VPC), à qual as instâncias do Datalab estão conectadas por padrão:
      gcloud compute networks delete datalab-network
      
    • Exclua o datalab-notebooks do Cloud Source Repository, que é configurado para você armazenar seus blocos de notas (consulte Como trabalhar com blocos de notas se quiser fazer backup dos blocos de notas antes de excluir o repositório):
      gcloud source repos delete datalab-notebooks
      
  5. Se você criou espaços de trabalho, projetos ou instâncias da VM que não quer manter, remova-os.

A seguir

Consulte o seguinte material de referência da API:

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Monitoring
Precisa de ajuda? Acesse nossa página de suporte.