Componentes do modelo de métricas

O modelo do Cloud Monitoring para dados de monitorização consiste em três conceitos principais:

• Tipos de recursos monitorizados
• Tipos de métricas
• Intervalos temporais

O documento O modelo de métricas descreve estes conceitos do Cloud Monitoring em termos gerais. Se estes conceitos forem novos para si, leia primeiro essa página.

Esta página descreve os tipos de métricas, os recursos monitorizados e as séries cronológicas, juntamente com alguns conceitos relacionados, de forma mais detalhada. Estes conceitos estão na base de todas as métricas de monitorização.

Deve compreender as informações nesta página antes de tentar obter dados de monitorização não processados ou agregados através da API Monitoring, conforme descrito no artigo Obtenha dados de séries cronológicas. Para mais detalhes sobre estes conceitos e como se relacionam com a API Cloud Monitoring, consulte Estrutura das séries cronológicas, especialmente se planeia usar a API Monitoring.

Informações sobre etiquetas

Os tipos de recursos monitorizados e os tipos de métricas suportam etiquetas, que permitem classificar os dados durante a análise. Por exemplo:

• Um tipo de recurso monitorizado para uma máquina virtual pode incluir etiquetas para a localização da máquina e o ID do projeto associado à máquina. Quando são registadas informações sobre o recurso monitorizado, as informações incluem os valores das etiquetas.

• Um tipo de métrica que contabiliza pedidos de API pode ter etiquetas para registar o nome do método invocado e o estado do pedido.

A utilização de etiquetas é abordada mais detalhadamente em Etiquetas.

Tipos de recursos monitorizados

Um recurso monitorizado é um recurso a partir do qual são capturados dados de métricas. O Cloud Monitoring suporta aproximadamente 270 tipos de recursos monitorizados.

Os tipos de recursos monitorizados incluem nós e tarefas genéricos, componentes arquitetónicos no Google Kubernetes Engine e muito mais.

Cada tipo de recurso monitorizado é descrito formalmente numa estrutura de dados denominada descritor de recurso monitorizado. Para mais informações, consulte o artigo Descritores de recursos monitorizados.

Cada um dos tipos de recursos monitorizados suportados tem uma entrada na lista de recursos monitorizados. As entradas na lista são criadas a partir dos descritores de recursos monitorizados. Esta secção descreve as informações captadas num descritor de recurso monitorizado e mostra como são apresentadas na lista.

Um tipo de recurso monitorizado de exemplo

A imagem seguinte mostra a entrada na lista para um contentor do Cloud Storage:

Todas as entradas na lista incluem as seguintes informações:

• Tipo: o cabeçalho na entrada indica o tipo de recurso monitorizado; gcs_bucket no exemplo.
• Nome a apresentar: uma breve descrição do recurso monitorizado.
• Descrição: uma descrição mais longa do recurso monitorizado.
• Etiquetas: um conjunto de dimensões para classificar dados. Para mais informações, consulte o artigo Etiquetas.

Tipos de métricas

Um tipo de métrica descreve as medições que podem ser recolhidas a partir de um recurso monitorizado. Um tipo de métrica inclui uma descrição do que está a ser medido e como as medições são interpretadas.

Os tipos de métricas incluem contagens de chamadas API, estatísticas de utilização do disco, consumo de armazenamento e muito mais.

Cada tipo de métrica é descrito formalmente numa estrutura de dados denominada descritor de métricas. Para mais informações, consulte o artigo Descritores de métricas.

Cada um dos tipos de métricas incorporados tem uma entrada nas páginas da lista de métricas. As entradas nestas tabelas são criadas a partir dos descritores de métricas. Esta secção descreve as informações captadas num tipo de métrica e mostra como são apresentadas no material de referência.

Um tipo de métrica de amostra

A imagem seguinte mostra uma entrada para um tipo de métrica do Cloud Storage:

Os tipos de métricas são apresentados numa tabela, e o cabeçalho da tabela explica o esquema das informações. Esta secção usa uma entrada como exemplo, mas todas as tabelas usam o mesmo formato.

A entrada da tabela do Cloud Storage de exemplo dá-lhe as seguintes informações sobre um tipo de métrica:

