Guia de início rápido

Neste guia de início rápido, você aprende a usar o Stackdriver Debugger para verificar o estado de um app Python simples executado no ambiente padrão do App Engine. Ele contém demonstrações de como capturar a pilha de chamadas e as variáveis locais usando instantâneos de depuração e como injetar a geração de registros no app em execução usando logpoints de depuração.

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 GCP.

   Observação: se você não pretende manter os recursos criados neste tutorial, crie um novo projeto em vez de selecionar um existente. Depois de terminar, é possível excluir o projeto, removendo todos os recursos associados ao projeto e ao tutorial.

   Acessar a página Gerenciar recursos

3. Verifique se o faturamento foi ativado para o projeto.

   Saiba como ativar o faturamento

4. Verifique se os seguintes softwares estão instalados em seu sistema local:
• Git
• Google Cloud SDK

Implantar no App Engine

Comece implantando um app Python 2.7 no ambiente padrão do App Engine.

1. Clone o projeto em um repositório local.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples
   

2. Acesse o diretório que contém a amostra do código.

   cd python-docs-samples/appengine/standard/hello_world
   

3. Inicialize o Google Cloud SDK com o código do projeto.

   gcloud config set project [your-project-id]
   

4. Implante o aplicativo.

   gcloud app deploy --version=v1
   

5. Envie uma solicitação ao app para testá-lo.

   gcloud app browse
   

A resposta deverá conter uma mensagem Hello World. Se você tiver alguma dificuldade nessas etapas, consulte o Guia de início rápido do ambiente padrão do App Engine para Python.

Ver origens implantadas

Depois de implantar o app Python, você pode ver as origens implantadas na página "Depuração" do Console do Google Cloud Platform.

1. Navegue até a página Depuração no Console do Google Cloud Platform.

2. Verifique se o projeto correto está selecionado.

3. Verifique se default - v1 (100%) está selecionado no menu da parte superior. Isso indica qual serviço/versão do app você vai depurar.

4. Verifique se Deployed Files está selecionado no menu à esquerda. Esse painel exibe o código-fonte do app Python que você acabou de implantar.

5. Selecione main.py na lista de arquivos implantados para ver o respectivo conteúdo.

Agora você está pronto para capturar instantâneos de depuração e injetar logpoints de depuração.

Capturar um instantâneo de depuração

Um instantâneo de depuração captura as variáveis locais e a pilha de chamadas em um local de linha específico no código-fonte. Selecione a guia "Instantâneo" no painel à direita para capturar instantâneos de depuração.

1. Clique no número referente à primeira linha dentro da função get na classe MainPage. Uma seta azul aparecerá, indicando que o local do instantâneo está definido. O painel de resultados à direita exibe "Aguardando o instantâneo ser acionado".

   

2. Selecione o painel "Histórico de instantâneos" na parte inferior da página para ver se o instantâneo foi definido com sucesso.

   

3. Envie uma solicitação ao app para acionar o instantâneo.

   gcloud app browse
   

4. O painel de resultados exibe a pilha de chamadas e os valores das variáveis locais no escopo para esse ponto do código e esse momento.

   

5. Adicione a expressão a seguir e defina outro instantâneo.

   self.request.environ['HTTP_USER_AGENT']
   

6. Envie uma nova solicitação para acionar os novos instantâneos.

   gcloud app browse
   

7. O painel de resultados agora também mostra o resultado da expressão. Neste caso, o valor é:

   Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6)
   AppleWebKit/537.36 (KHTML, like Gecko)
   Chrome/62.0.3202.94 Safari/537.36
   

Injetar um logpoint de depuração

Um logpoint de depuração permite que você injete a geração de relatórios no app em execução sem reiniciá-lo. Selecione a guia "Logpoint" no painel à direita para injetar logpoints de depuração.

1. Clique no número referente à primeira linha dentro da função get na classe MainPage.

2. Uma caixa de texto em linha é exibida. Para injetar um logpoint, preencha-a da seguinte maneira e pressione Enter:

   if (True) logpoint("Browser = {self.request.environ['HTTP_USER_AGENT']}")
   

   

3. Selecione o painel "Histórico de logpoints" na parte inferior da página para ver se o logpoint foi injetado com sucesso.

   

4. Envie uma solicitação ao app para acionar o logpoint.

   gcloud app browse
   

5. Selecione o painel "Registros" na parte inferior da página para ver os registros impressos pelo logpoint.

   

Fazer limpeza

Para evitar cobranças na sua conta do GCP pelo uso de recursos neste guia de início rápido, faça o seguinte:

1. Navegue até a página Projetos do Console do GCP.

2. Clique no ícone de lixeira () ao lado do projeto.

3. Digite o nome do seu projeto para confirmar o encerramento.

A seguir

• Saiba mais sobre como configurar o Debugger

• Saiba mais sobre como usar o Debugger