Note sulla terminologia

Le parole name, type, kind, metric e resource compaiono in varie combinazioni e contesti correlati a Cloud Monitoring e i relativi utilizzi non sono sempre coerenti. Ad esempio, ecco alcuni modelli comuni:

  • Il termine metrica può essere utilizzato, in diversi contesti, per indicare uno qualsiasi di le seguenti:

    • Un "qualcosa" generico da misurare
    • Un tipo di metrica
    • Una serie temporale
    • Un insieme di serie temporali associate a un tipo di metrica
    • La struttura di Metric incorporata in una Struttura di TimeSeries

  • Una stringa come storage.googleapis.com/api/request_count potrebbe essere indicata come una delle seguenti:

    • Una metrica
    • Un nome della metrica
    • Un tipo di metrica
    • Un nome di tipo di metrica

  • La stringa come gcs_bucket può essere definita come una delle seguenti:

    • Un nome risorsa1
    • Una risorsa monitorata
    • Un tipo di risorsa monitorata
    • Un nome della risorsa monitorata

1 Il materiale di riferimento dell'API REST fa anche un uso frequente del termine nome risorsa, che in genere non ha nulla a che fare con le risorse monitorate. Questo termine è descritto in maggiore dettaglio in Nomi delle risorse.

Questa sezione fornisce alcune indicazioni sulla terminologia potenzialmente fuorviante.

Tipi e nomi

I descrittori per i tipi di metriche e le risorse monitorate hanno sia nomi che tipi. Nell'uso informale è comune utilizzare i termini in modo intercambiabile.

Ad esempio, la stringa storage.googleapis.com/api/request_count è un tipo di metrica, anche se viene indicata anche come nome o nome di tipo.

Se osservi il descrittore di questo tipo di metrica, puoi notare questi due coppie chiave-valore, name e type:

{
  "name": "projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count",
  ...
  "type": "storage.googleapis.com/api/request_count",
}

type in un descrittore della metrica è una stringa che codifica le informazioni su al servizio che genera i dati (ad esempio, storage.googleapis.com) e ciò che viene misurato (api/request_count).

In un descrittore della metrica, il valore di name è la versione valida del tipo di metrica, il valore name è il valore type preceduto da questa stringa:

projects/[PROJECT_ID]/metricDescriptors/

Un pattern simile vale per le risorse monitorate. type è un'etichetta per un determinato tipo di risorsa e name è costituito dal valore type con il prefisso di questa stringa:

projects/[PROJECT_ID]/monitoredResourceDescriptors/

L'esempio seguente corrisponde alla voce api nell'elenco delle risorse monitorate:

{
  "type": "api",
  ...
  "name": "projects/[PROJECT_ID]/monitoredResourceDescriptors/api"
}

Il valore di name all'interno di un progetto è completamente prevedibile dal valore di type, ma non sono esattamente la stessa cosa. Tuttavia, i termini sono spesso usati in modo impreciso in discussioni informali.

Tipo di metrica e tipo di valore

Esistono altri due termini che possono essere confusi con "tipo di metrica":

  • Tipo di valore
  • Tipo di metrica

Questi termini non sono termini alternativi per "tipo di metrica".

"Tipo di valore" e "tipo di metrica" descrivono i dati raccolte. Entrambi sono correlati al concetto di programmazione “datatype”.

  • Il tipo di valore descrive i singoli valori.
  • Il tipo di metrica descrive la relazione tra i valori.

Per maggiori dettagli, consulta la sezione Tipi e tipi di metriche.

Nomi delle risorse

Il pattern per creare un valore name aggiungendo un prefisso a una stringa di un valore type (o altro) va ben oltre i tipi di metriche e risorse monitorate. Appare con quasi tutto ciò che crea dati identificabili in modo univoco. Ad esempio, sia MetricDescriptor che AlertPolicy seguono questo pattern.

Il valore del campo name è spesso descritto nella documentazione di riferimento come "nome della risorsa":

Nome della risorsa nel riferimento all'API

Ecco alcuni esempi di alcune strutture con nomi di risorse e come derivano:

  • Descrittori delle metriche: unisci i valori del prefisso e il campo type:
    • Prefisso: projects/[PROJECT_ID]/metricDescriptors
    • type (esempio): storage.googleapis.com/api/request_count
    • name: projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count
  • Descrittori delle risorse monitorate: uniscono i valori del prefisso e il campo type:
    • Prefisso: projects/[PROJECT_ID]/monitoredResourceDescriptors
    • type (esempio): api
    • name: projects/[PROJECT_ID]/monitoredResourceDescriptors/api
  • Criteri di avviso: unisci i valori del prefisso e un ID generato
    • Prefisso: projects/[PROJECT_ID]/alertPolicies
    • ID criterio di avviso: un numero generato al momento della creazione del criterio
    • name: projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]

Il termine "nome risorsa" si riferisce a una risorsa nella gerarchia di all'API di un servizio e non è correlata al concetto di risorse monitorate in qualche modo. Per ulteriori informazioni sui nomi delle risorse nella progettazione di un'API, consulta Nomi delle risorse.