Visão geral dos escopos de métricas

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

Modelo de dados

Nesta seção, apresentamos 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 do Google Cloud. Os contêineres de recursos armazenam dados de série temporal sobre os serviços e a cota usados por esse contêiner. Os dados da série temporal armazenados por um contêiner de recursos incluem um rótulo que identifica esse 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 do Google Cloud define os contêineres de recursos definidos com dados de série temporal que o projeto pode traçar e monitorar. Por padrão, o escopo de métricas de um projeto do Google Cloud inclui apenas esse projeto. Portanto, a menos que você configure o escopo de métricas, um projeto do Google Cloud só poderá criar gráficos e monitorar dados de séries temporais que armazena. É possível usar o console do 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 e armazena alertas, verificações de tempo de atividade, painéis, monitores sintéticos e grupos de monitoramento configurados. Como cada projeto do Google Cloud hospeda um escopo de métricas, todo projeto também é um projeto de escopo. Quando você usa o console do Google Cloud, o projeto do escopo é aquele escolhido pelo seletor de projetos do console do Google Cloud.

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

Suponha que você tenha dois projetos chamados Staging e Production que contêm instâncias de máquina virtual (VM) do Compute Engine. Para ver as métricas de todas as suas 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érie temporal armazenados no projeto Staging, a primeira etapa é abrir o console do Google Cloud e selecionar um projeto com o seletor de projetos do console do Google Cloud:

  • Se você selecionar AllEnvironments, seu gráfico poderá exibir dados de série temporal armazenados pelo projeto Staging junto com dados de séries temporais armazenados pelos projetos Production e AllEnvironments. Para visualizar dados de série temporal armazenados pelo projeto Staging, adicione um filtro.

    A linha tracejada no diagrama a seguir mostra os projetos com dados de série temporal que podem ser mapeados e monitorados pelo projeto AllEnvironments:

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

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

    O escopo de métricas de "Preparação" inclui apenas o projeto "Preparação".

Práticas recomendadas

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

    Considere um cenário em que seu projeto de escopo contenha recursos como VMs. Para criar gráficos ou monitorar apenas os dados de série temporal das VMs no projeto do escopo, especifique filtros para excluir a série temporal das VMs armazenadas em contêineres de recursos monitorados. O requisito do uso de 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éries temporais 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 visualizar os dados de série temporal que podem ser mapeados ou monitorados por um projeto, seu papel do Identity and Access Management (IAM) no projeto precisa incluir todas as permissões em 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 do escopo monitore três projetos do Google Cloud e que você tenha um papel de leitor do Monitoring nesse projeto. Ao acessar o projeto do escopo usando o console do Google Cloud, é possível visualizar os dados de série temporal armazenados nesse projeto e os dados de série temporal armazenados nos outros três projetos do Google Cloud.

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

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

A seguir