Visão geral dos escopos de métricas

Neste documento, descrevemos como o Cloud Monitoring determina quais dados de série temporal seu projeto Google Cloud pode criar gráficos e monitorar. Se você só quiser criar gráficos e monitorar os dados de série temporal coletados pelo seu projeto Google Cloud , não será necessário fazer nenhuma configuração. Recomendamos que você conclua o guia de início rápido do Compute Engine. No entanto, se você quiser criar gráficos e monitorar os dados de série temporal coletados por vários projetos do Google Cloud , será necessário fazer algumas configurações. Este documento apresenta o modelo de dados e as práticas recomendadas. Para informações de configuração, consulte os documentos listados na seção Próximas etapas.

Modelo de dados

Esta seção apresenta os conceitos de um contêiner de recursos, um escopo de métricas e um projeto de escopo.

Contêiner de recursos
Um contêiner de recursos é um projeto Google Cloud . Os contêineres de recursos armazenam dados de série temporal para os serviços e a cota usados por esse contêiner. Os dados de série temporal armazenados por um contêiner de recursos incluem um rótulo que identifica o contêiner. Ao visualizar dados armazenados em vários contêineres de recursos, é possível filtrar e agrupar por esse rótulo.
Escopo de métricas
O escopo de métricas de um projeto Google Cloud define o conjunto de contêineres de recursos cujos dados de série temporal o projeto pode criar gráficos e monitorar. Os dados monitorados incluem os serviços que você cria e associa a SLOs e políticas de alertas. Por padrão, o escopo de métricas de um projeto Google Cloud inclui apenas esse projeto. Portanto, a menos que você configure o escopo de métricas, um projeto Google Cloud só poderá criar gráficos e monitorar os dados de série temporal que armazena. É possível usar o console Google Cloud , a Google Cloud CLI e a API Cloud Monitoring para modificar a lista de contêineres de recursos incluídos em um escopo de métricas.
Projeto do escopo exibido atualmente
Um projeto de escopo hospeda um escopo de métricas. O projeto de escopo armazena as políticas de alertas, as verificações de tempo de atividade, os painéis, os monitores sintéticos, os serviços e os grupos de monitoramento que você configura. Como todos os projetos do Google Cloud hospedam um escopo de métricas, todo projeto também é um projeto de escopo. Ao usar o console Google Cloud , o projeto de escopo é o projeto selecionado pelo seletor de projetos do console Google Cloud .

Escopos de métricas e aplicativos do App Hub

Você gerencia o escopo das métricas para projetos host do App Hub. É possível gerenciar esse escopo usando o console doGoogle Cloud ou a API Cloud Monitoring.

Google Cloud gerencia o escopo de métricas para pastas habilitadas para apps, 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, você pode solicitar um aumento de cota e adicionar manualmente projetos ao escopo de métricas do projeto de gerenciamento da pasta ativada para apps. Para saber mais, consulte Escopos de métricas para pastas habilitadas para apps.

Exemplo de configuração do escopo de métricas

Suponha que você tenha dois projetos, chamados Staging e Production, que contenham instâncias de máquina virtual (VM) do Compute Engine. Para conferir as métricas de todas as VMs em uma única visualização, crie outro projeto, AllEnvironments, e adicione os projetos Staging e Production ao escopo de métricas do projeto chamado AllEnvironments.

Com essa configuração, para criar um gráfico que mostre dados de séries temporais armazenados no projeto Staging, a primeira etapa é abrir o console Google Cloud e selecionar um projeto com o seletor de projetos do console Google Cloud :

  • Se você selecionar AllEnvironments, o gráfico poderá mostrar dados de série temporal armazenados pelo projeto Staging, além de dados de série temporal armazenados pelos projetos Production e AllEnvironments. Para ver os dados de série temporal armazenados pelo projeto Staging, adicione um filtro.

    A linha tracejada no diagrama a seguir mostra os projetos cujos dados de série temporal podem ser representados em gráficos e monitorados pelo projeto AllEnvironments:

    O escopo de métricas de várias visualizações inclui todos os três projetos selecionados.

  • Se você selecionar Staging, o gráfico vai mostrar dados de série temporal armazenados pelo projeto Staging.

    O escopo de métricas de "Staging" inclui apenas o projeto "Staging".

Práticas recomendadas

  • Quando você quiser criar gráficos ou monitorar dados de série temporal armazenados em vários contêineres de recursos, recomendamos usar um novo projeto Google Cloud ou um sem recursos como o projeto de escopo, porque esses projetos não armazenam dados de série temporal.

    Considere um cenário em que seu projeto de escopo contém recursos como VMs. Para criar um gráfico ou monitorar apenas os dados de série temporal das VMs no projeto de escopo, especifique filtros para excluir as séries temporais das VMs armazenadas em contêineres de recursos monitorados. O requisito de usar filtros aumenta a complexidade de configurar um gráfico e uma política de alertas, além de aumentar a possibilidade de um erro de configuração.

  • Considere usar vários projetos de escopo para controlar quais equipes têm acesso aos dados de série temporal armazenados nos seus projetos. A tabela a seguir ilustra uma possível configuração:

      Escopo A Escopo B Escopo C
    Projeto do escopo scoping-project-A scoping-project-B scoping-project-C
    Projetos monitorados Projeto 1
    Projeto 2
    Projeto 3
    Projeto 4
    Projeto 1
    Projeto 2
    Projeto 3
    Projeto 4
    Projeto 5
    Grupo de permissões do IAM
    (exemplo)
    Equipe de desenvolvedores A Equipe de desenvolvedores B Equipe de SRE

Conceder acesso ao Cloud Monitoring

Para ver os dados de série temporal que podem ser representados em gráficos ou monitorados por um projeto, seu papel do Identity and Access Management (IAM) no projeto precisa incluir todas as permissões do papel Leitor do Monitoring (roles/monitoring.viewer). Você não precisa de outras permissões. Por exemplo, suponha que o escopo de métricas de um projeto de escopo monitore três projetos Google Cloud e que você tenha o papel de leitor do Monitoring no projeto de escopo. Ao acessar o projeto de escopo usando o console do Google Cloud , é possível conferir os dados de série temporal armazenados nele e nos outros três projetos do Google Cloud .

Para modificar um escopo de métricas, seus papéis do IAM no projeto de escopo e em cada contêiner de recursos que você quer adicionar precisam incluir todas as permissões do papel de administrador do Monitoring (roles/monitoring.admin).

Para mais informações, consulte Controlar o acesso com o Identity and Access Management.

Preços

Em geral, as métricas do sistema do Cloud Monitoring são gratuitas, e as métricas de sistemas, agentes ou aplicativos externos não são. As métricas faturáveis são cobradas pelo número de bytes ou de amostras ingeridas.

Para mais informações, consulte as seções do Cloud Monitoring na página de preços do Google Cloud Observability.

A seguir