Este documento descreve como o escopo das métricas do projeto de gerenciamento da sua pasta habilitada para apps é configurado. Se você ativar uma pasta para o Application Monitoring, o serviço vai Google Cloud criar um projeto de gerenciamento. O projeto de gerenciamento armazena as informações de configuração exigidas pelos serviços do Google Cloud Observability e é o projeto que você usa para visualizar a telemetria do aplicativo.
Se você não estiver usando uma pasta habilitada para apps, este documento não será aplicável. Em vez disso, consulte Configurar um escopo de métricas.
Nesta página, descrevemos como visualizar o uso da cota do escopo de métricas, como solicitar uma atualização de cota e como atualizar manualmente o escopo das métricas do projeto de gerenciamento da sua pasta habilitada para apps.
Como o escopo das métricas de uma pasta habilitada para apps é gerenciado
Para pastas habilitadas para apps, o Google Cloud Observability tenta sincronizar a lista de projetos na pasta habilitada para apps com a lista de projetos no escopo das métricas. Por exemplo, se você adicionar um projeto à pasta habilitada para apps, um comando será emitido para adicionar esse projeto ao escopo das métricas.
Quando o número de projetos na pasta habilitada para apps não exceder a cota do escopo das métricas, que é de 375 projetos por escopo de métricas, o Google Cloud Observability poderá manter a lista de projetos no escopo das métricas sincronizada com a lista de projetos na pasta habilitada para apps. Por exemplo, suponha que a cota seja de 375 projetos por escopo de métricas. Se a pasta habilitada para apps contiver 100 projetos, o escopo das métricas vai listar todos os projetos na pasta habilitada para apps. Se você adicionar projetos à pasta habilitada para apps, eles também serão adicionados ao escopo das métricas.
Quando o número de projetos na pasta habilitada para apps exceder a cota do escopo das métricas, a lista de projetos no escopo das métricas não vai incluir todos os projetos na pasta habilitada para apps. Por exemplo, suponha que a cota seja de 375 projetos por escopo de métricas e que a pasta habilitada para apps contenha 380 projetos. Depois que 375 projetos forem adicionados ao escopo das métricas, a cota será esgotada e as tentativas de adicionar os 5 projetos restantes vão falhar. Como resultado, alguns dados do aplicativo não estarão disponíveis para o projeto de gerenciamento.
Se a cota do escopo das métricas estiver esgotada, você poderá fazer o seguinte:
Mudar os projetos listados no escopo das métricas. Por exemplo, você pode remover alguns projetos do escopo das métricas para adicionar outros.
Solicitar um aumento de cota e adicionar manualmente os projetos que não foram adicionados automaticamente. No exemplo anterior, você precisa adicionar manualmente os 5 projetos que não puderam ser adicionados ao escopo das métricas. O Google Cloud Observability 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 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 Administrador do Monitoring (
roles/monitoring.admin) papel do IAM no projeto de gerenciamento da sua pasta habilitada para apps e em cada projeto que você quer adicionar ou remover do 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 usando personalizados papéis ou outros predefinidos papéis.
Ver o uso da cota
Para evitar a necessidade de gerenciar manualmente o escopo das métricas de uma pasta habilitada para apps, verifique se você tem cota disponível antes de adicionar projetos à pasta habilitada para apps. Esta seção descreve como visualizar o uso atual da cota.
Para visualizar o uso da cota do escopo das métricas, faça o seguinte:
-
No Google Cloud console, acesse a settings Configurações página:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- No Google Cloud console, selecione o projeto de gerenciamento da sua pasta habilitada para apps.
Selecione Escopo de métricas.
O painel Cota do escopo de métricas mostra o uso e a cota. Os ícones na guia Escopo de métricas têm o seguinte significado:
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 cota foram consumidos.
Solicitar aumento de cota
Se o uso da cota do escopo das métricas do projeto exceder 70%, então 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 Google Cloud projetos. Se você aumentar a cota e adicionar mais de 375 Google Cloud projetos 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 settings Configurações página:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- No Google Cloud console, selecione o projeto de gerenciamento da sua pasta habilitada para apps.
- Selecione Escopo de métricas.
No painel Cota do escopo de métricas, selecione Solicitar aumento de cota, e preencha a caixa de diálogo.
Solicite um aumento da cota chamada "Projetos monitorados / Escopo de métricas do Monitoring". Para mais informações sobre ajustes de cota, consulte Sobre ajustes de cota.
Depois que a cota for aumentada, você poderá adicionar projetos ao escopo das 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 settings Configurações página:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- No Google Cloud console, selecione o projeto de gerenciamento da sua pasta habilitada para apps.
Selecione Escopo de métricas.
A guia Escopo de métricas lista os recursos monitorados pelo projeto atual Google Cloud . Ela também lista os Google Cloud projetos cujo escopo de métricas inclui o projeto Google Cloud atual.
Para adicionar Google Cloud projetos ao escopo das 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 alterações, clique em Adicionar projetos.
Você será redirecionado para a página Configurações, e a tabela nessa página será atualizada para listar suas seleções. Se você 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 Google Cloud console para que as novas métricas fiquem visíveis.
O escopo das métricas do projeto selecionado foi atualizado para incluir os Google Cloud projetos selecionados.
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 Google Cloud projetos. Se você tiver esgotado essa cota, poderá remover 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 poderão ser representados em gráficos 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 Google Cloud console, acesse a settings Configurações página:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- No Google Cloud console, selecione o projeto de gerenciamento da sua pasta habilitada para apps.
- Selecione Escopo de métricas.
- No painel Projetos do Google Cloud, selecione os projetos que você quer remover, clique em Remover projeto, e preencha 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 settings Configurações página:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- No Google Cloud console, selecione o projeto de gerenciamento da sua pasta habilitada para apps.
Selecione Escopo de métricas.
A guia Escopo de métricas lista os recursos monitorados pelo projeto atual Google Cloud . Ela também lista os Google Cloud projetos cujo escopo de métricas inclui o projeto Google Cloud atual.