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 projetos. Este documento é destinado a desenvolvedores e administradores de sistemas que precisam gerenciar dados de séries temporais de serviços e recursos associados a projetos diferentes.
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 os dados de séries temporais que o projeto pode representar em um gráfico ou monitorar com políticas de alertas.
Aplicativos e escopos de métricas do App Hub
Você gerencia o escopo das métricas para projetos host do App Hub. É possível gerenciar esse escopo usando o console do Google Cloud ou a API Cloud Monitoring.
OGoogle Cloud gerencia o escopo de métricas para pastas com apps ativados, a menos que a adição de um projeto ao escopo de métricas falhe devido ao esgotamento da cota do escopo de métricas. Nesse caso, é possível solicitar um aumento de cota e adicionar manualmente projetos ao escopo de métricas do projeto de gerenciamento da pasta ativada pelo app. Para saber mais, consulte Escopos de métricas para pastas ativadas por apps.
Antes de começar
- Se você não conhece os termos escopo das métricas e projeto do escopo, consulte Visão geral dos escopos de métricas.
-
Para receber as permissões necessárias para configurar um escopo de métricas, peça ao administrador para conceder a você o papel do IAM de Administrador do Monitoring (
roles/monitoring.admin) no projeto de delimitação e em cada projeto que você quer adicionar ao escopo de 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, considere a ordem em que configura um escopo de métricas e seus perímetros VPC. O Cloud Monitoring executa a verificação de perímetro da VPC quando um projeto é adicionado a um escopo de métricas:
Quando você cria o perímetro da VPC primeiro e depois tenta adicionar um projeto ao 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 projeto ao escopo de métricas também falhará.
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. Essa abordagem permite acessar dados de séries temporais de projetos em diferentes perímetros.
Se você configurar papéis do IAM ou conceder acesso a projetos, considere as implicações das permissões em um projeto cujo escopo de métricas inclui outros projetos além do escopo. Um papel que concede permissão de leitura ao Monitoring no projeto de escopo permite que as políticas de alerta e os gráficos de visualização principais sejam exibidos, que podem mostrar dados armazenados por um projeto incluído no escopo de métricas.
Adicionar projetos a um escopo de métricas
Para adicionar projetos a um escopo de métricas, faça o seguinte:
-
No console do Google Cloud, acesse a página settings Configurações:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
- No console do Google Cloud, selecione seu projeto. Para as configurações do projeto host do App Hub, selecione o projeto host.
Selecione Escopo da 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.
Para adicionar projetos do Google Cloud ao escopo de métricas:
- No painel Google Cloud Projects, clique em Adicionar projetos.
Na caixa de diálogo Add Google Cloud projects, clique em Select Projects e faça suas seleções. Para salvar as 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 cancel Remover projeto.
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 de métricas do projeto selecionado foi atualizado para incluir os projetos do Google Cloud selecionados.
Remover projetos de um escopo de métricas
Talvez você queira remover projetos de um escopo de métricas para melhorar a performance ou liberar a cota para adicionar um projeto diferente. Por exemplo, por padrão, um escopo de métricas pode incluir 375 projetos do Google Cloud. Se você tiver excedido essa cota, remova um projeto para adicionar outro.
Depois de remover um projeto de um escopo de métricas, os dados de série temporal armazenados nesse projeto não podem ser representados em um gráfico ou monitorados pelo projeto de escopo. Remover um projeto do 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.
Para remover projetos de um escopo de métricas, faça o seguinte:
-
No console do Google Cloud, acesse a página settings Configurações:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
- No console do Google Cloud, selecione seu projeto. Para as configurações do projeto host do App Hub, selecione o projeto host.
- Selecione Escopo da métrica.
- No painel Google Cloud Projects, selecione os projetos que você quer remover, clique em Remover projeto e conclua a caixa de diálogo de confirmação.
Listar projetos em um escopo de métricas
Para listar os recursos em um escopo de métricas, faça o seguinte:
-
No console do Google Cloud, acesse a página settings Configurações:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
- No console do Google Cloud, selecione seu projeto. Para as configurações do projeto host do App Hub, selecione o projeto host.
Selecione Escopo da 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.
Solicitar aumento de cota
Por padrão, um escopo de métricas pode incluir 375 projetos do Google Cloud. No entanto, é possível solicitar um aumento da cota "Projetos monitorados / Escopo de métricas do Monitoring". Aumentar a cota além do valor padrão de 375 projetos do Google Cloud pode causar problemas de desempenho.
Para instruções sobre como solicitar um aumento de cota, consulte Como gerenciar a cota usando o console do Google Cloud.
Selecionar um escopo de métricas diferente
O projeto selecionado no seletor de projetos do console do Google Cloud é o escopo do projeto do escopo atual das métricas. 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.