Visão geral

Neste laboratório, você vai implantar e monitorar um aplicativo com as ferramentas do Google Cloud. Você vai usar o Cloud Logging, o Trace, o Profiler e os painéis, além de criar verificações de tempo de atividade e políticas de alertas.

Objetivos

Neste laboratório, você vai fazer o seguinte:

• Fazer o download de um app de amostra no GitHub
• Implantar um aplicativo no App Engine
• Analisar os registros do Cloud
• Visualizar as informações do Profiler
• Conhecer o Cloud Trace
• Monitorar recursos usando painéis
• Criar alertas e verificações de tempo de atividade

Instalação

Para cada laboratório, você recebe um novo projeto do Google Cloud e um conjunto de recursos por um determinado período sem custo financeiro.

1. Clique no botão Começar o laboratório. Se for preciso pagar, você verá um pop-up para selecionar a forma de pagamento. No painel Detalhes do laboratório à esquerda, você vai encontrar o seguinte:

   • O botão Abrir console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Nome de usuário"}}}

   Você também encontra o Nome de usuário no painel Detalhes do laboratório.

4. Clique em Seguinte.

5. Copie a Senha abaixo e cole na caixa de diálogo de boas-vindas.

   {{{user_0.password | "Senha"}}}

   Você também encontra a Senha no painel Detalhes do laboratório.

6. Clique em Seguinte.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar uma lista de produtos e serviços do Google Cloud, clique no Menu de navegação no canto superior esquerdo ou digite o nome do serviço ou produto no campo Pesquisar.

Tarefa 1: fazer o download de um app de exemplo no GitHub

Faça o download de um aplicativo de exemplo no GitHub e visualize esse aplicativo no Cloud Shell.

1. No console do Cloud, clique em Ativar o Cloud Shell ().

2. Se solicitado, clique em Continuar. Depois de se conectar ao Cloud Shell, você vai ver que sua conta já está autenticada e que o projeto está configurado com seu ID do projeto.

3. Execute o comando a seguir no Cloud Shell para confirmar se a conta está autenticada. Se for solicitado, clique em Autorizar.

gcloud auth list

Resposta ao comando:

Credentialed Accounts ACTIVE ACCOUNT * [my_account]@[my_domain.com] To set the active account, run: $ gcloud config set account `ACCOUNT` Observação: o gcloud é a ferramenta de linha de comando avançada e unificada do Google Cloud. Ele vem pré-instalado no Cloud Shell. Entre os recursos da ferramenta, o gcloud oferece o preenchimento com tabulação no shell. Para mais informações, consulte a visão geral da ferramenta de linha de comando gcloud.

4. Execute o seguinte comando para confirmar que você está usando o projeto correto para este laboratório:

gcloud config list project

Resposta ao comando

[core] project = [PROJECT_ID]

5. Se o projeto correto não estiver na lista, use o comando a seguir para configurá-lo:

gcloud config set project [PROJECT_ID]

Resposta ao comando:

Updated property [core/project].

6. Para criar uma pasta chamada gcp-logging, use este comando:

mkdir gcp-logging

7. Acesse a pasta que você criou:

cd gcp-logging

8. Clone um app Python Flask simples no GitHub:

git clone https://GitHub.com/GoogleCloudPlatform/training-data-analyst.git

9. Altere para a pasta deploying-apps-to-gcp:

cd training-data-analyst/courses/design-process/deploying-apps-to-gcp

10. No Cloud Shell, clique em Abrir editor ().

11. Expanda a pasta gcp-logging/training-data-analyst/courses/design-process/deploying-apps-to-gcp no painel de navegação e clique em main.py para abrir o arquivo.

12. Adicione esta instrução de importação na segunda linha:

import googlecloudprofiler Observação: o Profiler permite monitorar os recursos usados pelos seus aplicativos. Para mais informações, consulte a documentação do Google Cloud Profiler.

13. Para iniciar o Profiler, adicione este snippet de código depois da função main(), após a linha 11:

