Note sulla terminologia

I termini name, type, kind, metric e resource compaiono in varie combinazioni e contesti relativi a Cloud Monitoring e gli utilizzi non sono sempre coerenti. Ad esempio, ecco alcuni schemi comuni:

• Il termine metrica potrebbe 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 può essere definita come uno dei seguenti:

  • Una metrica
  • Il nome di una metrica
  • Un tipo di metrica
  • Il nome di un tipo di metrica.

• La stringa come gcs_bucket può essere indicata come segue:

  • Il nome di una risorsa¹
  • Una risorsa monitorata
  • Un tipo di risorsa monitorata
  • Un nome di risorsa monitorata

¹ Il materiale di riferimento dell'API REST fa anche uso frequente del termine nome risorsa, che in genere non ha nulla a che fare con le risorse monitorate. Questo termine è descritto più dettagliatamente nella sezione Nomi delle risorse.

Questa sezione fornisce alcune indicazioni sulla terminologia che può creare confusione.

Tipi e nomi

I descrittori dei tipi di metriche e delle risorse monitorate hanno nomi e tipi. È frequente nell'uso occasionale utilizzare i termini in modo intercambiabile.

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

Se esamini il descrittore per 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",
}

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 preceduto da questa stringa:

projects/[PROJECT_ID]/metricDescriptors/

Un pattern simile vale per le risorse monitorate. type è un'etichetta per un tipo di risorsa, mentre name è costituito dal valore type preceduto con 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 è esattamente la stessa cosa. Tuttavia, questi termini vengono spesso usati in modo impreciso in discussioni occasionali.

Punto chiave: in quasi tutti i casi, l'uso di "tipo di metrica", "nome metrica" o "nome tipo di metrica" si riferisce al tipo di metrica descritto qui. La parola "metrica" indica in genere le serie temporali associate a un tipo di metrica. L'espressione "risorsa monitorata" di solito indica il tipo o una particolare entità fisica descritta da un tipo.

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 il "tipo di metrica".

"Tipo di valore" e "tipo di metrica" descrivono i dati raccolti. Entrambi sono legati al concetto di programmazione "datatype".

• Il tipo di valore descrive i singoli valori.
• Il tipo di metrica descrive in che modo i valori sono correlati tra loro.

Per informazioni dettagliate, consulta Tipi e tipi di metriche.

Nomi delle risorse

Il pattern di creazione di un valore name mediante il prefisso di una stringa a un valore type (o altro) si estende ben oltre i tipi di metrica e di risorse-monitorate. Viene visualizzata 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 risorsa":

Di seguito sono riportati alcuni esempi di alcune strutture che hanno nomi di risorse e come vengono derivati:

• Descrittori delle metriche: unisci i valori del prefisso e del campo type:
  • Prefisso: projects/[PROJECT_ID]/metricDescriptors
  • type (campione): 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 del campo type:
  • Prefisso: projects/[PROJECT_ID]/monitoredResourceDescriptors
  • type (campione): 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 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.

Punto chiave: nell'API Cloud Monitoring, quando un campo name viene descritto come "nome risorsa", il valore per quel campo è un identificatore completo creato prendendo un valore type (o un altro campo) e anteponendovi la stringa che identifica il tipo di risorsa.