Tipi di valore e tipi di metriche

Nella discussione del modello metrico, la sezione Tipi di metriche fornisce una discussione generale degli attributi 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 le misurazioni costituite da un singolo valore alla volta, come i valori booleani e i dati numerici, il tipo di valore indica come vengono archiviati i dati:

    • BOOL, un valore booleano
    • INT64, un numero intero a 64 bit
    • DOUBLE, un numero a 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 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 la distribuzione dei valori in un insieme di intervalli.

Le metriche sulla latenza in genere acquisiscono i dati sotto forma di distribuzioni. Per ulteriori informazioni sulle distribuzioni, consulta la pagina di riferimento Distribution. Per informazioni su come visualizzare queste metriche in un grafico, 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 a un altro. Le metriche di Cloud Monitoring sono di 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 indicatore. 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 il numero di 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 i "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 CUMULATIVE4
BOOL sì no no
INT64 sì yes1 sì
DOPPIO sì yes1 sì
STRING yes1 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, consulta Configurare le metriche basate su log di 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. Per saperne di più, consulta Tipi, livelli 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 di 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 mappa 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 valore stringa denominata "status" con le possibili opzioni OK, OFFLINE o PENDING. Potresti creare una metrica GAUGE con un'etichetta denominata 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".