try: googlecloudprofiler.start(verbose=3) except (ValueError, NotImplementedError) as exc: print(exc)

O Profiler vai apresentar continuamente as métricas do aplicativo. O código será semelhante ao mostrado a seguir:

Observação: esse código apenas ativa o Profiler. Depois disso, o Profiler começa a apresentar as métricas do aplicativo ao Google Cloud.

14. Você também deve adicionar a biblioteca do Profiler ao arquivo requirements.txt. Abra o arquivo no editor de código e adicione o seguinte código:

google-cloud-profiler==3.0.6 protobuf==3.20.1

O arquivo deve ficar assim:

15. É preciso ativar o Profiler no projeto. No Cloud Shell, digite este comando:

gcloud services enable cloudprofiler.googleapis.com

16. Para testar o programa, digite o seguinte comando para criar um contêiner do Docker da imagem:

docker build -t test-python .

17. Para executar a imagem do Docker, digite o seguinte comando:

docker run --rm -p 8080:8080 test-python

18. Para ver o programa em execução, clique em Visualização na Web () na barra de ferramentas do Google Cloud Shell. Depois selecione Visualizar na porta 8080.

O programa será aberto em uma nova guia do navegador.

19. No Cloud Shell, pressione Ctrl+C para interromper a execução do programa.

Clique em Verificar meu progresso para conferir o objetivo. Ative o Profiler

Tarefa 2: implantar um aplicativo no App Engine e examinar os registros do Cloud

Agora você vai implantar o programa no App Engine e usar as ferramentas do Google Cloud para monitorá-lo.

1. Selecione a pasta gcp-logging/training-data-analyst/courses/design-process/deploying-apps-to-gcp no editor de código do Cloud Shell, no painel "Explorer".
2. Clique em Novo arquivo e dê ao item o nome de app.yaml.
3. Cole este comando no arquivo recém-criado:

runtime: python39

4. Salve as alterações.

5. É preciso criar um aplicativo do App Engine em um projeto. Isso é feito apenas uma vez com o comando gcloud app create e especificando a região em que o app será criado. No Cloud Shell, digite o seguinte comando:

   gcloud app create --region={{{project_0.startup_script.app_region | REGION }}}

6. Agora implante o app usando o seguinte comando:

gcloud app deploy --version=one --quiet Observação: a conclusão desse comando leva alguns minutos. Aguarde a conclusão antes de continuar.

7. Na barra de título do console do Google Cloud, digite App Engine no campo de pesquisa e clique em App Engine no resultado que aparecer.

8. Clique em App Engine > Painel. Um link para o aplicativo vai aparecer no canto superior direito do painel e deve ser parecido com o seguinte:

Observação: o URL de uma instância do App Engine tem o formato https://project-id/appspot.com por padrão.

9. Clique no link para testar o programa.

10. Atualize o navegador algumas vezes para fazer algumas solicitações.

11. Volte ao console e clique em App Engine > Versões.

12. Na coluna Diagnosticar da tabela, clique em Registros.

13. Os registros devem indicar que o criador de perfil foi iniciado e os perfis estão sendo gerados. Se você chegar a esse ponto muito rápido, aguarde um minuto e clique em Atualizar.

Clique em Verificar meu progresso para conferir o objetivo. Implantar um aplicativo no App Engine e examinar os registros do Cloud

Tarefa 3: ver as informações do Profiler

1. Na barra de título do console do Google Cloud, digite Profiler no campo de pesquisa e clique em Profiler no resultado que aparecer. A tela será semelhante a esta:

Observação: a barra cinza na parte de cima representa a quantidade total de Tempo de CPU usado pelo programa. As outras barras abaixo dessa mostram o Tempo de CPU usado pelas funções do programa em relação ao total. O gráfico não é muito útil no momento devido à ausência de tráfego. Então adicione um pouco de carga ao aplicativo.

