Tipos de valores y tipos de métricas

En la sección sobre el modelo de métricas, Tipos de métricas se ofrece una descripción general de los atributos que describen un tipo de métrica. En esta sección se ofrece una explicación más detallada de dos de esos atributos:

• Tipo de valor
• Tipo de métrica

Tipo de valor

El tipo de valor es el tipo de datos de las mediciones. Cada serie temporal registra el tipo de valor (tipo ValueType) de sus puntos de datos.

• En el caso de las mediciones que constan de un solo valor a la vez, como los valores booleanos y los datos numéricos, el tipo de valor indica cómo se almacenan los datos:

  • BOOL, un valor booleano
  • INT64, un entero de 64 bits
  • DOUBLE, un número de coma flotante de doble precisión
  • STRING, una cadena

• En las mediciones de distribución, el valor no es un valor único, sino un grupo de valores. El tipo de valor de las mediciones de distribución es DISTRIBUTION.

  Una distribución contiene estadísticas que resumen un grupo de valores. Los valores de una distribución incluyen la media, el recuento, el máximo y otras estadísticas calculadas para un grupo de valores. Una distribución también puede incluir un histograma que represente cómo se distribuyen los valores en un conjunto de intervalos.

Las métricas de latencia suelen registrar los datos como distribuciones. Para obtener más información sobre las distribuciones, consulta la página de referencia de Distribution. Para obtener información sobre cómo representar estas métricas en gráficos, consulte Métricas de distribución.

Tipo de métrica

Cada serie temporal incluye el tipo de métrica (tipo MetricKind) de sus datos. El tipo de datos de métricas indica cómo interpretar los valores entre sí. Las métricas de Cloud Monitoring son de uno de estos tres tipos:

• Una métrica de indicador, en la que el valor mide un instante específico. Por ejemplo, las métricas que miden el uso de la CPU son métricas de tipo Gauge, ya que cada punto registra el uso de la CPU en el momento de la medición. Otro ejemplo de métrica de tipo Gauge es la temperatura actual.

• Una métrica delta, en la que el valor mide el cambio en un intervalo de tiempo. En el caso de las lecturas, el intervalo de tiempo es semiabierto, es decir, excluye la hora de inicio, pero incluye la hora de finalización: (startTime, endTime]. Por ejemplo, las métricas que miden el número de solicitudes son métricas delta. Cada valor registra cuántas solicitudes se han recibido después de la hora de inicio, hasta la hora de finalización (incluida).

  Nota: Todas las métricas que cuentan elementos discretos en un intervalo de tiempo son métricas delta. Es lógico que estos valores sean números enteros, pero, por motivos históricos de implementación, se registran como números de coma flotante.

• Una métrica acumulativa, en la que el valor aumenta constantemente a lo largo del tiempo. Por ejemplo, una métrica de "bytes enviados" puede ser acumulativa: cada valor registra el número total de bytes enviados por un servicio en ese momento.

Combinaciones admitidas

No todas las combinaciones de tipo de métrica y tipo de valor tienen sentido. Por ejemplo, nunca verá una métrica delta con datos booleanos. Hay ciertas combinaciones que tienen sentido juntas.

En la siguiente tabla se enumeran los tipos de métricas y de valores admitidos:

Tipo de valor	GAUGE	DELTA	ACUMULATIVO^4
BOOL	yes	no	no
INT64	yes	sí^1	yes
DOUBLE	yes	sí^1	yes
STRING	sí^1	no	no
DISTRIBUCIÓN	Sí^2	Sí^1, 3	yes

¹ Esta combinación no se permite en las métricas personalizadas, custom.googleapis.com.
² Esta combinación no está permitida en las métricas basadas en registros. Para obtener más información, consulta el artículo sobre cómo configurar métricas basadas en registros de tipo de distribución.
³ Esta es la única combinación permitida para las métricas basadas en registros, logging.googleapis.com/user, con el tipo de valor DISTRIBUTION. Para obtener más información, consulta el campo metricDescriptor en la referencia de la API Logging LogMetric.
⁴ Las métricas acumulativas no se pueden usar directamente para crear gráficos o alertas en Monitoring, pero se pueden agregar en métricas no acumulativas que sí se pueden usar de estas formas. Consulta más información sobre los tipos, las clases y las conversiones.

Además, si crea sus propias métricas, solo puede usar combinaciones válidas de tipos de valor y tipos de métrica.

Emular métricas personalizadas con valores de cadena

No se admiten valores de cadena en las métricas personalizadas, pero puede replicar la funcionalidad de las métricas con valores de cadena de las siguientes formas:

• Crea una métrica GAUGE con un valor INT64 como enumeración que se asigna a un valor de cadena. Traduce externamente el enum a un valor de cadena cuando consultes la métrica.
• Crea una métrica GAUGE con un valor BOOL y una etiqueta cuyo valor sea una de las cadenas que quieras monitorizar. Usa el valor booleano para indicar si el valor es el valor activo.

Por ejemplo, supongamos que quiere crear una métrica con valores de cadena llamada "status" (estado) con las opciones OK, OFFLINE o PENDING. Puedes crear una métrica GAUGE con una etiqueta llamada status_value. Cada actualización escribiría tres series temporales, una por cada status_value (OK, OFFLINE o PENDING), con un valor de 1 para "true" o 0 para "false".