Configurar um escopo de métricas

Este documento descreve como usar o console do Google Cloud para configurar um projeto do Google Cloud e 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 sistemas que precisam gerenciar dados de séries temporais de serviços e recursos associados a diferentes contêineres de recursos.

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

O escopo de métricas de um projeto do Google Cloud determina os dados de séries temporais que o projeto pode representar em um gráfico ou monitorar com políticas de alerta.

Antes de começar

  • Para ter as permissões necessárias para configurar um escopo de métricas, peça ao administrador para conceder a você Papel do IAM Administrador de monitoramento (roles/monitoring.admin) no projeto de escopo e em cada contêiner de recursos que você quer adicionar ao escopo das métricas. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

  • Se você usa o VPC Service Controls, precisa considerar a ordem em que você configura um escopo de métricas e os perímetros da VPC. O Cloud Monitoring executa a verificação de 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 tenta adicionar um contêiner de recursos para o escopo das 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 de escopo ou se está conectado ao projeto de escopo por uma ponte do perímetro. Se a validação do perímetro falhar, a adição do contêiner de recursos para o escopo de métricas também falha.

    • Quando você configura o escopo das métricas primeiro e depois cria os perímetros, o processo de validação do perímetro não é executado. Com essa abordagem, é possível 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, considerar as implicações das permissões em um projeto com um escopo de métricas que inclua contêineres de recursos do projeto do escopo. Um papel que concede permissão de leitura ao Monitoring no projeto de escopo permite que o principal confira gráficos e políticas de alertas que pode exibir dados armazenados por um contêiner de recursos incluído no escopo das métricas.

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

Adicionar um contêiner de recursos a um escopo de métricas permite o projeto do escopo lê os dados de série temporal armazenados nesse recurso. contêiner do Docker. Portanto, os gráficos podem mostrar esses dados de série temporal, e as políticas de alerta podem monitorá-los. Se o contêiner tiver recursos filhos, os dados armazenados não serão incluídos nos escopo de métricas.

Um contêiner de recurso monitorado é um contêiner de recursos que foi adicionado para um escopo de métricas. Adicionar um contêiner de recursos a um escopo de métricas não muda o contêiner.

Se você estiver usando o App Hub, para conferir as métricas do sistema do App Hub, é preciso configurar Projeto host do App Hub e o escopo de métricas. Adicionar um projeto de serviço do App Hub a um projeto host do App Hub não modifica o escopo de métricas do projeto. Da mesma forma, adicionar um projeto a um o escopo de métricas não modifica a lista de projetos de serviço do App Hub anexados ao projeto host do App Hub. Para informações sobre como configurar um projeto host do App Hub, consulte Adicionar ou remover projetos de serviço.

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

  1. No console do Google Cloud, abra a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione Escopo de métrica.

    A guia Escopo de métricas lista os recursos monitorados pelo projeto atual do Google Cloud. Ele também lista os projetos do Google Cloud cujo escopo de métricas inclui o projeto atual do Google Cloud.

  3. Para adicionar projetos do Google Cloud ao escopo de métricas:

    1. No painel Projetos do Google Cloud, clique em Adicionar projetos.
    2. Na caixa de diálogo Add Google Cloud projects, clique em Select Projects e faça suas seleções. Para salvar suas alterações, clique em Adicionar projetos.

      Você volta à página Configurações, e a tabela nessa página é 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.

    O escopo das métricas do projeto selecionado foi atualizado para incluir os projetos do Google Cloud que você selecionou.

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

Depois de remover um contêiner de recursos de um escopo de métricas, os dados de série temporal armazenados nesse contêiner não podem ser representados em um gráfico nem monitorados pelo projeto de escopo. 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 definidos por você. No entanto, a série temporal exibida nos gráficos e a série temporal monitorada pelas políticas de alertas podem mudar.

Se você estiver usando o App Hub, antes de remover de um projeto do escopo das métricas garantem que o projeto não esteja sendo usado um aplicativo do App Hub. Remover o projeto da escopo de métricas não afetará o aplicativo. No entanto, você não poderá para visualizar as métricas do sistema desse aplicativo no contexto da projeto host do App Hub. Para informações sobre como configurar um projeto host do App Hub, consulte Adicionar ou remover projetos de serviço.

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

  1. No console do Google Cloud, abra a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione Escopo da métrica.
  3. No painel Projetos do Google Cloud, selecione os projetos que você quer remover, clique em Remover projeto e conclua a caixa de diálogo de confirmação.

Listar recursos monitorados em um escopo de métricas

Para listar os recursos em um escopo de métricas, faça o seguinte:

  1. No console do Google Cloud, abra a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione Escopo de métrica.

    A guia Escopo da métrica lista os recursos monitorados pelo ambiente projeto do Google Cloud. Ele também lista os projetos do Google Cloud cujo escopo de métricas inclui o projeto atual do Google Cloud.

Selecione outro escopo de métricas

O projeto escolhido no seletor do console do Google Cloud é o do escopo das métricas atuais. Há uma relação direta entre um projeto de escopo e um escopo de métricas.

Para selecionar um escopo de métricas diferente, selecione um projeto diferente com o Seletor de projetos do console do Google Cloud.

A seguir