Configurar um escopo de métricas

Neste documento, descrevemos como usar o console do Google Cloud para configurar um projeto do Google Cloud para criar gráficos e monitorar dados de séries temporais armazenados em vários contêineres de recursos. Um contêiner de recursos é um projeto do Google Cloud. Este documento é destinado a desenvolvedores e administradores de sistema que precisam gerenciar dados de séries temporais para serviços e recursos associados a diferentes contêineres de recursos.

Para informações sobre como configurar um projeto do Google Cloud de maneira programática, consulte Configurar um escopo de métricas usando a API.

O escopo de métricas de um projeto do Google Cloud determina apenas os dados da série temporal que o projeto pode traçar e monitorar.

Antes de começar

  • Se você não conhece os termos contêiner de recursos, escopo de métricas e projeto do escopo, consulte Visão geral dos escopos de métricas.

  • Verifique se os papéis do Identity and Access Management (IAM) no projeto do escopo e em cada contêiner de recursos que você quer adicionar ao escopo de métricas incluem todas as permissões no papel Administrador do Monitoring (roles/monitoring.admin). Para mais informações, consulte Papéis de configuração do escopo de métricas.

  • Se você usa o VPC Service Controls, precisa considerar a ordem de configuração de um escopo de métricas e os perímetros da VPC. O Cloud Monitoring executa a verificação do perímetro da VPC quando um contêiner de recursos é adicionado a um escopo de métricas:

    • Quando você cria o perímetro da VPC primeiro e, em seguida, tenta adicionar um contêiner de recursos ao escopo de métricas, o processo de validação do perímetro é executado. Esse processo verifica se o contêiner adicionado está no mesmo perímetro que o projeto do escopo ou se está conectado a ele por uma ponte do perímetro. Se a validação do perímetro falhar, a adição do contêiner de recursos ao escopo de métricas também falhará.

    • Quando você configura o escopo de métricas primeiro e depois cria os perímetros, o processo de validação deles não é executado. Essa abordagem permite acessar dados de séries temporais para contêineres de recursos que estão em perímetros diferentes.

  • Se você configurar papéis do IAM ou conceder acesso a projetos, considere as implicações das permissões em um projeto com um escopo de métricas que inclua contêineres de recursos diferentes do projeto do escopo. Um papel que concede permissão de leitura ao Monitoring no projeto do escopo permite que os principais gráficos de visualização e políticas de alertas que podem exibir dados armazenados por um contêiner de recursos incluído no escopo de métricas.

Adicionar contêineres de recursos a um escopo de métricas

Quando você quiser visualizar ou monitorar dados de série temporal armazenados por vários contêineres de recursos, crie ou selecione um projeto e configure o escopo de métricas dele. Quando você adiciona um contêiner de recursos a um escopo de métricas, ele se torna um contêiner de recursos monitorados.

Adicionar um contêiner de recursos a um escopo de métricas não altera esse contêiner. No entanto, essa ação permite que o gráfico do projeto do escopo e monitore os dados da série temporal armazenados pelo contêiner de recursos. Se o contêiner de recursos adicionado incluir filhos, os dados de série temporal armazenados nesses recursos filhos não serão mapeados nem monitorados pelo projeto do escopo.

Para adicionar contêineres de recursos ao escopo de métricas do projeto atual, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Configurações de monitoramento:

    Acessar Configurações do Monitoring

  2. Para adicionar projetos do Google Cloud ao escopo das métricas, faça o seguinte:

    1. No painel Projetos do GCP, clique em Adicionar projetos do GCP.
    2. Na caixa de diálogo Adicionar projetos do Google Cloud, clique em Selecionar projetos e crie as seções. Para salvar as mudanças, clique em Selecionar.

      Você retornará à página Configurações e a tabela nessa página será atualizada para listar suas seleções. Se você quiser remover um projeto do Google Cloud da lista, clique em Remover projeto.

    3. Clique em Adicionar projetos.

    Depois de adicionar projetos a um escopo de métricas, leva cerca de 60 segundos para que as alterações sejam propagadas por todos os sistemas do Monitoring. Antes de criar um gráfico ou uma política de alertas, aguarde pelo menos 60 segundos. Talvez seja necessário atualizar a página do console do Google Cloud para que as novas métricas fiquem visíveis.

Remover contêineres de recursos monitorados de um escopo de métricas

Depois que você remover um contêiner de recursos de um escopo de métricas, o projeto do escopo não poderá gerar gráficos nem monitorar os dados de séries temporais armazenados nele. Remover um contêiner de um escopo de métricas não altera a configuração de gráficos, painéis, políticas de alertas, verificações de tempo de atividade ou grupos que você definiu. No entanto, a série temporal exibida nos gráficos e a série temporal monitorada pelas políticas de alertas podem mudar.

Para remover contêineres de recursos do escopo de métricas do projeto atual, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Configurações de monitoramento:

    Acessar Configurações do Monitoring

  2. Para remover projetos do Google Cloud do escopo de métricas, no painel Projetos do GCP, selecione os projetos que você quer remover, clique em Remover projeto e preencha a caixa de diálogo de confirmação.

Listar projetos monitorados em um escopo de métricas

Para exibir uma lista de projetos no escopo de métricas atual, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Configurações de monitoramento:

    Acessar Configurações do Monitoring

  2. Confira as tabelas nesta página. As tabelas listam os projetos no escopo de métricas atual.

Também é possível acessar a lista de projetos do escopo de métricas atual acessando o painel de navegação e clicando em Expandir no campo Escopo das métricas. O painel expandido exibe as seguintes informações:

  • Uma lista dos projetos com métricas que podem ser acessadas no escopo atual.
  • Uma lista de projetos com um escopo de métricas que inclui o projeto selecionado.

Selecionar um escopo de métricas diferente

O projeto selecionado no seletor de projetos do console do Google Cloud é o projeto do escopo de métricas atual. Existe uma relação direta entre um projeto de escopo e um escopo de métricas.

Para escolher um escopo de métricas diferente, escolha um projeto diferente com o seletor de projetos do console do Google Cloud.

A seguir