Componenti del modello di metrica

Il modello di Cloud Monitoring per il monitoraggio dei dati è composto da tre principali di base:

  • Tipi di risorse monitorate
  • Tipi di metriche
  • Serie temporale

Il documento Il modello di metrica descrive questi aspetti Concetti di Cloud Monitoring in termini generali. Se questi concetti sono nuovi te, leggi prima questa pagina.

Questa pagina descrive i tipi di metriche, le risorse monitorate e il tempo di Google Cloud, insieme ad alcuni concetti correlati, in modo più dettagliato. Questi sono alla base di tutte le metriche di Monitoring.

Dovresti comprendere le informazioni in questa pagina se vuoi eseguire una delle seguenti:

Per maggiori dettagli su questi concetti e su come vengono mappati all'API Cloud Monitoring, consulta l'articolo Struttura delle serie temporali, in particolare se intendi utilizzare l'API Monitoring o le metriche personalizzate.

Informazioni sulle etichette

I tipi di risorse e metriche monitorate supportano entrambi le etichette, che consentono dati da classificare durante l'analisi. Ad esempio:

  • Un tipo di risorsa monitorata per una macchina virtuale potrebbe includere etichette per la posizione della macchina e l'ID progetto associato alla macchina. Quando vengono registrate informazioni sulla risorsa monitorata, include i valori delle etichette. Una risorsa monitorata può anche avere metadati forniti dal sistema o dall'utente etichette, oltre a quelle definite per il tipo di risorsa monitorata.
  • Un tipo di metrica che conteggia le richieste API potrebbe avere etichette per registrare il nome del metodo richiamato e dello stato della richiesta.

L'utilizzo delle etichette è discusso più in dettaglio nella sezione Etichette.

Tipi di risorse monitorate

Una risorsa monitorata è una risorsa da cui vengono acquisiti i dati delle metriche. Cloud Monitoring supporta circa 270 tipi di risorse monitorate.

I tipi di risorse monitorate includono nodi e attività generici, in Google Kubernetes Engine, tabelle in Bigtable, varie risorse AWS, e molto altro ancora.

Ogni tipo di risorsa monitorata è descritta formalmente in una struttura di dati chiamato descrittore di risorse monitorate. Per ulteriori informazioni, vedi Descrittori delle risorse monitorati.

A ogni tipo di risorsa monitorata supportata è presente una voce nel Elenco delle risorse monitorate: Le voci nell'elenco vengono create dai descrittori delle risorse monitorate. In questa sezione vengono descritte le informazioni acquisita in un descrittore di risorse monitorate e mostra come dall'elenco.

Un tipo di risorsa monitorata di esempio

Nell'immagine seguente viene mostrata la voce nell'elenco per in un bucket Cloud Storage:

Elenco per il bucket Cloud Storage.

Tutte le voci dell'elenco includono le seguenti informazioni:

  • Type (Tipo): l'intestazione nella voce elenca il tipo di risorsa-monitorata; gcs_bucket nell'esempio.
  • Nome visualizzato: una breve descrizione della risorsa monitorata.
  • Descrizione: una descrizione più lunga della risorsa monitorata.
  • Etichette: un insieme di dimensioni per la classificazione dei dati. Per ulteriori informazioni, consulta Etichette.

Tipi di metriche

Un tipo di metrica descrive le misurazioni che possono essere raccolte da un ambiente risorsa. Un tipo di metrica include una descrizione di ciò che viene misurato e il modo in cui le misurazioni vengono interpretate. Cloud Monitoring supporta circa 6500 tipi di metriche e consente di definire nuovi tipi.

I tipi di metriche includono conteggio delle chiamate API, statistiche sull'utilizzo del disco, spazio di archiviazione consumo e molto altro.

Ogni tipo di metrica è descritto formalmente in una struttura di dati chiamata descrittore della metrica. Per ulteriori informazioni, vedi Descrittori delle metriche.

