Tipos de valor e tipos de métrica

Cada métrica no Cloud Monitoring tem um tipo de valor e um tipo de métrica que definem o formato de dados de cada ponto e como os pontos consecutivos se relacionam ao longo do tempo. Entender esses dois atributos ajuda a interpretar métricas integradas, agregar série temporal com precisão e escolher combinações válidas ao projetar métricas personalizadas. Para uma visão geral de todos os atributos de tipo de métrica, consulte Tipos de métricas.

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 normalmente 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. Esse campo informa como interpretar os valores dos pontos de dados em relação uns aos outros:

• 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 é a temperatura atual.

• Uma métrica delta, em que o valor mede a alteração em um intervalo de tempo. Para leituras, o intervalo de tempo é semiaberto: ele exclui o horário de início, mas inclui o horário de término, (startTime, endTime]. Por exemplo, as que medem contagens de solicitações são métricas delta. Cada valor registra quantas solicitações foram recebidas após o horário de início e até o horário de término (inclusive).

  Observação :todas as métricas que contam itens discretos em um intervalo de tempo são métricas delta. É razoável esperar que esses valores sejam números inteiros, mas, por motivos de implementação histórica, 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.