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, di seguito sono riportati alcuni pattern comuni:

  • Il termine metrica può essere utilizzato, in contesti diversi, per fare riferimento a uno dei seguenti elementi:

    • 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 Metric incorporata in una struttura 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 gcs_bucket potrebbe essere indicata come una delle seguenti:

    • Un nome della 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 esamini il descrittore di questo tipo di metrica, vedrai queste 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",
}

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

In un descrittore della metrica, il valore di name è la versione completa del tipo di metrica; il valore name è il valore type con il prefisso di 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 è del tutto prevedibile dal valore di type, ma non sono esattamente la stessa cosa. Tuttavia, i termini vengono spesso utilizzati in modo impreciso nelle conversazioni 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 raccolti. 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. Viene visualizzato 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 API

Ecco alcuni esempi di strutture con nomi di risorse e come vengono ricavate:

  • Descrittori delle metriche: unisci i valori del prefisso e del 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: unisci i valori del prefisso e del 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 della risorsa" si riferisce a una risorsa nella gerarchia dell'API di un servizio e non è correlato in alcun modo al concetto di risorse monitorate. Per ulteriori informazioni sui nomi delle risorse nella progettazione di un'API, consulta Nomi delle risorse.