• Tipo de métrica: um identificador para o tipo de métrica, storage.googleapis.com/api/request_count no exemplo.

  O prefixo storage.googleapis.com funciona como um espaço de nomes para o Cloud Storage. Todos os tipos de métricas associados a um determinado tipo de recurso monitorizado usam o mesmo espaço de nomes.

  Os espaços de nomes são omitidos das entradas nas tabelas.

  Todos os tipos de métricas associados ao Cloud Storage estão listados na tabela de métricas do Cloud Storage.

• Fase de lançamento: um bloco colorido que indica a fase de lançamento do tipo de métrica com um valor como alfa, beta e GA.

• Nome a apresentar: uma string breve que descreve o tipo de métrica, "Número de pedidos" no exemplo.

• Kind, Type, Unit: esta linha fornece informações para interpretar os valores dos dados. O exemplo mostra uma métrica delta registada como um número inteiro de 64 bits sem unidade (esse é o valor 1).

  • Tipo: este exemplo é uma métrica delta, que regista uma alteração ao longo de um período. Ou seja, cada ponto de dados regista o número de chamadas API desde que o ponto de dados anterior foi escrito. Para mais informações sobre os tipos, consulte Tipos de valores e tipos de métricas.

  • Tipo: este exemplo regista os respetivos valores como números inteiros de 64 bits. Para mais informações sobre os tipos, consulte Tipos de valores e tipos de métricas.

  • Unidade: esta métrica não precisa de uma unidade explícita porque representa uma contagem; o dígito 1 é usado para indicar que não é necessária nenhuma unidade.

• Recursos monitorizados: os recursos monitorizados para os quais este tipo de métrica está disponível. Os valores aqui são os mesmos que os descritos em Tipos de recursos monitorizados.

• Descrição: informações mais detalhadas sobre o que é gravado e como. Definido em itálico para o distinguir das etiquetas.

• Etiquetas: um conjunto de dimensões para classificar dados. Para mais informações, consulte o artigo Etiquetas.

Quando acede aos dados de monitorização através da API Cloud Monitoring, inclui um Cloud de Confiance projeto na chamada API. Só pode obter os dados visíveis para esse Cloud de Confiance projeto. Por exemplo, se pedir os dados do seu projeto para o tipo de métrica storage.googleapis.com/api/request_count, vê as contagens da API apenas para os contentores do Cloud Storage no seu projeto. Se o seu projeto não estiver a usar contentores do Cloud Storage, não são devolvidos dados de métricas.

Tipos de métricas integradas

Os tipos de métricas incorporadas são definidos pelos Cloud de Confiance by S3NS serviços, incluindo o Cloud Monitoring. Estes tipos de métricas descrevem medições padrão para uma vasta gama de infraestruturas comuns e estão disponíveis para qualquer pessoa usar.

A lista de métricas mostra o conjunto completo de tipos de métricas incorporadas.

Etiquetas

Uma etiqueta é um par de chave-valor que pode ser usado para fornecer informações sobre um valor de dados.

Etiquetas de métricas e recursos monitorizados

As definições dos tipos de métricas e de recursos monitorizados incluem etiquetas. As etiquetas são classificadores dos dados que estão a ser recolhidos. Ajudam a categorizar os dados para uma análise mais detalhada. Por exemplo:

• O tipo de métrica do Cloud Storage storage.googleapis.com/api/request_count tem duas etiquetas, response_code e method.
• O tipo de recurso monitorizado do Cloud Storage gcs_bucket tem três etiquetas: project_id, bucket_name e location. As etiquetas identificam instâncias específicas do tipo de recurso.

Por conseguinte, todos os dados recolhidos para pedidos de API de um contentor do Cloud Storage são classificados pelo método que foi chamado, o código de resposta da chamada, o nome, a localização e o projeto do contentor envolvido. O conjunto de etiquetas varia consoante a métrica ou o tipo de recurso monitorizado. As etiquetas disponíveis estão documentadas nas páginas Lista de métricas e Lista de recursos monitorizados.

Ao acompanhar o código de resposta, o nome do método e a localização ao contabilizar as chamadas API, pode obter o número de chamadas para um método API específico, o número de chamadas com falhas para qualquer método ou o número de chamadas com falhas para um método específico numa localização específica.

O número de etiquetas e o número de valores que cada uma pode assumir é denominado cardinalidade. A cardinalidade é o número de intervalos temporais possíveis que podem ser recolhidos para um par de tipos de métricas e recursos monitorizados: existe um intervalo temporal para cada combinação de valores das respetivas etiquetas. Para mais informações, consulte o artigo Cardinalidade: séries cronológicas e etiquetas.

