Distribution

Distribution contiene statistiche riepilogative per una popolazione di valori. Contiene, facoltativamente, un istogramma che rappresenta la distribuzione di questi valori in un insieme di bucket.

Le statistiche riepilogative sono il conteggio, la media, la somma della deviazione quadratica dalla media, il minimo e il massimo dell'insieme di valori della popolazione. L'istogramma si basa su una sequenza di bucket e fornisce un conteggio dei valori che rientrano in ogni bucket. I limiti dei bucket sono forniti in modo esplicito o tramite formule per bucket di larghezza fissa o crescente in modo esponenziale.

Sebbene non sia vietato, in genere è una cattiva idea includere valori non finiti (infiniti o NaN) nella popolazione di valori, in quanto ciò renderà privi di significato i campi mean e sumOfSquaredDeviation.

Rappresentazione JSON 
{
  "count": string,
  "mean": number,
  "sumOfSquaredDeviation": number,
  "range": {
    object (Range)
  },
  "bucketOptions": {
    object (BucketOptions)
  },
  "bucketCounts": [
    string
  ],
  "exemplars": [
    {
      object (Exemplar)
    }
  ]
}
Campi
count

string (int64 format)

Il numero di valori nella popolazione. Non deve essere un valore negativo. Questo valore deve essere uguale alla somma dei valori in bucketCounts se viene fornito un istogramma.
mean

number

La media aritmetica dei valori nella popolazione. Se count è zero, questo campo deve essere zero.
sumOfSquaredDeviation

number

La somma degli scarti quadratici dalla media dei valori nella popolazione. Per i valori x_i, questo è:

Sum[i=1..n]((x_i - mean)^2)

Knuth, "The Art of Computer Programming", Vol. 2, pagina 232, terza edizione, descrive il metodo di Welford per accumulare questa somma in un'unica passata.

Se count è zero, questo campo deve essere zero.
range

object (Range)

Se specificato, contiene l'intervallo dei valori della popolazione. Il campo non deve essere presente se count è zero.
bucketOptions

object (BucketOptions)

Definisce i limiti dei bucket dell'istogramma. Se la distribuzione non contiene un istogramma, ometti questo campo.
bucketCounts[]

string (int64 format)

Il numero di valori in ogni bucket dell'istogramma, come descritto in bucketOptions. Se la distribuzione non ha un istogramma, ometti questo campo. Se è presente un istogramma, la somma dei valori in bucketCounts deve essere uguale al valore nel campo count della distribuzione.

Se presente, bucketCounts deve contenere N valori, dove N è il numero di bucket specificato in bucketOptions. Se fornisci meno di N valori, i valori rimanenti vengono considerati pari a 0.

L'ordine dei valori in bucketCounts segue gli schemi di numerazione dei bucket descritti per i tre tipi di bucket. Il primo valore deve essere il conteggio per il bucket di underflow (numero 0). I successivi N-2 valori sono i conteggi per i bucket finiti (da 1 a N-2). L'N-esimo valore in bucketCounts è il conteggio per il bucket di overflow (numero N-1).
exemplars[]

object (Exemplar)

Deve essere in ordine crescente del campo value.

Intervallo

L'intervallo dei valori della popolazione.

Rappresentazione JSON 
{
  "min": number,
  "max": number
}
Campi
min

number

Il valore minimo della popolazione.
max

number

Il valore massimo della popolazione.

BucketOptions

BucketOptions descrive i limiti dei bucket utilizzati per creare un istogramma per la distribuzione. I bucket possono essere in una sequenza lineare, in una sequenza esponenziale oppure ogni bucket può essere specificato in modo esplicito. BucketOptions non include il numero di valori in ogni bucket.

Un bucket ha un limite inferiore inclusivo e un limite superiore esclusivo per i valori conteggiati per quel bucket. Il limite superiore di un bucket deve essere strettamente maggiore del limite inferiore. La sequenza di N bucket per una distribuzione è costituita da un bucket di underflow (numero 0), da zero o più bucket finiti (numero da 1 a N - 2) e da un bucket di overflow (numero N - 1). I bucket sono contigui: il limite inferiore del bucket i (i > 0) è uguale al limite superiore del bucket i - 1. I bucket coprono l'intero intervallo di valori finiti: il limite inferiore del bucket di underflow è -infinito e il limite superiore del bucket di overflow è +infinito. I bucket finiti sono chiamati così perché entrambi i limiti sono finiti.

