Este documento descreve como o escopo de métricas de um projeto de gerenciamento é configurado. Um projeto de gerenciamento é criado por Google Cloud quando você ativa uma pasta para o monitoramento de aplicativos. O projeto de gerenciamento armazena informações de configuração exigidas pelos serviços de Observabilidade do Google Cloud e é o projeto que você usa para conferir a telemetria do aplicativo.
Se você não estiver usando uma pasta ativada por app, este documento não se aplica. Consulte Configurar um escopo de métricas.
Esta página descreve como conferir o uso da cota do escopo de métricas, como solicitar uma atualização de cota e como atualizar manualmente o escopo de métricas do seu projeto de gerenciamento.
Como o escopo de métricas de um projeto de gerenciamento é gerenciado
Para pastas ativadas por apps, a Google Cloud Observability tenta sincronizar a lista de projetos na pasta ativada por apps com a lista de projetos no escopo das métricas. Por exemplo, se você adicionar um projeto à pasta ativada pelo app, um comando será emitido para adicionar esse projeto ao escopo de métricas.
Quando o número de projetos na pasta ativada pelo app não exceder a cota de escopo de métricas, que é padrão de 375 projetos por escopo de métricas, a Observabilidade do Google Cloud poderá manter a lista de projetos no escopo de métricas sincronizada com a lista de projetos na pasta ativada pelo app. Por exemplo, suponha que a cota seja de 375 projetos por escopo de métricas. Se a pasta ativada para o app tiver 100 projetos, o escopo das métricas vai listar todos os projetos na pasta ativada para o app. Se você adicionar projetos à pasta ativada pelo app, eles também serão adicionados ao escopo de métricas.
Quando o número de projetos na pasta ativada pelo app excede a cota de escopo de métricas, a lista de projetos no escopo de métricas não inclui todos os projetos na pasta ativada pelo app. Por exemplo, suponha que a cota seja de 375 projetos por escopo de métricas e que a pasta ativada para apps contenha 380 projetos. Depois que 375 projetos são adicionados ao escopo de métricas, a cota é esgotada e as tentativas de adicionar os cinco projetos restantes falham. Como resultado, alguns dados do aplicativo não estão disponíveis para seu projeto de gerenciamento.
Se a cota do escopo de métricas for esgotada, você poderá fazer o seguinte:
Alterar os projetos listados no escopo de métricas. Por exemplo, é possível remover alguns projetos do escopo de métricas para adicionar outros.
Solicite um aumento de cota e adicione manualmente os projetos que não foram adicionados automaticamente. No exemplo anterior, é necessário adicionar manualmente os cinco projetos que não puderam ser adicionados ao escopo de métricas. A Observabilidade do Google Cloud não vai tentar adicionar um projeto a um escopo de métricas quando a tentativa inicial falhar.
Em ambos os casos, é necessário modificar manualmente o escopo das métricas.
Antes de começar
- Se você não conhece o termo escopo das métricas, 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 de monitoramento (
roles/monitoring.admin) no projeto de gerenciamento da sua pasta com suporte a apps 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.
Conferir o uso da cota
Para evitar a necessidade de gerenciar manualmente o escopo das métricas do projeto de gerenciamento, verifique se você tem cota disponível antes de adicionar projetos à pasta ativada para apps. Esta seção descreve como verificar seu uso de cota atual.
Para conferir o uso da cota do escopo das 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 de gerenciamento.
Selecione Escopo da métrica.
O painel Cota de escopo de métrica mostra o uso e a cota. Os ícones na guia Escopo das métricas têm os seguintes significados:
O ícone de erro, error, indica que pelo menos 90% da sua cota foi consumida.
O ícone de alerta, warning, indica que entre 70% e 90% da sua cota foram consumidos.
Solicitar aumento de cota
Se o uso do projeto da cota de escopo de métricas exceder 70%, um ícone de aviso, warning, ou um ícone de erro, error, será listado na guia Escopo de métricas. Por padrão, um escopo de métricas pode incluir 375 projetos do Google Cloud. Se você aumentar sua cota e adicionar mais de 375 projetos do Google Cloud a um escopo de métricas, poderá ter problemas de desempenho.
Para solicitar um aumento de cota, 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 de gerenciamento.
- Selecione Escopo da métrica.
No painel Cota do escopo de métricas, selecione Solicitar aumento de cota e conclua a caixa de diálogo.
Solicite um aumento da cota "Projetos monitorados / Escopo de métricas do Monitoring". Confira informações detalhadas sobre essa tarefa no documento Gerenciar a cota usando o console do Google Cloud.
Depois que a cota for aumentada, você poderá adicionar projetos ao 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 de gerenciamento.
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 de gerenciamento.
- 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 de gerenciamento.
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.