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 boleanoINT64
, um número inteiro de 64 bitsDOUBLE
, um ponto flutuante de dupla precisãoSTRING
, 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
. Para mais informações sobre os gráficos dessas métricas, consulte Gráficos de métricas de distribuição.
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.
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 | CUMULATIVE2 |
---|---|---|---|
BOOL | yes | não | no |
INT64 | yes | sim1 | yes |
DOUBLE | yes | sim1 | yes |
STRING | sim1 | no | no |
DISTRIBUTION | yes | sim1 | yes |
1 Essa combinação não é permitida em métricas personalizadas.
2 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.