Ogni tipo di metrica integrata ha una voce nel Elenco delle metriche pagine. Le voci in queste tabelle vengono create dai descrittori delle metriche. Questa sezione descrive le informazioni acquisite in un tipo di metrica e illustra come presentarla sotto forma di materiale di riferimento.

Un tipo di metrica di esempio

L'immagine seguente mostra una voce per un tipo di metrica Cloud Storage:

Un estratto dell'elenco delle metriche per Cloud Storage.

I tipi di metrica vengono visualizzati in una tabella, mentre l'intestazione della tabella spiega il layout delle informazioni. Questa sezione utilizza una voce come esempio, ma tutte le tabelle usano lo stesso formato.

La voce di tabella Cloud Storage di esempio fornisce quanto segue informazioni su un tipo di metrica:

  • Tipo di metrica: un identificatore per il tipo di metrica, storage.googleapis.com/api/request_count nell'esempio.

    Il prefisso storage.googleapis.com funge da spazio dei nomi per di archiviazione ideale in Cloud Storage. Tutti i tipi di metriche associati a una determinata il tipo di risorsa monitorata utilizza lo stesso spazio dei nomi.

    Gli spazi dei nomi vengono omessi dalle voci nelle tabelle.

    Sono elencati tutti i tipi di metriche associati a Cloud Storage nella tabella delle metriche di Cloud Storage.

  • Fase di avvio: un blocco colorato che indica la fase di avvio. del tipo di metrica con un valore come Alfa, Beta e GA.

  • Nome visualizzato: una breve stringa che descrive il tipo di metrica. "Conteggio richieste" nell'esempio.

  • Kind, Type, Unit (Tipo, Tipo, Unità): questa riga fornisce informazioni per l'interpretazione i valori dei dati: l'esempio mostra una metrica delta registrata come Numero intero a 64 bit senza unità (valore 1).

    • Tipo: questo esempio è una metrica delta, che registra una variazione rispetto a una un periodo di tempo. In altre parole, ogni punto dati registra il numero di chiamate API è stato scritto il punto dati precedente. Per ulteriori informazioni sui tipi, consulta Tipi di valore e metriche.

    • Tipo: in questo esempio i valori vengono registrati come numeri interi a 64 bit. Per ulteriori informazioni consulta la sezione Tipi di valore e metriche.

    • Unità: questa metrica non ha bisogno di un'unità esplicita perché rappresenta una conteggio; la cifra 1 viene utilizzata per indicare che non è necessaria alcuna unità.

  • Risorse monitorate: le risorse monitorate per le quali questa metrica è disponibile. I valori qui sono gli stessi di quelli descritti in Tipi di risorse monitorate.

  • Descrizione: informazioni più dettagliate su cosa viene registrato e come. Impostalo in corsivo per distinguerlo dalle etichette.

  • Etichette: un insieme di dimensioni per la classificazione dei dati. Per ulteriori informazioni, consulta Etichette.

Quando accedi ai dati di monitoraggio tramite l'API Cloud Monitoring, includi a un progetto Google Cloud nella chiamata API. Puoi recuperare solo i dati visibile al progetto Google Cloud. Ad esempio, se richiedi i dati del progetto per il tipo di metrica storage.googleapis.com/api/request_count, vedrai il conteggio delle API solo per i bucket Cloud Storage del tuo progetto. Se il progetto non utilizza bucket Cloud Storage, non esistono metriche vengono restituiti i dati.

Tipi di metriche integrate

I tipi di metriche integrate sono definiti dai servizi Google Cloud, tra cui e configurazione in Cloud Monitoring. Questi tipi di metriche descrivono misurazioni standard per un'ampia gamma di fattori comuni e disponibili per l'uso da parte di chiunque.

L'elenco delle metriche mostra l'intero insieme di tipi di metriche integrati. Le metriche elencate nella pagina Elenco delle metriche esterne sono speciali un sottoinsieme di metriche integrate definite da Cloud Monitoring partnership con progetti open source o provider di terze parti. In genere, le metriche hanno il prefisso external.googleapis.com.

Metriche personalizzate

