Visão geral

O Service Monitoring do Google Cloud simplifica a criação de objetivos de nível de serviço (SLOs, na sigla em inglês) de microsserviços com base na disponibilidade, na latência ou em indicadores de nível de serviço (SLIs, na sigla em inglês) personalizados. Neste laboratório, você usará o Service Monitoring para criar um SLO de disponibilidade de 99,5% e o alerta correspondente.

Objetivos

Neste laboratório, você aprenderá a fazer o seguinte:

• Implantar um aplicativo de teste.
• Usar o Service Monitoring para criar um SLO.
• Vincular um alerta ao SLO.

Configuração e requisitos

Acessar o laboratório

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.

Ative o Google Cloud Shell

O Google Cloud Shell é uma máquina virtual com ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud.

O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. No console do Cloud, clique no botão "Abrir o Cloud Shell" na barra de ferramentas superior direita.

   

2. Clique em Continuar.

O provisionamento e a conexão do ambiente podem demorar um pouco. Quando você estiver conectado, já estará autenticado, e o projeto estará definido com seu PROJECT_ID. Exemplo:

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

• Para listar o nome da conta ativa, use este comando:

Saída:

Exemplo de saída:

• Para listar o ID do projeto, use este comando:

Saída:

Exemplo de saída:

Tarefa 1: implantar um aplicativo de teste

Nesta tarefa, você implantará um aplicativo de teste no App Engine.

Implantar um aplicativo de teste no App Engine

Implante um aplicativo Node.js básico no ambiente padrão do App Engine para que o Service Monitoring possa se conectar a ele.

1. No terminal do Cloud Shell, clone o repo https://github.com/haggman/HelloLoggingNodeJS.git:

Esse repositório contém um aplicativo da Web Node.js básico que é usado para testes. Esse aplicativo é o mesmo que você viu no módulo da aula, quando analisou algumas partes dele.

2. Vá para a pasta HelloLoggingNodeJS e abra index.js no editor de código do Cloud Shell:

3. Reserve alguns minutos para ler atentamente o código.

4. No editor de código do Cloud Shell, consulte o arquivo app.yaml. Atualize a versão do nodejs do ambiente de execução.

O ambiente padrão do App Engine usa esse arquivo para definir o ambiente de execução exigido pelo aplicativo.

5. No editor de código do Cloud Shell, consulte o arquivo package.json.

Ele define as dependências do aplicativo Node.js e também o script inicial que o App Engine usa para atender às solicitações.

6. Volte para a janela do Cloud Shell. Se o Cloud Shell não estiver visível, clique em Abrir terminal.

7. No terminal do Cloud Shell, crie um aplicativo do App Engine:

Isso deve ser feito uma vez em cada novo projeto que executa aplicativos do App Engine. Como o App Engine é uma tecnologia regional, isso explica a mudança de região.

8. Implante o aplicativo Hello Logging no App Engine:

Antes de prosseguir, espere a implantação terminar.

9. Quando solicitado, digite y e pressione Enter.

