Informazioni sulle metriche basate sulla distribuzione

Le metriche con valori di distribuzione in Cloud Monitoring ti consentono di analizzare la distribuzione statistica di grandi volumi di misurazioni, ad esempio le latenze delle risposte HTTP, quando la raccolta di ogni singolo punto dati non è fattibile. Anziché registrare i valori grezzi, una Distribution metrica raggruppa le misurazioni in intervalli di valori chiamati bucket per formare un istogramma su ogni intervallo di campionamento. Puoi visualizzare queste metriche come mappe termiche o aggregarle in percentili e medie su grafici a linee e a barre.

Come funzionano le metriche di distribuzione

Per illustrare come viene creato un istogramma, considera un servizio che misura la latenza HTTP delle richieste e che riporta questi dati utilizzando una metrica con un tipo di valore di distribuzione. I dati vengono riportati ogni minuto. Il servizio definisce intervalli di valori per la metrica, chiamati bucket, e registra il conteggio dei valori misurati che rientrano in ogni bucket. Ad esempio, quando una richiesta HTTP viene completata, il servizio incrementa il conteggio nel bucket il cui intervallo include il valore di latenza della richiesta. Questi conteggi creano un istogramma dei valori per quel minuto.

Supponiamo che le latenze misurate in un intervallo di un minuto siano 5, 1, 3, 5, 6, 10 e 14. Se i bucket sono [0, 4), [4, 8), [8, 12) e [12, 16), l'istogramma di questi dati è [2, 3, 1, 1]. La tabella seguente mostra in che modo le singole misurazioni influiscono sul conteggio di ogni bucket:

Bucket Misure di latenza Numero di valori nel bucket
[12,16) 14 1
[8,12) 10 1
[4,8) 5, 5, 6 3
[0,4) 1, 3 2

Quando questi dati vengono scritti nella serie temporale, viene creato un Point oggetto. Per le metriche con un valore di distribuzione, questo oggetto include l'istogramma dei valori. Per questo periodo di campionamento, Point contiene [2, 3, 1, 1]. Le singole misurazioni non vengono scritte nella serie temporale.

Supponiamo che la tabella precedente registri l'istogramma per i dati di latenza misurati alle 13:00. Questa tabella illustra come prendere una serie di misurazioni e convertirle in conteggi di bucket. Supponiamo che i conteggi dei bucket alle 13:01, 13:02 e 13:03 siano quelli mostrati nella tabella seguente:

Bucket Istogramma per
13:00		 Istogramma per
13:01		 Istogramma per
13:02		 Istogramma per
13:03
[12,16) 1 6 0 1
[8,12) 1 0 2 2
[4,8) 3 1 1 8
[0,4) 2 6 10 3

La tabella precedente mostra una sequenza di istogrammi indicizzati per ora. Ogni colonna della tabella rappresenta i dati di latenza per un periodo di un minuto. Per ottenere il numero di misurazioni in un momento specifico, somma i conteggi dei bucket. Tuttavia, le misurazioni effettive non vengono mostrate perché non sono disponibili nelle metriche con valori di distribuzione.

Grafici mappa termica

I grafici mappa termica sono progettati per visualizzare una singola serie temporale con valori di distribuzione. Per questi grafici, l'asse X rappresenta il tempo, l'asse Y rappresenta i bucket e il colore rappresenta il valore. I colori più chiari indicano valori più alti. Ad esempio, le aree scure della mappa termica indicano conteggi di bucket inferiori rispetto alle aree gialle o bianche.

La figura seguente è una rappresentazione di una mappa termica per l'esempio precedente:

Grafico mappa termica per l'esempio.

Nella figura precedente, la mappa termica utilizza il nero per rappresentare il conteggio dei bucket più piccolo, 0, e il giallo per rappresentare il conteggio dei bucket più grande, 10. I rossi e gli arancioni rappresentano i valori compresi tra questi due estremi.

Poiché i grafici mappa termica possono visualizzare una sola serie temporale, devi impostare le opzioni di aggregazione per combinare tutte le serie temporali.

Per utilizzare Metrics Explorer per visualizzare la somma delle latenze RTT di un'istanza VM:

  1. Nella Google Cloud console, vai alla  Esplora metriche pagina:

    Vai a Esplora metriche

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
  3. Nell'elemento Metrica, espandi il menu Seleziona una metrica, digita RTT latencies nella barra dei filtri e poi utilizza i sottomenu per selezionare un tipo di risorsa e una metrica specifici:
    1. Nel menu Risorse attive, seleziona Istanza VM.
    2. Nel menu Categorie di metriche attive, seleziona Vm_flow.
    3. Nel menu Metriche attive, seleziona RTT latencies.
    4. Fai clic su Applica.

  4. Per aggiungere filtri, che rimuovono le serie temporali dai risultati della query, utilizza l' elemento Filtro.