2. No Menu de navegação, clique em Compute Engine.
3. Clique em Criar instância para gerar uma máquina virtual.
4. Selecione a região para

(já que ela é diferente da região do aplicativo do App Engine).

Aceite todos os outros padrões e clique em Criar.

Clique em Verificar meu progresso para conferir o objetivo. Criar uma instância

5. Quando a VM estiver pronta, clique em SSH para fazer login.

6. Se solicitado, permita que o SSH no navegador se conecte a VMs clicando em Autorizar.

7. Você vai gerar tráfego para o aplicativo do App Engine usando uma ferramenta de teste da Web chamada Apache Bench. Para instalar a ferramenta, use estes comandos:

sudo apt update sudo apt install apache2-utils -y

8. Substitua <your-project-id> pelo PROJECT_ID no painel de detalhes da conexão e digite o comando a seguir para gerar tráfego no aplicativo do App Engine:

ab -n 1000 -c 10 https://<your-project-id>.appspot.com/

O comando vai fazer mil solicitações ao aplicativo, 10 de cada vez.

Observação: é preciso alterar o URL de forma que ele direcione para seu aplicativo. O URL pode ser encontrado no painel do App Engine e na guia do navegador que você usou para o teste do app, se ela ainda estiver aberta. Adicione também uma barra (/) no final do URL.

9. Quando as solicitações forem concluídas, na barra de título do console do Google Cloud, digite Profiler no campo de pesquisa e clique em Profiler no resultado que aparecer.

Agora o gráfico está mais interessante. Cada barra representa uma função, e a largura das barras indica o tempo de CPU consumido pelas funções.

Com o Profiler, os desenvolvedores podem acompanhar as partes de um programa que consomem recursos demais.

Tarefa 4: conhecer o Cloud Trace

1. Cada solicitação feita ao aplicativo é adicionada à lista do Trace. Na barra de título do console do Google Cloud, digite Trace Explorer no campo de pesquisa e clique em Trace Explorer no resultado que aparecer.

É exibido um histórico das solicitações e das latências. Este histórico não é muito interessante porque o aplicativo está em execução há pouco tempo. O gráfico no canto superior esquerdo mostra as solicitações e o tempo de duração de cada uma. A tabela à direita mostra uma lista de solicitações. Quando você seleciona uma solicitação, mais detalhes são exibidos na parte inferior da tela.

2. Volte para a janela "SSH" em que você digitou o comando do Apache Bench.

3. Substitua <your-project-id> pelo PROJECT_ID no painel de detalhes da conexão e digite o seguinte comando ab:

ab -n 1000 -c 10 https://<your-project-id>.appspot.com/

Você também pode testar valores diferentes para os parâmetros -n e -c.

4. Repita esse procedimento algumas vezes e volte para a página "Explorador de traces".

Tarefa 5: monitorar recursos usando Painéis

1. No Menu de navegação, clique em Monitoring.

2. No painel à esquerda, clique em Painéis. O Cloud Monitoring analisa os recursos usados nos projetos e gera alguns painéis padrão. Neste exercício, você usou máquinas virtuais do App Engine e do Compute Engine. Dessa forma, será exibida uma tabela semelhante a esta:

3. Clique no painel do App Engine e selecione o nome do projeto no menu suspenso. Você verá informações úteis sobre o aplicativo do App Engine.

4. No painel à esquerda, clique em Painéis.

5. Clique no painel Instâncias de VM e selecione sua instância. Um painel da VM será exibido.

Observação: se as instâncias de VM não aparecerem imediatamente, aguarde um minuto e atualize o navegador.

6. Você também pode voltar para a página "Painéis" e clicar em Criar painel personalizado. Crie um painel personalizado.
7. Em New Dashboard Name, digite o nome do painel personalizado. Para continuar trabalhando com este painel personalizado, adicione os gráficos.

Tarefa 6: criar alertas e verificações de tempo de atividade

1. No painel à esquerda, clique em Verificações de tempo de atividade e em + Criar verificação de tempo de atividade na parte superior. Preencha o formulário da seguinte maneira:

