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 Application Monitoring. O projeto de gerenciamento armazena informações de configuração exigidas pelos serviços do Google Cloud Observability e é o projeto que você usa para ver a telemetria do aplicativo.
Se você não estiver usando uma pasta ativada para apps, este documento não se aplica. Em vez disso, consulte Configurar um escopo de métricas.
Nesta página, descrevemos 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 para apps, o Google Cloud Observability tenta sincronizar a lista de projetos na pasta com a lista de projetos no escopo de métricas. Por exemplo, se você adicionar um projeto à pasta ativada para apps, um comando será emitido para adicionar esse projeto ao escopo de métricas.
Quando o número de projetos na pasta ativada para apps não excede a cota do escopo de métricas, que é de 375 projetos por escopo, o Google Cloud Observability pode manter a lista de projetos no escopo de métricas sincronizada com a lista de projetos na pasta ativada para apps. Por exemplo, suponha que a cota seja de 375 projetos por escopo de métricas. Se a pasta ativada para apps tiver 100 projetos, o escopo de métricas vai listar todos os projetos na pasta. Se você adicionar projetos à pasta ativada para apps, eles também serão adicionados ao escopo de métricas.
Quando o número de projetos na pasta ativada para apps excede a cota do escopo de métricas, a lista de projetos no escopo não inclui todos os projetos na pasta ativada para apps. Por exemplo, suponha que a cota seja de 375 projetos por escopo de métricas e que sua pasta habilitada 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 de aplicativos não estão disponíveis para seu projeto de gerenciamento.
Se a cota de escopo de métricas estiver esgotada, faça uma destas ações:
Mudar 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 incluídos no 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, você precisa modificar manualmente o escopo das métricas.
Antes de começar
- Se você não estiver familiarizado com 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 do Monitoring (
roles/monitoring.admin) no projeto de gerenciamento da pasta ativada para apps e em cada projeto que você quer adicionar ou remover do 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 de métricas do projeto de gerenciamento, verifique se você tem cota disponível antes de adicionar projetos à pasta habilitada para gerenciar apps. Esta seção descreve como ver seu uso de cota atual.
Para conferir o uso da cota do escopo de métricas, faça o seguinte:
-
No Google Cloud console, 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 Monitoring.
- No console 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 foram consumidos.
O ícone de aviso, warning, indica que entre 70% e 90% da sua cota foi consumida.
Solicitar aumento de cota
Se o uso da cota do escopo de métricas do projeto 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 projetosGoogle Cloud . Se você aumentar a cota e adicionar mais de 375 projetos Google Cloud a um escopo de métricas, poderá ter problemas de desempenho.
Para solicitar um aumento de cota, faça o seguinte:
-
No Google Cloud console, 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 Monitoring.
- No console 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 preencha a caixa de diálogo.
Peça um aumento da cota chamada "Projetos monitorados / Escopo de métricas do Monitoring". Para mais informações sobre essa tarefa, consulte o documento Gerenciar sua cota usando o console Google Cloud .
Depois que sua 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 Google Cloud console, 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 Monitoring.
- No console Google Cloud , selecione seu projeto de gerenciamento.
Selecione Escopo da métrica.
A guia Escopo de métricas lista os recursos monitorados peloGoogle Cloud projeto atual. Ela também lista os projetos Google Cloud cujo escopo de métricas inclui o projeto Google Cloud atual.
Para adicionar projetos Google Cloud ao escopo de métricas:
- No painel Projetos do Google Cloud, clique em Adicionar projetos.
Na caixa de diálogo Adicionar projetos do Google Cloud, clique em Selecionar projetos e faça suas seleções. Para salvar as mudanças, clique em Adicionar projetos.
Você volta à página Configurações, e a tabela nessa página é atualizada para listar suas seleções. Se quiser remover um Google Cloud projeto 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 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 Google Cloud que você escolheu.
Remover projetos de um escopo de métricas
Talvez você queira remover projetos de um escopo de métricas para melhorar o desempenho ou liberar cota para adicionar um projeto diferente. Por exemplo, por padrão, um escopo de métricas pode incluir 375 projetos Google Cloud . Se você esgotou 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 nele não poderão ser representados em gráficos nem monitorados pelo projeto de escopo. Remover um projeto de um escopo de métricas não muda 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 Google Cloud console, 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 Monitoring.
- No console Google Cloud , selecione seu projeto de gerenciamento.
- Selecione Escopo da métrica.
- 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 projetos em um escopo de métricas
Para listar os recursos em um escopo de métricas, faça o seguinte:
-
No Google Cloud console, 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 Monitoring.
- No console Google Cloud , selecione seu projeto de gerenciamento.
Selecione Escopo da métrica.
A guia Escopo de métricas lista os recursos monitorados peloGoogle Cloud projeto atual. Ela também lista os projetos Google Cloud cujo escopo de métricas inclui o projeto Google Cloud atual.