Quando crei la tua applicazione, potresti avere determinate proprietà misurare gli elementi per i quali non esistono metriche integrate e configurazione in Cloud Monitoring. Con Cloud Monitoring puoi definire o importare tipi di metriche da origini esterne. Questi tipi di metriche sono chiamate metriche personalizzate. Se una metrica ha il prefisso custom.googleapis.com o prometheus.googleapis.com, allora è una metrica personalizzata. Queste ultime metriche in genere provengono da Google Cloud Managed Service per Prometheus.

Ad esempio, se desideri monitorare il numero di widget venduti, dai tuoi negozi, devi utilizzare una metrica personalizzata. Per saperne di più, consulta Panoramica delle metriche definite dall'utente.

Etichette

Un'etichetta è una coppia chiave-valore che può essere utilizzata per fornire informazioni un valore dati.

Etichette delle metriche e delle risorse monitorate

Le definizioni dei tipi di metriche e di risorse monitorate includono le etichette. Le etichette sono classificatori per i dati che vengono raccolti; aiutano a per classificare i dati per un'analisi più approfondita. Ad esempio:

  • Il tipo di metrica Cloud Storage storage.googleapis.com/api/request_count ha due etichette, response_code e method.
  • Il tipo di risorsa monitorata di Cloud Storage gcs_bucket ha tre etichette: project_id, bucket_name e location. Le etichette identificano istanze specifiche del tipo di risorsa.

Di conseguenza, tutti i dati raccolti per le richieste API da un bucket viene classificato in base al metodo chiamato, il codice di risposta per la chiamata, il nome, la località e il progetto del bucket coinvolto. L'insieme di etichette varia a seconda della metrica o del tipo di risorsa monitorata. il le etichette disponibili sono indicate nell'elenco delle metriche e Pagine dell'elenco delle risorse monitorate.

Monitorando il codice di risposta, il nome del metodo e la posizione durante il conteggio dell'API puoi recuperare il numero di chiamate a una determinata API o il numero di chiamate non riuscite a un metodo oppure il numero di chiamate non riuscite a un metodo specifico in una località specifica.

Il numero di etichette e il numero di valori che ognuna può assumere sono indicati come come cardinalità. La cardinalità è il numero di possibili serie temporali che possono essere raccolti per un paio di tipi di metriche e di risorse monitorate: esiste una serie temporale per ogni combinazione di valori delle relative etichette. Per ulteriori informazioni, vedi Cardinalità: serie temporali ed etichette.

Etichette metadati delle risorse

Oltre alle etichette definite sulle metriche e sui tipi di risorse monitorate, Il monitoraggio raccoglie internamente ulteriori informazioni su le risorse monitorate e le archivia nelle etichette dei metadati di sistema. Queste etichette dei metadati di sistema sono disponibili agli utenti come valori di sola lettura. Alcune risorse consentono anche agli utenti di creare etichette di metadati delle risorse proprie durante la configurazione di risorse come le istanze VM nella console Google Cloud.

Le etichette dei metadati di sistema e utente sono chiamate collettivamente metadati delle risorse etichette. Puoi utilizzare queste etichette come le etichette definite nella metrica e tipi di risorse monitorate nei filtri delle serie temporali. Per ulteriori informazioni consulta i filtri di Monitoring.

Serie temporali: dati provenienti da una risorsa monitorata

Questa sezione illustra cosa sono i dati di monitoraggio e come sono organizzati in serie temporali. È qui che entrano in gioco le componenti concettuali del modello metrico diventano artefatti concreti.

Cloud Monitoring archivia misurazioni regolari nel tempo per coppie di metriche e i tipi di risorse monitorate. Le misurazioni vengono raccolte in serie temporali, e ogni serie temporale contiene i seguenti elementi:

  • Il nome del tipo di metrica a cui appartiene la serie temporale e una combinazione di valori per le etichette della metrica.

  • Una serie di coppie (timestamp, value). Il valore è la misura, mentre il timestamp è il momento in cui è stata effettuata la misurazione.

  • La risorsa monitorata, che è l'origine dei dati delle serie temporali, e una combinazione di valori per le etichette della risorsa.

