Note sulla terminologia

Le parole name, type, kind, metric e resource vengono visualizzate in varie combinazioni e contesti relativi a Cloud Monitoring di utilizzo non sono sempre coerenti. Ad esempio, ecco alcuni modelli 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 di Metric incorporata in una Struttura di TimeSeries

  • Una stringa come storage.googleapis.com/api/request_count potrebbe essere chiamata in uno dei seguenti modi:

    • Una metrica
    • Un nome della metrica
    • Un tipo di metrica
    • Il nome di un 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
    • Il nome di una risorsa monitorata

1 Anche il materiale di riferimento dell'API REST viene utilizzato frequentemente del termine nome risorsa, che di solito non ha nulla a che fare con i Google Cloud. Questo termine è descritto più dettagliatamente in Nomi delle risorse.

Questa sezione fornisce alcune indicazioni sulla terminologia potenzialmente confusa.

Tipi e nomi

I descrittori dei tipi di metriche e delle risorse monitorate hanno entrambi i nomi e tipi diversi. Nell'uso informale è comune utilizzare i termini in modo intercambiabile.

Ad esempio, la stringa storage.googleapis.com/api/request_count è un tipo di metrica, sebbene sia chiamato anche nome o nome del 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",
}

Il 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 valida del tipo di metrica, il valore name è il valore type preceduto da questa stringa:

projects/[PROJECT_ID]/metricDescriptors/

Un pattern simile vale anche per le risorse monitorate. type è un'etichetta per qualche tipo di risorsa, mentre name è costituito dal valore type preceduto da questa stringa:

projects/[PROJECT_ID]/monitoredResourceDescriptors/

L'esempio seguente corrisponde alla voce api nell'elenco di di 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 di creazione di un valore name facendo precedere una stringa a un type (o altro) va ben oltre i tipi di metriche e di risorse monitorate. it 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 risorsa nel riferimento 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: 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: uniscono 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 l'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.