Tipi di valore e tipi di metriche

Nella discussione sul modello di metrica, la sezione Tipi di metriche fornisce una discussione generale sugli che descrivono un tipo di metrica. Questa sezione fornisce una discussione più dettagliata di due di questi attributi:

  • Tipo di valore
  • Tipo di metrica

Tipo di valore

Il tipo di valore è il tipo di dati per le misurazioni. Ogni serie temporale registra il tipo di valore (tipo ValueType) per i relativi punti dati.

  • Per misurazioni costituite da un singolo valore alla volta, come i valori booleani e Dati numerici, il tipo di valore indica in che modo vengono memorizzati i dati:

    • BOOL, un valore booleano
    • INT64, un numero intero a 64 bit
    • DOUBLE, un numero in virgola mobile a precisione doppia
    • STRING, una stringa

  • Per le misurazioni della distribuzione, il valore non è un singolo valore ma un gruppo di valori. Il tipo di valore per le misurazioni della distribuzione è DISTRIBUTION.

    Una distribuzione contiene statistiche che riepilogano un gruppo di valori. I valori di una distribuzione includono media, conteggio, max e altri statistiche, calcolate per un gruppo di valori. Una distribuzione può anche includere un istogramma che rappresenti la modalità di distribuzione dei valori un insieme di intervalli.

In genere, le metriche di latenza acquisiscono i dati come distribuzioni. Per ulteriori informazioni sulle distribuzioni, consulta la pagina di riferimento Distribution. Per informazioni su come creare un grafico di queste metriche, consulta Metriche di distribuzione.

Tipo di metrica

Ogni serie temporale include il tipo di metrica (tipo MetricKind) per i relativi punti dati. Il tipo di dati delle metriche indica come interpretare tra loro. Le metriche di Cloud Monitoring sono una delle tre tipi:

  • Una metrica indicatore, in cui il valore misura un istante specifico nel tempo. Ad esempio, le metriche che misurano l'utilizzo della CPU sono metriche di misurazione; ogni punto registra l'utilizzo della CPU al momento della misurazione. Un altro esempio di metrica indicatore è la temperatura attuale.

  • Una metrica delta, in cui il valore misura la variazione in un intervallo di tempo. Per le letture, l'intervallo di tempo è semiaperto, esclude l'ora di inizio, ma include l'ora di fine: (startTime, endTime]. Ad esempio, le metriche che misurano i conteggi delle richieste sono metriche delta, ogni valore registra quante richieste sono state ricevuto dopo l'ora di inizio, fino all'ora di fine inclusa.

  • Una metrica cumulativa in cui il valore aumenta costantemente nel tempo. Ad esempio, una metrica per "byte inviati" potrebbe essere cumulativa, ogni valore registra il numero totale di byte inviati da un servizio in quel momento.

Combinazioni supportate

Non tutte le combinazioni di tipo di metrica e tipo di valore hanno senso. Ad esempio, non viene mai visualizzata una metrica delta con dati booleani. Esistono alcune combinazioni che hanno senso insieme.

La tabella seguente elenca i tipi di metriche e i tipi di valore supportati:

Tipo di valore GAUGE DELTA CUMULATIVO4
BOOL sì no no
INT64 sì Sì1 sì
DOPPIO sì Sì1 sì
STRING Sì1 no no
DISTRIBUZIONE yes2 sì1, 3 sì

1 Questa combinazione non è consentita nelle metriche personalizzate, custom.googleapis.com.
2 Questa combinazione non è consentita per le metriche basate su log. Per ulteriori informazioni, vedi Configura metriche basate su log per il tipo di distribuzione.
3 Questa è l'unica combinazione consentita per le metriche basate su log, logging.googleapis.com/user, con il tipo di valore DISTRIBUTION. Per ulteriori informazioni, consulta il campo metricDescriptor nel riferimento dell'API Logging LogMetric.
4 Le metriche cumulative non possono essere utilizzate direttamente per la creazione di grafici o per gli avvisi in Monitoraggio, ma possono essere aggregate in metriche non cumulative che possono essere utilizzate in questi modi. Vedi Tipi, tipi e conversioni.

Inoltre, se crei le tue metriche, devi utilizzare solo combinazioni valide di tipi di valore e tipi di metrica.

Emulazione di metriche personalizzate con valori stringa

I valori di stringa nelle metriche personalizzate non sono supportati, ma puoi replicare la funzionalità delle metriche con valori di stringa nei seguenti modi:

  • Crea una metrica GAUGE utilizzando un valore INT64 come enum che viene mappato a un valore di stringa. Traduci esternamente l'enum in un valore di stringa quando esegui una query sulla metrica.
  • Crea una metrica GAUGE con un valore BOOL e un'etichetta il cui valore è una delle stringhe da monitorare. Utilizza il valore booleano per indicare se il valore è attivo.

Ad esempio, supponiamo che tu voglia creare una metrica con valori di stringa chiamata "stato" con le possibili opzioni OK, OFFLINE o IN ATTESA. Puoi creare una metrica GAUGE con un'etichetta chiamata status_value. Ogni aggiornamento scrive tre serie temporali, una per ogni status_value (OK, OFFLINE o PENDING), con un valore di 1 per "true" o 0 per "false".