Viene creata una serie temporale per ogni combinazione di etichette di metrica e risorsa che genera dati.

Esempio stilizzato: il tipo di metrica storage.googleapis.com/api/request_count potrebbe avere molte serie temporali per lo spazio di Cloud Storage bucket. L'illustrazione seguente mostra alcune possibili serie temporali.

Nell'illustrazione, il valore bucket: xxxx rappresenta il valore del bucket_name nel tipo di risorsa monitorata, mentre response_code e method sono etichette nel tipo di metrica. C'è una serie temporale per ogni combinazione di valori nelle etichette delle risorse e delle metriche; le illustrazioni ne mostra alcuni:

Immagini che mostrano più serie temporali in una metrica

Cloud Monitoring non registra serie temporali "vuote". Nella Esempio di bucket Cloud Storage, se non utilizzi un determinato bucket o non chiamare mai un particolare metodo API, non verranno raccolti dati per questo e nessuna serie temporale la menziona. Ciò significa che, se il tuo progetto non ha dati per una determinata metrica, non vedrai mai il tipo di metrica.

I tipi di metriche non indicano quali tipi di risorse monitorate disponibili nella sezione delle metriche serie temporali. Per Cloud Storage, c'è solo tipo di risorsa monitorata: gcs_bucket. Alcuni tipi di metriche si accoppiano con altri di una risorsa monitorata.

Esempio online: se hai un progetto Google Cloud, puoi provare il widget Explorer API, che si trova nella pagina di riferimento per timeSeries.list nell'API Monitoring.

  1. Apri la pagina di riferimento di timeSeries.list.

  2. Nel riquadro con l'etichetta Prova questo metodo, inserisci quanto segue:

    • name: projects/PROJECT_ID Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.
    • filtro: metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance"
    • interval.start_time: inserisci l'ora di inizio e assicurati che sia 20 minuti prima dell'ora di fine.
    • interval.end_time: inserisci l'ora di fine.

Se la richiesta ha esito positivo, verranno restituiti i dati delle serie temporali corrispondenti richiesta. Sarà simile al seguente snippet:

{
  "timeSeries": [
    {
      "metric": {
        "labels": {
          "severity": "INFO",
          "log": "compute.googleapis.com/activity_log"
        },
        "type": "logging.googleapis.com/log_entry_count"
      },
      "resource": {
        "type": "gce_instance",
        "labels": {
          "instance_id": "0",
          "zone": "us-central1",
          "project_id": "your-project-id"
        }
      },
      "metricKind": "DELTA",
      "valueType": "INT64",
      "points": [
        {
        "interval": {
            "startTime": "2024-03-29T13:53:00Z",
            "endTime": "2024-03-29T13:54:00Z"
          },
          "value": {
            "int64Value": "0"
          }
        },
        ...
      ]
    },
    ...
  ]
}

Per ulteriori informazioni sull'uso del widget Explorer API, inclusi risoluzione dei problemi, consulta Explorer API.

Cardinalità: serie temporali ed etichette

Ogni serie temporale è associata a una coppia specifica di metrica tipi di risorse monitorate. I tipi di metriche e di risorse monitorate ognuna fornisce un certo numero di etichette. In Cloud Monitoring, il numero combinazioni uniche di valori per l'insieme di etichette è la cardinalità il tipo di metrica o il tipo di risorsa monitorata. Questi valori sono indicati come cardinalità delle metriche e cardinalità delle risorse e determinano il numero possibili serie temporali, la cardinalità totale.

Metriche, risorse e cardinalità totale

Supponi di avere un tipo di metrica che specifica due etichette, color e zone. La cardinalità della metrica dipende dal numero di possibili i valori delle etichette:

  • Se i colori disponibili sono solo tre: "rosso", "verde" e "blu", l'etichetta color può hanno fino a tre valori distinti.
  • Se sono possibili solo due zone, "est" e "east" "ovest", l'etichetta zone può avere fino a due valori distinti.

