Entender como os tipos de recursos monitorados, tipos de métricas, rótulos e séries temporais funcionam juntos no Cloud Monitoring ajuda a consultar e interpretar dados de monitoramento com precisão. Aplique esses conceitos ao recuperar dados de série temporal com a API Cloud Monitoring.
Se esses conceitos forem novos para você, comece com Métricas, série temporal e recursos. Para esquemas de objetos da API Monitoring, consulte Estrutura de séries temporais.
Uma palavra sobre rótulos
Os tipos de recursos monitorados e de métricas são compatíveis com rótulos, que permitem que os dados sejam classificados durante a análise. Exemplo:
- Um tipo de recurso monitorado para uma máquina virtual pode incluir rótulos para o local da máquina e o ID do projeto associado à máquina. Quando as informações sobre o recurso monitorado são registradas, elas incluem os valores dos rótulos.
- Um tipo de métrica que conta solicitações de API pode ter rótulos para registrar o nome do método invocado e o status da solicitação.
O uso de rótulos é discutido em mais detalhes em Rótulos.
Tipos de recursos monitorados
Um recurso monitorado é um recurso de onde dados da métrica são capturados. O Cloud Monitoring é compatível com aproximadamente 270 tipos de recursos monitorados.
Os tipos de recursos monitorados incluem nós e tarefas genéricos, componentes arquitetônicos no Google Kubernetes Engine e muito mais.Cada tipo de recurso monitorado é formalmente descrito em uma estrutura de dados chamada descritor de recurso monitorado. Para mais informações, consulte Descritores de recursos monitorados.
Cada um dos tipos de recursos monitorados compatíveis tem uma entrada na Lista de recursos monitorados. As entradas na lista são criadas com base em descritores de recursos monitorados. Nesta seção, descrevemos as informações capturadas em um descritor de recursos monitorados e mostra como elas são apresentadas na lista.
Uma amostra de tipo de recurso monitorado
A imagem a seguir mostra a entrada na lista de um bucket do Cloud Storage:
Todas as entradas da lista incluem as seguintes informações:
- Tipo: o cabeçalho na entrada lista o tipo de recurso monitorado,
gcs_bucketno exemplo. - Nome de exibição: uma breve descrição do recurso monitorado.
- Descrição: uma descrição mais longa do recurso monitorado.
- Rótulos: um conjunto de dimensões para classificar dados. Para mais informações, consulte Rótulos.
Tipos de métricas
Um tipo de métrica descreve as medições que podem ser coletadas de um recurso monitorado. Um tipo de métrica inclui uma descrição do que está sendo medido e como as medições são interpretadas.Os tipos de métricas incluem contagens de chamadas de API, estatísticas de uso do disco, consumo de armazenamento e muito mais.
Cada tipo de métrica é formalmente descrito em uma estrutura de dados chamada de descritor de métrica. Para mais informações, consulte Descritores de métricas.
Cada um dos tipos de métricas integradas tem uma entrada nas páginas da lista de métricas. As entradas nessas tabelas são criadas a partir dos descritores de métrica. Nesta seção, descrevemos as informações capturadas em um tipo de métrica e mostra como elas são apresentadas no material de referência.
Um exemplo de tipo de métrica
A imagem a seguir mostra uma entrada para um tipo de métrica do Cloud Storage:
Os tipos de métrica são exibidos em uma tabela, e o cabeçalho da tabela explica o layout das informações. Nesta seção, usamos uma entrada como exemplo, mas todas as tabelas usam o mesmo formato.
A entrada de tabela de amostra do Cloud Storage apresenta estas informações sobre um tipo de métrica:
Tipo de métrica: um identificador para o tipo de métrica. No exemplo,
storage.googleapis.com/api/request_count.O prefixo
storage.googleapis.comatua como um namespace para o Cloud Storage. Todos os tipos de métricas associadas a um determinado tipo de recurso monitorado usam o mesmo namespace.Os namespaces são omitidos das entradas nas tabelas.
Todos os tipos de métricas associadas ao Cloud Storage estão listados na tabela de métricas do Cloud Storage.
Estágio de lançamento: um bloco colorido que indica o estágio de lançamento do tipo de métrica com um valor como Alfa, Beta ou GA.
Nome de exibição: uma string curta que descreve o tipo de métrica "Contagem de solicitações" no exemplo.
Tipo, unidade: esta linha fornece informações para interpretar os valores de dados. O exemplo mostra uma métrica delta registrada como um número inteiro de 64 bits sem unidade (esse é o valor
1).Tipo: este exemplo é uma métrica delta, que registra uma alteração em um período. Ou seja, cada ponto de dados registra o número de chamadas de API desde que o ponto de dados anterior foi gravado. Para mais informações sobre tipos, consulte Tipos de valor e tipos de métrica.
Tipo: este exemplo registra os valores como números inteiros de 64 bits. Para mais informações sobre tipos, consulte Tipos de valor e de métricas.
Unidade: essa métrica não precisa de uma unidade explícita porque representa uma contagem. o dígito
1é usado para indicar que nenhuma unidade é necessária.
Recursos monitorados: os recursos monitorados que têm esse tipo de métrica disponível. Os valores aqui são os mesmos descritos em Tipos de recursos monitorados.
Descrição: informações mais detalhadas sobre o que é gravado e como. Defina em itálico para diferenciá-lo dos rótulos.
Rótulos: um conjunto de dimensões para classificar dados. Para mais informações, consulte Rótulos.
Ao acessar dados de monitoramento pela API Cloud Monitoring, inclua um projeto do Cloud de Confiance na chamada de API. Só é possível recuperar os dados que estão
visíveis para esse projeto do Cloud de Confiance . Por exemplo, se você solicitar
os dados do projeto para o tipo de métrica
storage.googleapis.com/api/request_count,
as contagens de API serão exibidas apenas para os buckets do Cloud Storage no projeto.
Se o projeto não estiver usando buckets do Cloud Storage, nenhum dado de métrica será retornado.
Tipos de métricas integrados
Os tipos de métricas integradas são definidos pelos serviços do Cloud de Confiance by S3NS , incluindo o Cloud Monitoring. Esses tipos de métrica descrevem medições padrão para uma ampla variedade de infraestruturas comuns e estão disponíveis para qualquer pessoa usar.
A lista de métricas mostra todo o conjunto de tipos de métricas integradas.Rótulos
Um rótulo é um par de chave-valor que pode ser usado para fornecer informações sobre um valor de dados.
Rótulos de métricas e recursos monitorados
As definições de tipos de métricas e recursos monitorados incluem rótulos. Os rótulos são classificadores para os dados que estão sendo coletados. Eles ajudam a categorizar os dados para uma análise mais profunda. Exemplo:
- O tipo de métrica
storage.googleapis.com/api/request_countdo Cloud Storage tem dois rótulos,response_codeemethod. - O tipo de recurso monitorado do Cloud Storage
gcs_buckettem três rótulos,project_id,bucket_nameelocation. Os rótulos identificam instâncias específicas do tipo de recurso.
Portanto, toda a coleta de dados para solicitações de API de um bucket do Cloud Storage é classificada pelo método chamado, pelo código de resposta da chamada e pelo nome, local e projeto do bucket envolvido. O conjunto de rótulos varia de acordo com a métrica ou o tipo de recurso monitorado. Os rótulos disponíveis são documentados nas páginas Lista de métricas e Lista de recursos monitorados.
Ao rastrear o código de resposta, o nome do método e o local ao contar as chamadas de API, é possível buscar o número de chamadas para um método de API específico, o número de chamadas com falha para qualquer método ou o número de chamadas com falha para um método específico em um local específico.
O número de rótulos e o número de valores que cada um pode presumir é chamado de cardinalidade. A cardinalidade é o número de séries temporais que podem ser coletadas para um par de tipos de métricas e de recursos monitorados: há uma série temporal para cada combinação de valores dos rótulos. Para mais informações, consulte Cardinalidade: série temporal e rótulos.
Série temporal: dados de um recurso monitorado
Nesta seção, discutimos o que são dados de monitoramento e como eles são organizados em séries temporais. É aqui que os componentes conceituais do modelo de métrica se tornam artefatos concretos.
O Cloud Monitoring armazena medições regulares ao longo do tempo para pares de tipos de métricas e recursos monitorados. As medições são coletadas em séries temporais e cada série temporal inclui os itens a seguir:
O nome do tipo de métrica a que a série temporal pertence e uma combinação de valores para os rótulos da métrica.
Uma série de pares (carimbo de data/hora, valor). O valor é a medida e o carimbo de data/hora é a hora em que a medição foi feita.
O recurso monitorado, que é a fonte dos dados da série temporal e também uma combinação de valores para os rótulos do recurso.
Uma série temporal é criada para cada combinação de rótulos de métricas e recursos que gera dados.
Exemplo estilizado: o tipo de métrica storage.googleapis.com/api/request_count
pode ter muitas série temporal para os buckets do Cloud Storage
do seu projeto. A tabela a seguir mostra algumas série temporal possíveis.
Na tabela, o valor bucket: xyz representa o valor do rótulo bucket_name no tipo de recurso monitorado, e response_code e method são rótulos no tipo de métrica. Há uma série temporal para cada combinação de valores nos rótulos de recurso e métrica. A tabela mostra alguns deles:
| Rótulo de recurso monitorado |
Rótulos de métrica | Dados de métricas |
|---|---|---|
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: OK, |
{ |
bucket: 1234 |
response_code: FAIL, |
{ |
bucket: 9876 |
response_code: OK, |
{ |
O Cloud Monitoring não registra série temporal "vazias". No exemplo de buckets do Cloud Storage, se você não estiver usando um bucket específico ou nunca chamar um método de API específico, nenhum dado será coletado para esse rótulo e nenhuma série temporal o mencionará. Isso significa que, se o projeto não tiver dados para uma determinada métrica, você nunca verá o tipo de métrica.
Os tipos de métrica não indicam quais tipos de recursos monitorados são encontrados na série temporal das métricas. Para o Cloud Storage, há apenas um tipo de recurso monitorado: gcs_bucket. Alguns tipos de métricas são pareados com mais de um recurso monitorado.
Cardinalidade: séries temporais e rótulos
Cada série temporal está associada a um par específico de tipos de métrica e recurso monitorado. Os tipos de métrica e de recurso monitorado fornecem um número de rótulos. No Cloud Monitoring, o número de combinações exclusivas de valores para o conjunto de rótulos é a cardinalidade do tipo de métrica ou do tipo de recurso monitorado. Esses valores são chamados de cardinalidade de métrica e cardinalidade de recurso, e determinam quantas série temporal possíveis, a cardinalidade total, podem ser geradas.
Suponha que você tenha um tipo de métrica que especifica dois rótulos,
color e zone. A cardinalidade da métrica depende do número de valores possíveis
que esses rótulos têm:
- Se houver apenas três cores possíveis, "vermelho",
"verde" e "azul", o rótulo
colorpoderá ter até três valores distintos. - Se houver apenas duas zonas possíveis, "leste" e
"oeste", o rótulo
zonepoderá ter até dois valores distintos.
A cardinalidade dessa métrica é 6 (3×2). Se houver 1.000 valores possíveis para o rótulo color e se cada cor puder aparecer em cada zona, a cardinalidade da métrica será 2.000 (1.000 × 2). O mesmo cálculo se aplica
se esses forem rótulos em um tipo de recurso monitorado, em vez de um tipo de métrica.
Esse valor de cardinalidade é um máximo, com base no número de combinações de valores de rótulo possíveis. O valor real e efetivo pode ser significativamente menor quando nem todas as combinações de valores de rótulo ocorrem. Por exemplo, se cada cor aparecer em apenas uma zona, e não em ambas, o número máximo de série temporal que você verá no sistema em execução será 1.000. No entanto, a utilidade da cardinalidade efetiva depende dos motivos pelos quais determinadas combinações não aparecem e se elas podem aparecer no futuro.
Quando os dados de série temporal são gravados, eles são classificados por tipos de métrica e de recurso monitorado. Para qualquer par de tipos de métrica e recurso, a cardinalidade total é o produto da cardinalidade da métrica e da cardinalidade do recurso. Se você tiver uma métrica com cardinalidade de 1.000 e um recurso com cardinalidade de 100, e se todos os valores de rótulo aparecerem, você terá 100.000 série temporal (1.000×100).