10. Copie o URL para o app recém-implantado no console (https://qwiklabs-gcp-****************.appspot.com) e abra esse link em uma nova guia do navegador.

11. Verifique se há uma resposta Hello World!.

Clique em Verificar meu progresso para conferir o objetivo. Implantar um aplicativo no App Engine.

Tarefa 2: usar o Service Monitoring para criar um SLO de disponibilidade

Nesta tarefa, você vai:

• Usar o Service Monitoring para criar um SLO de disponibilidade.
• Criar um alerta vinculado ao SLO.
• Acionar o alerta.

Gerar carga no aplicativo

1. Na parte de cima da interface do Cloud Shell, clique no ícone Adicionar para abrir uma nova guia.

2. Na nova guia, use uma simples repetição while em bash para gerar carga no aplicativo:

A repetição gera dez solicitações por segundo. Como o URL é destinado à rota /random-error, que gera um erro a cada 1.000 solicitações, você deverá receber aproximadamente 1 erro a cada 100s.

3. Mantenha a repetição em execução na guia do Cloud Shell e passe para a próxima etapa.

Usar o Service Monitoring para criar um SLO de disponibilidade

No momento, temos um aplicativo do App Engine em funcionamento que gera um erro aproximadamente a cada 1.000 solicitações. Imagine que o objetivo é criar um SLO de disponibilidade com meta de 99,5% e um alerta que enviará notificações se o SLO estiver em risco. O Service Monitoring facilita exatamente esse processo.

1. No console do Google Cloud, use o menu de navegação () para acessar o painel do App Engine. Desde já, é possível ver informações sobre o serviço em execução e a carga que está sendo colocada nele.

2. Role para baixo até a seção Server Errors. Já foi gerado algum erro? Se isso ainda não tiver acontecido, espere alguns minutos e atualize a página. Um erro deve aparecer a cada poucos minutos.

3. Use o menu de navegação para acessar o Error Reporting.

Observe que o erro também é detectado aqui. Abordaremos o Error Reporting em um módulo posterior.

4. Use o menu de navegação para acessar o Monitoring.

Aguarde para que o espaço de trabalho de monitoramento seja criado.

5. Quando ele carregar, clique em SLOs.

6. Repare que o Service Monitoring já detectou o aplicativo default do App Engine. Se não aparecer, aguarde um minuto, atualize a página e clique em +Define a service, selecione default e envie.

7. Clique no aplicativo default do App Engine para conferir detalhes sobre ele.

8. Clique em +Criar SLO para iniciar a nova caixa de diálogo de SLO.

9. Selecione a métrica Disponibilidade, deixe o método de avaliação definido como Baseada em solicitações e clique em Continuar.

10. Reserve um momento para investigar os detalhes de SLI exibidos e clique em Continuar.

11. Para definir o SLO, configure Period type como Contínuo e Period length como 7 dias a fim de calcular o SLO em uma janela de tempo de 7 dias em constante movimento.

12. Defina Goal como 99,5% e os gráficos serão preenchidos. No entanto, normalmente é difícil notar a diferença entre 99,5 e 99,9.

13. Clique na linha tracejada vermelha e o gráfico será ampliado para facilitar a visualização.

14. Clique em Continuar, observe o nome padrão e envie o novo SLO clicando em Criar SLO.

Investigar o novo SLO e criar um alerta para ele

• Na seção Current status of 1 SLO, abra o novo SLO e investigue as informações exibidas. Navegue entre as três guias, Indicador de nível de serviço, Margem de erro e Disparo de alertas, e investigue cada uma delas.

Criar um alerta vinculado ao SLO de disponibilidade

O SLO foi criado e, até agora, você está dentro do objetivo. Como a meta do SLO é 99,5% e o SLI precisa mostrar um nível de medição atual de cerca de 99,9%, isso significa que o aplicativo está usando aproximadamente 1/5 da margem de erro, ou seja, a margem de erro deve exibir um valor de cerca de 80%. Seria interessante ter um alerta que fosse acionado para avisar se você começar a ultrapassar a margem de erro em um ritmo inesperadamente rápido.

Há várias maneiras de criar um alerta para um SLO no Service Monitoring.

1. Como você está na interface expandida do SLO, clique na guia Disparo de alertas e selecione CRIAR ALERTA DE SLO.

2. Defina Display name como Teste de janela realmente curto. Como você está fazendo um teste e não definindo valores, isso faria sentido na produção.

3. Defina Lookback duration como 10 minutos e o limite do índice de desempenho de custo como 1,5.

4. Clique em Avançar.

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

6. Role a página para baixo e clique em ADICIONAR NOVO em E-mail.

7. Na caixa de diálogo Criar canal de e-mail, digite seu Endereço de e-mail pessoal no campo com esse nome, além de um Nome de exibição.

8. Clique em Salvar.

9. Em Who should be notified, use o link Manage notification channels para adicionar seu endereço de e-mail como canal de notificação e faça a seleção. Lembre-se de que o link abre uma nova guia. Portanto, feche-a depois que seu endereço de e-mail for adicionado e clique para Salvar o novo alerta.

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

11. Agora selecione o Nome de exibição e clique em OK.

12. Clique em Avançar.

13. Pule Quais são as etapas para corrigir o problema? (opcional) e clique em Salvar.

14. Na página do SLO, volte para a guia Indicador de nível de serviço. Ela deve agora exibir o alerta como uma linha pontilhada vermelha.

15. Mais uma vez, clicar na linha ampliará a visualização. No canto superior direito da página, clique em Atualização automática para que os gráficos sejam atualizados automaticamente.

Acionar o alerta

Modifique o aplicativo e acione o alerta.

1. Volte para a visualização do Cloud Shell, clique em Abrir editor (se ele ainda não estiver exibido) e abra novamente index.js.

2. Role até a rota /random-error encontrada aproximadamente na linha 126 e modifique o valor ao lado de Math.random de 1.000 para 20.

Portanto, em vez de gerar um erro a cada 1.000 solicitações, receberemos um erro a cada 20 solicitações. Isso reduzirá a disponibilidade de 99,9% para cerca de 95%, o que deve acionar o alerta.

3. Feche o editor de código do Cloud Shell e mude para a janela do terminal.

Há duas guias, uma que executa a repetição de teste e outra que é padrão.

4. Na guia padrão (não ocupada), reimplante a mudança no App Engine:

5. Quando solicitado, digite y e pressione Enter.

6. Depois da reimplantação, mude para a guia que executa a repetição de teste e verifique o aumento de erros.

7. Volte para a página do Service Monitoring e, no canto superior direito, verifique se há uma marca verde ao lado da atualização automática.

8. Verifique se o SLO está aberto e se você consegue ver o indicador de nível de serviço.

Após alguns minutos, o valor e o gráfico do SLI devem mostrar claramente a queda no desempenho até aproximadamente o nível de 95%. Em alguns minutos, você também deverá receber o e-mail de notificação de alerta.

Clique em Verificar meu progresso para conferir o objetivo. Criar um SLO e vincular um alerta a ele

Parabéns! Você usou o Service Monitoring para criar um SLO relacionado à disponibilidade e um alerta correspondente. Bom trabalho.

Finalize o laboratório

Após concluir o laboratório, clique em Terminar o laboratório. O Google Skills remove os recursos usados e limpa a conta para você.

Você poderá classificar sua experiência neste 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 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de empresas e produtos podem ser marcas registradas das empresas a que estão associados.