Intervalos temporais: dados de um recurso monitorizado

Esta secção aborda o que são os dados de monitorização e como são organizados em séries cronológicas. É aqui que os componentes conceptuais do modelo de métricas se tornam artefactos concretos.

O Cloud Monitoring armazena medições regulares ao longo do tempo para pares de tipos de métricas e recursos monitorizados. As medições são recolhidas em séries cronológicas e cada série cronológica contém os seguintes itens:

• O nome do tipo de métrica ao qual a série cronológica pertence e uma combinação de valores para as etiquetas da métrica.

• Uma série de pares (data/hora, valor). O valor é a medição e a data/hora é a hora em que a medição foi feita.

• O recurso monitorizado que é a origem dos dados de séries cronológicas e uma combinação de valores para as etiquetas do recurso.

É criada uma série cronológica para cada combinação de métricas e etiquetas de recursos que gera dados.

Exemplo estilizado: o tipo de métrica storage.googleapis.com/api/request_count pode ter muitas séries cronológicas para os contentores do Cloud Storage do seu projeto. A ilustração seguinte mostra algumas séries cronológicas possíveis.

Na ilustração, o valor bucket: xxxx representa o valor da etiqueta bucket_name no tipo de recurso monitorizado, e response_code e method são etiquetas no tipo de métrica. Existe um intervalo temporal para cada combinação de valores nas etiquetas de recursos e métricas. As ilustrações mostram algumas delas:

O Cloud Monitoring não regista séries cronológicas "vazias". No exemplo dos contentores do Cloud Storage, se não estiver a usar um contentor específico ou nunca chamar um método de API específico, não são recolhidos dados para essa etiqueta, e nenhuma série cronológica a menciona. Isto significa que, se o seu projeto não tiver dados para uma métrica específica, nunca vê o tipo de métrica.

Os tipos de métricas não indicam que tipos de recursos monitorizados são encontrados nas séries cronológicas das métricas. Para o Cloud Storage, existe apenas um tipo de recurso monitorizado: gcs_bucket. Alguns tipos de métricas são associados a mais de um recurso monitorizado.

Cardinalidade: intervalos temporais e etiquetas

Cada série cronológica está associada a um par específico de tipos de métricas e de recursos monitorizados. Os tipos de métricas e recursos monitorizados fornecem cada um um determinado número de etiquetas. No Cloud Monitoring, o número de combinações únicas de valores para o conjunto de etiquetas é a cardinalidade do tipo de métrica ou do tipo de recurso monitorizado. Estes valores são denominados cardinalidade das métricas e cardinalidade dos recursos e determinam quantas séries cronológicas possíveis, a cardinalidade total, podem ser geradas.

Suponhamos que tem um tipo de métrica que especifica duas etiquetas: color e zone. A cardinalidade das métricas depende do número de valores possíveis que essas etiquetas têm:

• Se existirem apenas três cores possíveis, "vermelho", "verde" e "azul", a etiqueta color pode ter até três valores distintos.
• Se existirem apenas duas zonas possíveis, "east" e "west", a etiqueta zone pode ter até dois valores distintos.

A cardinalidade desta métrica é 6 (3 × 2). Se existirem 1000 valores possíveis para a etiqueta color e se cada cor puder aparecer em cada zona, a cardinalidade da métrica é 2000 (1000 × 2). O mesmo cálculo aplica-se se estas forem etiquetas num tipo de recurso monitorizado e não num tipo de métrica.

Este valor de cardinalidade é um máximo, com base no número de combinações de valores de etiquetas possíveis. O valor efetivo real pode ser significativamente inferior quando todas as combinações de valores de etiquetas não ocorrem efetivamente. Por exemplo, se cada cor aparecer apenas numa zona e não nas duas, o número máximo de séries cronológicas que vê no sistema em execução é 1000. No entanto, a utilidade da cardinalidade eficaz depende dos motivos pelos quais determinadas combinações não aparecem e se podem aparecer no futuro.

Quando os dados de séries cronológicas são escritos, são classificados por métrica e tipos de recursos monitorizados. Para qualquer par de tipos de métricas e recursos, a cardinalidade total é o produto da cardinalidade da métrica e da cardinalidade do recurso. Se tiver uma métrica com uma cardinalidade de 1000 e um recurso com uma cardinalidade de 100, e se todos os valores das etiquetas aparecerem, tem 100 000 intervalos temporais (1000 × 100).