Propriedade	Valor
Protocolo	HTTPS
Tipo de recurso	URL
Nome do host	<your-project-id>.appspot.com
Caminho	/
Verificar frequência	1 minuto

2. Clique em Continuar.
3. Em Alerta e notificação, clique na seta suspensa ao lado de Canais de notificação e selecione Gerenciar canais de notificação. A página Canais de notificação será aberta em uma nova guia.
4. Role para baixo até "E-mail" e clique em ADICIONAR NOVO.
5. Na caixa de diálogo Criar canal de e-mail, digite seu e-mail pessoal no campo Endereço de e-mail e um Nome de exibição.
6. Clique em Salvar.
7. Volte para a guia anterior. Clique mais uma vez em Canais de notificação e no ícone de atualização para ver o nome de exibição mencionado na etapa anterior.
8. Agora selecione o Nome de exibição e clique em OK.
9. Nomeie a política de alertas como Alerta da verificação de tempo de atividade.
10. Clique em Continuar.
11. Na seção Revisão, insira Verificação de tempo de atividade do App Engine em Título.
12. Clique em Testar e confirme se a verificação de tempo de atividade pode se conectar ao recurso. Se aparecer uma marca de seleção verde, isso indica que a conexão funcionou. Clique em Criar.

Clique em Verificar meu progresso para conferir o objetivo. Crie alertas e verificações de tempo de atividade

13. Volte para a guia aberta do App Engine para desativar o aplicativo e conferir se a verificação de tempo de atividade e a política de alertas funcionam.

14. Clique em Configurações.

15. Clique em Desativar aplicativo. Siga as instruções para desativar o aplicativo.

16. Volte para o Painel do Google App Engine e teste o URL. Ele não funcionará mais.

17. Volte para a guia que contém o Monitoring e clique em Verificações de tempo de atividade. A verificação falhará. Se você chegar aqui muito rápido, aguarde um minuto e clique em "Atualizar".

18. Clique em Alertas. Um incidente terá sido acionado.

19. Verifique seu e-mail. Você vai receber uma mensagem do Cloud Monitoring.

20. Volte para Configurações do App Engine e reative o aplicativo. Depois, volte para a página Verificações de tempo de atividade. A verificação funcionará agora. Caso contrário, aguarde um minuto e clique em "Atualizar".

21. Volte para a página Alertas. Seu incidente terá sido resolvido. Como antes, talvez seja preciso aguardar um minuto e clicar em "Atualizar".

22. Verifique seu e-mail agora. Você receberá uma segunda mensagem indicando que o alerta foi recuperado.

23. Para não receber mais e-mails após a exclusão do projeto, exclua a política de alertas e o canal de notificação. Na parte superior da página Alertas, clique em Editar canais de notificação.

24. Localize seu endereço de e-mail e clique no ícone de lixeira para excluí-lo.

25. Agora clique em Verificações de tempo de atividade e exclua a verificação do App Engine.

Parabéns!

Neste laboratório, você implantou e monitorou um aplicativo com as ferramentas do Google Cloud. Você usou o Cloud Logging, o Trace, o Profiler e os painéis, além de criar verificações de tempo de atividade e políticas de alertas.

Finalize o laboratório

Clique em Terminar o laboratório após a conclusão. O Google Cloud Ensina remove os recursos usados e limpa a conta por você.

Você vai poder avaliar sua experiência no laboratório. Basta selecionar o número de estrelas, digitar um comentário e clicar em Enviar.

O número de estrelas indica o seguinte:

• 1 estrela = muito insatisfeito
• 2 estrelas = insatisfeito
• 3 estrelas = neutro
• 4 estrelas = satisfeito
• 5 estrelas = muito satisfeito

Feche a caixa de diálogo se não quiser enviar feedback.

Para enviar seu feedback, fazer sugestões ou correções, use a guia Suporte.

Copyright 2020 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.