La cardinalità di questa metrica è 6 (3 × 2). Se sono disponibili 1000 per l'etichetta color e se ogni colore può essere visualizzato in ogni zona, la cardinalità metrica è 2000 (1000 × 2). Si applica lo stesso calcolo se si tratta di etichette su un tipo di risorsa monitorata anziché su un tipo di metrica.

Questo valore di cardinalità è un valore massimo in base al numero di combinazioni di possibili valori delle etichette. L'effettivo valore reale potrebbe inferiore quando tutte le combinazioni di valori delle etichette non si verificano effettivamente. Ad esempio: se ogni colore appare in una sola zona e non in entrambe, il numero massimo di serie temporali che vedi nel sistema in esecuzione è 1000. Ma l'utilità della cardinalità efficace dipende dai motivi che determinate combinazioni non compaiano e se potrebbero farlo in futuro.

La cardinalità dipende dai valori che possono avere tutte le etichette.

I dati delle serie temporali vengono classificati in base a metrica tipi di risorse monitorate. Per qualsiasi coppia di tipi di metriche e risorse, La cardinalità totale è il prodotto della cardinalità della metrica e della risorsa cardinalità. Se hai una metrica con cardinalità di 1000 e una risorsa con cardinalità pari a 100 e se compare ogni valore di etichetta, il risultato è 100.000 serie temporali (1000 × 100).

Quando progetti le tue metriche, assicurati che siano disponibili i valori di ogni etichetta sono vincolati. Un piccolo insieme di valori discreti (come "rosso", "verde" e "blu") è l'approccio preferito. Se, ad esempio, utilizzi valori RGB a 8 bit per un color, puoi avere oltre 16 milioni di e i relativi valori. Non utilizzare valori ad alta risoluzione come timestamp, qualsiasi tipo di identificatore univoco, ID utente, indirizzo IP, URL e così via per le etichette delle metriche.

Prestazioni e cardinalità delle query

Quando esegui una query sui dati, il volume di dati richiesto viene il fattore più importante nelle prestazioni delle query: una query per un'ora di dati è generalmente più veloce della stessa query che copre sei mesi. Ma il volume dei dati restituiti da una richiesta è sensibile anche al numero di serie temporali in una richiesta. Una query che recupera due mesi di dati per una bassa cardinalità è probabilmente più veloce di un'altra query che recupera due mesi di per una metrica ad alta cardinalità, per via della quantità di dati da recuperare.

La cardinalità dipende principalmente dal numero di valori che le etichette possono avere, non in base al numero di etichette. In generale, non hai il controllo sul cardinalità delle risorse, ad esempio quando il numero di pod o VM cambia in base in base alle esigenze aziendali. Ma quando importi le metriche in Cloud Monitoring, piuttosto che usare le metriche di sistema, spesso hai un certo controllo rispetto alla cardinalità delle metriche. Ad esempio, con le metriche personalizzate definite dall'utente, sei tu a determinare le etichette e i relativi valori. Se importare le metriche di Prometheus, puoi utilizzare la rietichettatura l'insieme di etichette e rilasciare le serie temporali che non vuoi importare.

Puoi utilizzare la pagina Gestione delle metriche di Cloud Monitoring identificare le metriche che potrebbero avere problemi di cardinalità. Per visualizzare la pagina Gestione delle metriche, segui questi passaggi:

  1. Nella console Google Cloud, vai alla Pagina Gestione delle metriche:

    Vai a Gestione delle metriche

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

  2. Nella barra degli strumenti, seleziona la finestra temporale. Per impostazione predefinita, La pagina Gestione delle metriche mostra informazioni sulle metriche raccolte. nel giorno precedente.

Per saperne di più sulla pagina Gestione delle metriche, consulta Visualizza e gestisci l'utilizzo delle metriche.

Per informazioni tecniche sul modo in cui Cloud Monitoring archivia e recupera i dati delle serie temporali. Consulta Monarch: la scala dei pianeti di Google database di serie temporali in memoria.

Per informazioni sui limiti per le metriche definite dall'utente in Cloud Monitoring, consulta le metriche definite dall'utente.