Tipos de valor e tipos de métrica

Na discussão do modelo de métrica, a seção chamada Tipos de métricas fornece uma discussão geral dos atributos que descrevem um tipo de métrica. Esta seção fornece uma discussão mais detalhada de dois desses atributos:

• Tipo de valor
• Classe da métrica

Tipo de valor

O tipo de valor é o tipo de dados das medições. Cada série temporal registra o tipo de valor (tipo ValueType) dos pontos de dados.

• Para medições que consistem em um único valor por vez, como valores booleanos e dados numéricos, o tipo de valor informa como os dados são armazenados:

  • BOOL, um boleano
  • INT64, um número inteiro de 64 bits
  • DOUBLE, um ponto flutuante de dupla precisão
  • STRING, uma string

• Para medições de distribuição, o valor não é um único valor, mas um grupo de valores. O tipo de valor para medições de distribuição é DISTRIBUTION.

  Uma distribuição contém estatísticas que resumem um grupo de valores. Os valores em uma distribuição incluem a média, a contagem, o máximo e outras estatísticas, calculadas para um grupo de valores. Uma distribuição também pode incluir um histograma que representa como os valores são distribuídos em um conjunto de intervalos.

  As métricas de latência geralmente capturam dados como distribuições. Para mais informações sobre distribuições, consulte a página de referência Distribution.

Classe da métrica

Cada série temporal inclui o tipo de métrica (tipo MetricKind) dos pontos de dados. O tipo de dados de métrica informa como interpretar os valores em relação um ao outro. As métricas do Cloud Monitoring são de três tipos:

• Uma métrica de medidor, em que o valor mede um instante específico no tempo. Por exemplo, as métricas que medem a utilização da CPU são métricas de medidor. Cada ponto registra a utilização da CPU no momento da medição. Outro exemplo de métrica de medidor é a temperatura atual.

• Uma métrica delta, em que o valor mede a alteração desde que foi registrada pela última vez. Por exemplo, as métricas que medem contagens de solicitações são métricas delta. Cada valor registra quantas solicitações foram recebidas desde que o último ponto de dados foi registrado.

  Observação: todas as métricas que contam itens distintos durante um período são métricas delta e são avaliadas em um intervalo de um minuto. É razoável esperar que esses valores sejam inteiros, mas, por motivos históricos de implementação, eles são informados como números de ponto flutuante.

• Uma métrica cumulativa, na qual o valor aumenta constantemente ao longo do tempo. Por exemplo, uma métrica para "bytes enviados" pode ser cumulativa. Cada valor registra o número total de bytes enviados por um serviço naquele momento.

Combinações compatíveis

Nem todas as combinações de tipo de métrica e tipo de valor fazem sentido. Por exemplo, você nunca verá uma métrica delta com dados booleanos. Há algumas combinações que fazem sentido juntas.

A tabela a seguir lista os tipos de métricas e tipos de valor compatíveis:

Tipo de valor	MEDIDOR	DELTA	CUMULATIVE^2
BOOL	yes	não	no
INT64	yes	sim^1	yes
DOUBLE	yes	sim^1	yes
STRING	sim^1	no	no
DISTRIBUTION	yes	sim^1	yes

¹ Essa combinação não é permitida em métricas personalizadas.
² As métricas cumulativas não podem ser usadas diretamente para gráficos ou alertas no Monitoring, mas podem ser agregadas em métricas não cumulativas que podem ser usadas dessas maneiras. Consulte Tipos e conversões para mais informações.

Além disso, se você estiver criando suas próprias métricas, precisará usar apenas combinações válidas de tipos de valor e tipos de métricas.