Distribution
contiene estadísticas de resumen de una población de valores. De forma opcional, contiene un histograma que representa la distribución de esos valores en un conjunto de buckets.
Las estadísticas de resumen son el recuento, la media, la suma de la desviación al cuadrado de la media, el mínimo y el máximo del conjunto de valores de la población. El histograma se basa en una secuencia de buckets y proporciona un recuento de los valores que corresponden a cada bucket. Los límites de los buckets se proporcionan de forma explícita o mediante fórmulas para los buckets de anchos fijos o que aumentan exponencialmente.
Aunque no está prohibido, por lo general, es una mala idea incluir valores no finitos (infinitos o NaN) en la población de valores, ya que esto hará que los campos mean
y sumOfSquaredDeviation
no tengan sentido.
Representación JSON |
---|
{ "count": string, "mean": number, "sumOfSquaredDeviation": number, "range": { object ( |
Campos | |
---|---|
count |
La cantidad de valores en la población. Must be non-negative (La precisión de las coordenadas de latitud y longitud, en metros. No debe ser un valor negativo). Este valor debe ser igual a la suma de los valores en |
mean |
La media aritmética de los valores en la población. Si |
sumOfSquaredDeviation |
La suma de las desviaciones al cuadrado de la media de los valores en la población. Para los valores x_i, es lo siguiente:
Knuth, “El arte de la programación informática”, Vol. 2, página 232, tercera edición, se describe el método de Welford para acumular esta suma en un pase. Si |
range |
Si se especifica, contiene el rango de los valores de la población. El campo no debe estar presente si |
bucketOptions |
Define los límites del bucket del histograma. Si la distribución no contiene un histograma, omite este campo. |
bucketCounts[] |
La cantidad de valores en cada bucket del histograma, como se describe en Si está presente, El orden de los valores en |
exemplars[] |
Debe estar en orden creciente del campo |
Rango
El rango de los valores de la población.
Representación JSON |
---|
{ "min": number, "max": number } |
Campos | |
---|---|
min |
El mínimo de los valores de la población. |
max |
El máximo de los valores de la población. |
BucketOptions
BucketOptions
describe los límites del bucket que se usan a fin de crear un histograma para la distribución. Los buckets pueden estar en una secuencia lineal o exponencial o cada bucket se puede especificar de manera explícita. BucketOptions
no incluye la cantidad de valores en cada bucket.
Un bucket tiene un límite inferior inclusivo y un límite superior exclusivo para los valores que se cuentan en ese bucket. El límite superior de un bucket debe ser estrictamente mayor que el límite inferior. La secuencia de N buckets para una distribución consiste en un bucket de subdesbordamiento (número 0), cero o más buckets finitos (número 1 a N - 2) y un bucket de desbordamiento (número N - 1). Los buckets son contiguos: el límite inferior del bucket i (i > 0) es el mismo que el límite superior del bucket i - 1. Los buckets abarcan todo el rango de valores finitos: el límite inferior del bucket de subdesbordamiento es -infinito y el límite superior del bucket de desbordamiento es +infinito. Los buckets finitos se denominan de esa forma porque ambos límites son finitos.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión options . Se debe establecer exactamente uno de estos tres campos. options puede ser solo uno de los siguientes: |
|
linearBuckets |
El bucket lineal. |
exponentialBuckets |
Los buckets exponenciales. |
explicitBuckets |
Los buckets explícitos. |
Lineal
Especifica una secuencia lineal de buckets que tienen el mismo ancho (excepto desbordamiento y subdesbordamiento). Cada bucket representa una incertidumbre absoluta constante sobre el valor específico del bucket.
Hay numFiniteBuckets + 2
(= N) buckets. El bucket i
tiene los siguientes límites:
Límite superior (0 <= i < N-1): desplazamiento + (ancho * i).
Límite inferior (1 <= i < N): desplazamiento + (ancho * (i - 1)).
Representación JSON |
---|
{ "numFiniteBuckets": integer, "width": number, "offset": number } |
Campos | |
---|---|
numFiniteBuckets |
Debe ser mayor que 0. |
width |
Debe ser mayor que 0. |
offset |
Límite inferior del primer bucket. |
Exponencial
Especifica una secuencia exponencial de buckets con un ancho que es proporcional al valor del límite inferior. Cada bucket representa una incertidumbre relativa constante de un valor específico en el bucket.
Hay numFiniteBuckets + 2
(= N) buckets. El bucket i
tiene los siguientes límites:
Límite superior (0 <= i < N-1): escala * (growthFactor ^ i).
Límite inferior (1 <= i < N): escala * (growthFactor ^ (i - 1)).
Representación JSON |
---|
{ "numFiniteBuckets": integer, "growthFactor": number, "scale": number } |
Campos | |
---|---|
numFiniteBuckets |
Debe ser mayor que 0. |
growthFactor |
Debe ser mayor que 1. |
scale |
Debe ser mayor que 0. |
Explícito
Especifica un conjunto de buckets con anchos arbitrarios.
Hay size(bounds) + 1
(= N) buckets. El bucket i
tiene los siguientes límites:
Límite superior (0 <= i < N-1): límites[i] Límite inferior (1 <= i < N); límites[i - 1]
El campo bounds
debe contener al menos un elemento. Si bounds
tiene solo un elemento, no hay buckets finitos y ese único elemento es el límite común de los buckets de desbordamiento y subdesbordamiento.
Representación JSON |
---|
{ "bounds": [ number ] } |
Campos | |
---|---|
bounds[] |
Los valores deben aumentar de forma monótona. |
Ejemplar
Los ejemplares son puntos de ejemplo que se pueden usar para anotar valores de distribución agregados. Son metadatos que proporcionan información sobre un valor específico agregado a un bucket de distribución, como un ID de seguimiento que estuvo activo cuando se agregó un valor. Pueden contener más información, como valores de ejemplo y marcas de tiempo, origen, etcétera.
Representación JSON |
---|
{ "value": number, "timestamp": string, "attachments": [ { "@type": string, field1: ..., ... } ] } |
Campos | |
---|---|
value |
Valor del punto ejemplar. Este valor determina a qué bucket pertenece el ejemplo. |
timestamp |
El tiempo de observación (muestreo) del valor anterior. |
attachments[] |
Información contextual sobre el valor del ejemplo. Por ejemplo: Trace: type.googleapis.com/google.monitoring.v3.SpanContext Cadena literal: type.googleapis.com/google.protobuf.StringValue Etiquetas descartadas durante la agregación: type.googleapis.com/google.monitoring.v3.DroppedLabels Es posible que haya solo un archivo adjunto de un tipo de mensaje dado en un solo ejemplar, y el sistema lo aplicará de manera forzosa. |