Rappresentazione JSON 
{

  // Union field options can be only one of the following:
  "linearBuckets": {
    object (Linear)
  },
  "exponentialBuckets": {
    object (Exponential)
  },
  "explicitBuckets": {
    object (Explicit)
  }
  // End of list of possible types for union field options.
}
Campi
Campo unione options. Deve essere impostato esattamente uno di questi tre campi. options può essere solo uno dei seguenti tipi:
linearBuckets

object (Linear)

Il bucket lineare.
exponentialBuckets

object (Exponential)

I bucket esponenziali.
explicitBuckets

object (Explicit)

I bucket espliciti.

Lineare

Specifica una sequenza lineare di bucket che hanno tutti la stessa larghezza (tranne overflow e underflow). Ogni bucket rappresenta un'incertezza assoluta costante sul valore specifico nel bucket.

Esistono numFiniteBuckets + 2 (= N) bucket. Il bucket i ha i seguenti limiti:

Limite superiore (0 <= i < N-1): offset + (larghezza * i).

Limite inferiore (1 <= i < N): offset + (larghezza * (i - 1)).

Rappresentazione JSON 
{
  "numFiniteBuckets": integer,
  "width": number,
  "offset": number
}
Campi
numFiniteBuckets

integer

Deve essere maggiore di 0.
width

number

Deve essere maggiore di 0.
offset

number

Limite inferiore del primo bucket.

Esponenziale

Specifica una sequenza esponenziale di bucket con una larghezza proporzionale al valore del limite inferiore. Ogni bucket rappresenta un'incertezza relativa costante su un valore specifico nel bucket.

Esistono numFiniteBuckets + 2 (= N) bucket. Il bucket i ha i seguenti limiti:

Limite superiore (0 <= i < N-1): scale * (growthFactor ^ i).

Limite inferiore (1 <= i < N): scala * (growthFactor ^ (i - 1)).

Rappresentazione JSON 
{
  "numFiniteBuckets": integer,
  "growthFactor": number,
  "scale": number
}
Campi
numFiniteBuckets

integer

Deve essere maggiore di 0.
growthFactor

number

Deve essere superiore a 1.
scale

number

Deve essere maggiore di 0.

Esplicita

Specifica un insieme di bucket con larghezze arbitrarie.

Esistono size(bounds) + 1 (= N) bucket. Il bucket i ha i seguenti limiti:

Limite superiore (0 <= i < N-1): bounds[i] Limite inferiore (1 <= i < N); bounds[i - 1]

Il campo bounds deve contenere almeno un elemento. Se bounds ha un solo elemento, non esistono bucket finiti e l'unico elemento è il limite comune dei bucket di overflow e underflow.

Rappresentazione JSON 
{
  "bounds": [
    number
  ]
}
Campi
bounds[]

number

I valori devono essere monotonicamente crescenti.

Esemplare

Gli esemplari sono punti di esempio che possono essere utilizzati per annotare i valori di distribuzione aggregati. Si tratta di metadati che forniscono informazioni su un determinato valore aggiunto a un bucket di distribuzione, ad esempio un ID traccia attivo quando è stato aggiunto un valore. Possono contenere ulteriori informazioni, come valori ed timestamp di esempio, origine e così via.

Rappresentazione JSON 
{
  "value": number,
  "timestamp": string,
  "attachments": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campi
value

number

Valore del punto esemplare. Questo valore determina a quale bucket appartiene l'esemplare.
timestamp

string (Timestamp format)

L'ora di osservazione (campionamento) del valore precedente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
attachments[]

object

Informazioni contestuali sul valore di esempio. Alcuni esempi:

Trace: type.googleapis.com/google.monitoring.v3.SpanContext

Stringa letterale: type.googleapis.com/google.protobuf.StringValue

Etichette eliminate durante l'aggregazione: type.googleapis.com/google.monitoring.v3.DroppedLabels

In un singolo esempio può essere presente un solo allegato di un determinato tipo di messaggio e questo viene applicato dal sistema.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contenente un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.