Grafici a linee e a barre

I grafici a linee, i grafici a barre in pila e i grafici a linee in pila, progettati per visualizzare i dati scalari, non possono visualizzare i valori di distribuzione. Per visualizzare una metrica con un valore di distribuzione con uno di questi tipi di grafici, devi convertire i valori dell'istogramma in valori scalari. Ad esempio, puoi impostare le opzioni di aggregazione per calcolare la media dei valori nell'istogramma o per calcolare un percentile.

Per informazioni su come visualizzare una metrica con valori di distribuzione in un grafico a linee, consulta la sezione seguente.

Metriche di aggregazione e distribuzione

L'aggregazione è il processo di regolarizzazione dei punti all'interno di una serie temporale e di combinazione di più serie temporali. L'aggregazione è la stessa per le metriche con valori di distribuzione e per le metriche con un tipo di valore intero o doppio. Tuttavia, il tipo di grafico applica alcuni requisiti alle scelte utilizzate per l'allineamento e il raggruppamento delle serie temporali.

Grafici mappa termica

I grafici mappa termica mostrano una serie temporale con valori di distribuzione. Pertanto, la funzione di allineamento e funzione di raggruppamento devono essere impostate per creare una singola serie temporale.

Seleziona una funzione di allineamento sum o delta quando un grafico mostra una mappa termica. Queste funzioni combinano, a livello di bucket, tutti i campioni di una singola serie temporale che si trovano nello stesso periodo di allineamento e il risultato è un valore di distribuzione. Ad esempio, se due campioni adiacenti di una serie temporale sono [2, 3, 1, 1] e [2, 5, 4, 1], la funzione di allineamento della somma produce [4, 8, 5, 2].

La funzione di raggruppamento definisce come vengono combinate le diverse serie temporali. Questa funzione a volte viene chiamata aggregatore o riduttore. Per le mappe termiche, imposta la funzione di raggruppamento sulla funzione sum. La funzione di somma aggiunge i valori degli stessi bucket in tutti gli istogrammi, generando un nuovo istogramma. Ad esempio, la somma del valore [2, 3, 1, 1] della serie temporale A e del valore [1, 5, 2, 2] della serie temporale B è [3, 8, 3, 3].

Grafici a linee

I grafici a linee mostrano solo serie temporali con valori scalari. Se selezioni una metrica con valori di distribuzione, il grafico viene configurato con parametri ottimali per visualizzare una mappa termica. I campi dell'elemento Aggregazione sono impostati su Distribuzione e Nessuna.

  • L'interpretazione di Distribuzione dipende dalla metrica specifica. Per i tipi di metriche con valori di distribuzione che hanno un tipo di metrica GAUGE, la funzione di allineamento predefinita è impostata su sum. Quando un tipo di metrica con valori di distribuzione ha un tipo di metrica CUMULATIVE, la funzione di allineamento predefinita è DELTA.

  • L'impostazione Nessuna garantisce che tutte le serie temporali vengano combinate.

Se vuoi visualizzare una metrica con valori di distribuzione in un grafico a linee, devi modificare le impostazioni predefinite del grafico. Ad esempio, per configurare un grafico a linee in una dashboard in modo che visualizzi il 99° percentile di ogni serie temporale per una metrica con valori di distribuzione:

  1. Nella Google Cloud console, vai alla pagina  Dashboard:

    Vai a Dashboard

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
  3. Nella barra degli strumenti, fai clic su  Aggiungi widget.
  4. Nella finestra di dialogo Aggiungi widget, seleziona  Metrica.
  5. Nell'elemento Metrica, seleziona la metrica Istanza VM - Latenze RTT.
  6. Nell'elemento Aggregazione, espandi il primo menu e seleziona 99° percentile.
  7. Nel riquadro Visualizzazione, imposta il valore del menu Tipo di widget su Grafico a linee.
  8. (Facoltativo) Nell'elemento Aggregazione, espandi il secondo menu e seleziona le etichette utilizzate per raggruppare le serie temporali. Per impostazione predefinita, non sono selezionate etichette e pertanto nel grafico viene visualizzata una sola linea.

Passaggi successivi

Per informazioni su come determinare il modello di bucket per una metrica e su come interpretare i percentili, consulta Percentili e metriche con valori di distribuzione.