Informações gerais

Neste laboratório, você vai aprender a usar o Cloud Trace ao enviar uma solicitação HTTP ao aplicativo de exemplo.

Objetivos

Ao aprender a usar o Trace, você vai:

• Implantar um aplicativo de amostra em um cluster do Google Kubernetes Engine (GKE).
• Criar um trace enviando uma solicitação HTTP para o aplicativo de amostra.
• Usar a interface do Trace para conferir as informações de latência do trace que você criou.

Configuração e requisitos

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. Baixar e implantar o aplicativo

Nesta tarefa, você vai baixar um aplicativo de amostra do GitHub, ativar a API Google Kubernetes Engine, criar um cluster do GKE, atualizar as credenciais do cluster, verificar o acesso e implantar os três serviços do aplicativo.

Para baixar e implantar o aplicativo de amostra, faça o seguinte:

1. Para abrir o Cloud Shell, clique em "Ativar o Cloud Shell" na barra de ferramentas do console do Google Cloud. Se for solicitado, clique em Continuar.

Após alguns instantes, uma sessão do Cloud Shell é aberta no console do Google Cloud.

2. Para fazer o download do código-fonte do GitHub, execute o seguinte comando:

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

3. Use o comando a seguir para ativar a API Google Kubernetes Engine. Se for solicitado, clique em Autorizar.

gcloud services enable container.googleapis.com

4. Para criar o cluster do GKE chamado cloud-trace-demo na região , execute os comandos a seguir no Cloud Shell:

ZONE={{{project_0.default_zone|place_holder_text}}} gcloud container clusters create cloud-trace-demo \ --zone $ZONE

Esse comando leva alguns minutos para ser concluído. Após a conclusão, seu projeto do Google Cloud vai conter o cluster do GKE citado na tarefa. Você precisa ter permissão para criar clusters com acesso externo no projeto do Google Cloud.

5. Atualize suas credenciais do cluster do GKE executando o seguinte comando:

gcloud container clusters get-credentials cloud-trace-demo --zone $ZONE

6. Execute o comando a seguir para confirmar o acesso ao cluster:

kubectl get nodes

Um exemplo de saída desse comando é:

NAME STATUS ROLES AGE VERSION gke-cloud-trace-demo-default-pool-063c0416-113s Ready 78s v1.22.12-gke.2300 gke-cloud-trace-demo-default-pool-063c0416-1n27 Ready 79s v1.22.12-gke.2300 gke-cloud-trace-demo-default-pool-063c0416-frkd Ready 78s v1.22.12-gke.2300

7. Implante o aplicativo de exemplo executando o seguinte comando:

cd python-docs-samples/trace/cloud-trace-demo-app-opentelemetry && ./setup.sh

O script setup.sh configura três serviços do aplicativo usando uma imagem pré-criada. As cargas de trabalho são chamadas de cloud-trace-demo-a, cloud-trace-demo-b e cloud-trace-demo-c. O script de configuração espera até que todos os recursos sejam provisionados. Por conta disso, a configuração pode levar alguns minutos para ser concluída.

Um exemplo de saída desse comando é:

deployment.apps/cloud-trace-demo-a is created service/cloud-trace-demo-a is created deployment.apps/cloud-trace-demo-b is created service/cloud-trace-demo-b is created deployment.apps/cloud-trace-demo-c is created service/cloud-trace-demo-c is created

Selecione Verificar meu progresso para conferir o objetivo. Criar um cluster e implantar o aplicativo de exemplo

Tarefa 2. Criar um trace

Nesta tarefa, você vai gerar traces enviando solicitações curl para cloud-trace-demo-a e conferir dados sobre eles no Trace.

1. Use o comando a seguir para criar um trace enviando uma solicitação curl ao cluster cloud-trace-demo-a:

curl $(kubectl get svc -o=jsonpath='{.items[?(@.metadata.name=="cloud-trace-demo-a")].status.loadBalancer.ingress[0].ip}')

É possível executar o comando curl várias vezes para gerar vários traces.

A saída será assim:

Hello, I am service A And I am service B Hello, I am service C

Selecione Verificar meu progresso para conferir o objetivo. Criar um trace de nuvem

Visualizar os dados do trace

1. No console do Google Cloud, no menu de navegação (), clique em Mostrar todos os produtos > Observabilidade > Trace.

O Trace mostra traces distribuídos para análise. Você verá um mapa de calor da duração dos períodos ao longo do tempo, além de uma tabela com os períodos individuais que pode ser filtrada por nome do serviço, nome do período, status, duração e tipo. A interface permite que os usuários investiguem problemas de desempenho e entendam o fluxo de solicitações em um sistema distribuído.

A visualização de gráfico mostra a duração dos períodos ao longo do tempo em um mapa de calor. Cada bloco colorido representa um período, e a intensidade da cor indica a duração dele. Assim, você identifica rapidamente períodos lentos ou tendências na latência.

2. Na visualização de gráfico, clique em um dos blocos mais escuros.

3. Na tabela Períodos, clique em qualquer ID do período. Um detalhamento do trace selecionado é exibido. Cada barra horizontal representa a duração de cada período no trace. O comprimento da barra corresponde à duração do período.

Esta seção do trace mostra uma visão detalhada da jornada de uma única solicitação pelo sistema, dividindo-a em operações individuais (períodos) e mostrando o tempo e as relações delas. Ela ajuda a identificar gargalos de desempenho e entender a sequência de eventos.

4. Para conferir os detalhes sobre um período, clique em uma das barras.

Mais informações sobre cada período estão disponíveis no painel de detalhes.

Parabéns!

Neste laboratório, você executou as seguintes tarefas:

• Implantou um aplicativo de exemplo em um cluster do Google Kubernetes Engine (GKE).
• Criou um trace enviando uma solicitação HTTP para o aplicativo de amostra.
• Usou a interface do Trace para conferir as informações de latência do trace criado.

Bom trabalho!

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.