Tipi di valori e di metriche

Per quanto riguarda il modello di metriche, la sezione Tipi di metriche fornisce una discussione generale sugli attributi che descrivono un tipo di metrica. Questa sezione fornisce una discussione più dettagliata su 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 le misurazioni composte da un solo valore alla volta, come valori booleani e dati numerici, il tipo di valore indica come vengono memorizzati i dati:

    • BOOL, un valore booleano
    • INT64, un numero intero a 64 bit
    • DOUBLE, un float 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 riassumono un gruppo di valori. I valori in una distribuzione includono media, conteggio, massimo e altre statistiche, calcolate per un gruppo di valori. Una distribuzione può anche includere un istogramma che rappresenta il modo in cui i valori sono distribuiti in un insieme di intervalli.

    Le metriche di latenza in genere acquisiscono i dati sotto forma di distribuzioni. Per saperne di più sulle distribuzioni, consulta la pagina di riferimento Distribution. Per informazioni su come rappresentare graficamente 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 i valori rispetto agli altri. Le metriche di Cloud Monitoring sono di tre tipi:

  • Una metrica gauge, in cui il valore misura un istante specifico nel tempo. Ad esempio, le metriche che misurano l'utilizzo della CPU sono metriche misurate; ogni punto registra l'utilizzo della CPU al momento della misurazione. Un altro esempio di metrica dell'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 il numero di richieste ricevute 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 in quel momento da un servizio.

Combinazioni supportate

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

Nella tabella seguente sono elencati i tipi di metriche e di valori supportati:

Tipo di valore CALIBRO DELTA CUMULATIVO4
BOOL sì no no
INT64 sì sì1 sì
DOPPIO sì sì1 sì
STRING sì1 no no
DISTRIBUZIONE sì2 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 maggiori informazioni, consulta Configurare le metriche basate su log del 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 LogMetric dell'API Logging.
4 Le metriche cumulative non possono essere utilizzate direttamente per creare grafici o avvisi in Monitoring, ma possono essere aggregate in metriche non cumulative che possono essere utilizzate in questi modi. Per ulteriori informazioni, consulta Tipi, tipi e conversioni.

Inoltre, se crei metriche personalizzate, devi utilizzare solo combinazioni valide di tipi di valori e tipi di metriche.

Emulazione di metriche personalizzate con valori stringa

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

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

Ad esempio, supponi di voler creare una metrica con valori stringa denominata "stato" con le possibili opzioni OK, OFFLINE o IN ATTESA. Potresti creare una metrica GAUGE con un'etichetta chiamata status_value. Ogni aggiornamento scriverà tre serie temporali, una per ogni status_value (OK, OFFLINE o IN ATTESA), con un valore pari a 1 per "true" o 0 per "false".