Questo documento spiega come utilizzare l'API Cloud Monitoring per ottenere elenchi o descrizioni di quanto segue:
- Tipi di metriche definite dall'utente definiti nel progetto.
- Tipi di metriche di terze parti con dati di serie temporali nel tuo progetto.
Le metriche generate da Bindplane
sono esempi di metriche di terze parti. Le metriche Bindplane
hanno il prefisso
workload.googleapis.com/3rd-party-app-name/
. Per un elenco completo delle metriche delle applicazioni di terze parti supportate, consulta la documentazione sulle origini di Bindplane. - Tipi di metriche integrate fornite da Google Cloud. Questi tipi di metriche possono aiutarti a progettare le metriche definite dall'utente. Puoi trovare informazioni su queste metriche anche nella documentazione. Consulta l'elenco delle metriche.
- Tipi di risorse monitorate disponibili per il tuo progetto. Puoi trovare informazioni su queste risorse anche nella documentazione; consulta l'elenco delle risorse monitorate.
Per eseguire i metodi senza scrivere codice, gli esempi nelle schede Protocollo di questa pagina utilizzano l'API Explorer basato su moduli. (Per ulteriori informazioni su questo strumento, vedi Explorer API.)
Per scoprire come utilizzare i metodi dei linguaggi di programmazione selezionati, consulta gli esempi di codice eseguibili in questa pagina.
Prima di iniziare
- Per un'introduzione alle metriche e alle risorse monitorate, consulta Metriche, serie temporali e risorse.
Elenca descrittori della metrica
I descrittori delle metriche sono gli schemi che definiscono le metriche. Per trovare i dettagli sulle metriche che ti interessano, sfoglia i descrittori delle metriche disponibili:- Metriche integrate: puoi inviare richieste API a qualsiasi progetto esistente oppure puoi utilizzare la documentazione degli elenchi di metriche.
- Metriche definite dall'utente ed esterne: devi inviare la richiesta API a un progetto in cui è definita la metrica definita dall'utente o in cui esistono dati delle serie temporali per la metrica.
Per saperne di più su come vengono denominati i tipi di metriche, consulta Convenzioni di denominazione.
Elenco dei tipi di metriche
Per ottenere un elenco attuale dei descrittori delle metriche, utilizza il
metodo metricDescriptors.list
.
Per restringere l'insieme dei tipi di metriche restituiti, utilizza un filtro.
Per assistenza nella scelta dei tipi di metriche da cercare, consulta la sezione
Tipi di valori e tipi di metriche.
Protocollo
Apri la pagina di riferimento
metricDescriptors.list
.Nel riquadro Prova questo metodo, inserisci quanto segue:
- name:
projects/PROJECT_ID
. SostituisciPROJECT_ID
con l'ID del tuo progetto Google Cloud . - filter:
metric.type = starts_with("compute.googleapis.com")
- name:
Fai clic su Esegui.
La seguente risposta di esempio mostra alcuni dei descrittori delle metriche recuperati:
"metricDescriptors": [ { "name": "projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_bytes_count", "labels": [{...}], ... "description": "Count of incoming bytes dropped by the firewall.", "displayName": "Dropped bytes", "type": "compute.googleapis.com/firewall/dropped_bytes_count", ... }, { "name": "projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count", "labels": [{...}], ... "description": "Count of incoming packets dropped by the firewall.", "displayName": "Dropped packets", "type": "compute.googleapis.com/firewall/dropped_packets_count", }, ... ]
Il valore type
in ogni descrittore identifica il descrittore della metrica, ad esempio compute.googleapis.com/firewall/dropped_packets_count
. Questo valore è
a volte chiamato anche "tipo di metrica" o
"nome del tipo di metrica".
Per visualizzare la richiesta come comando curl
, come richiesta HTTP o in JavaScript, fai clic su fullscreen Schermo intero in Explorer API.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Se hai difficoltà, consulta la sezione Risoluzione dei problemi relativi alle chiamate API.
Recupero dei descrittori delle metriche
Per ottenere informazioni su un singolo tipo di metrica, utilizza il
metodo metricDescriptors.get
.
Questo metodo restituisce un descrittore della metrica.
Per recuperare un descrittore della metrica specifico, devi fornire il nome completo della metrica all'API. Il nome completo è composto da due componenti:
- Un prefisso composto da
projects/PROJECT_ID/metricDescriptors
. - Il valore
type
che identifica il descrittore della metrica, ad esempio,compute.googleapis.com/firewall/dropped_packets_count
. Per ulteriori informazioni sul valoretype
, consulta la scheda Protocollo in Elenca tipi di metriche.
Di seguito è riportato un esempio di nome completo di una metrica:
projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count
Protocollo
Per ottenere il descrittore della metrica /firewall/dropped_packets_count
di Compute Engine:
Apri la pagina di riferimento
metricDescriptors.list
.Nel riquadro Prova questo metodo, inserisci quanto segue:
name:
projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count
Sostituisci
PROJECT_ID
con l'ID del tuo progetto Google Cloud .
Fai clic su Esegui.
La seguente risposta di esempio mostra il descrittore della metrica:
{ "name": "projects/PROJECT_ID/metricDescriptors/compute.googleapis.com/firewall/dropped_packets_count", "labels": [ { "key": "instance_name", "description": "The name of the VM instance." } ], "metricKind": "DELTA", "valueType": "INT64", "unit": "1", "description": "Count of incoming packets dropped by the firewall.", "displayName": "Dropped packets", "type": "compute.googleapis.com/firewall/dropped_packets_count", }
Per visualizzare la richiesta come comando curl
, come richiesta HTTP o in JavaScript, fai clic su fullscreen Schermo intero in Explorer API.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Se hai difficoltà, consulta la sezione Risoluzione dei problemi relativi alle chiamate API.
Elenco delle risorse monitorate
Le risorse monitorate sono entità cloud che possono essere monitorate. Per trovare i tipi di entità che hanno metriche, sfoglia l'elenco dei tipi dirisorsa monitoratate.
Per ottenere informazioni sulle risorse monitorate, puoi inviare richieste API a qualsiasi progetto esistente oppure puoi utilizzare la documentazione Elenco delle risorse monitorate.
Elenco dei tipi di risorse
Per ottenere un elenco aggiornato dei tipi di risorsa monitorata dall'API Monitoring, utilizza il metodo monitoredResourceDescriptors.list
e fornisci l'ID progetto.
Protocollo
Apri la pagina di riferimento
monitoredResourceDescriptors.list
.Nel riquadro Prova questo metodo, inserisci quanto segue:
- name:
projects/PROJECT_ID
. SostituisciPROJECT_ID
con l'ID del tuo progetto Google Cloud .
- name:
Fai clic su Esegui.
La seguente risposta di esempio mostra alcuni dei tipi di risorsa monitorata restituiti:
{ "resourceDescriptors": [ { "type": "aiplatform.googleapis.com/Endpoint", "displayName": "AI Platform Endpoint", "description": "A Cloud AI Platform API Endpoint where Models are deployed into it.", "labels": [{...}], "name": "projects/PROJECT_ID/monitoredResourceDescriptors/aiplatform.googleapis.com/Endpoint", }, { "type": "aiplatform.googleapis.com/Featurestore", "displayName": "AI Platform Feature Store", "description": "A Cloud AI Platform Feature Store.", "labels": [{...}], "name": "projects/PROJECT_ID/monitoredResourceDescriptors/aiplatform.googleapis.com/Featurestore", },
Per visualizzare la richiesta come comando curl
, come richiesta HTTP o in JavaScript, fai clic su fullscreen Schermo intero in Explorer API.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Se hai difficoltà, consulta la sezione Risoluzione dei problemi relativi alle chiamate API.
Recupero dei descrittori delle risorse
Per ottenere un descrittore di risorse monitorate specifico, utilizza il metodo
monitoredResourceDescriptors.get
.
Per recuperare un descrittore di risorse monitorate specifico, devi fornire il nome completo del descrittore all'API. Il nome completo è composto da due componenti:
- Un prefisso composto da
projects/PROJECT_ID/monitoredResourceDescriptors
. - Il valore
type
che identifica il descrittore della risorsa monitorata, ad esempiogce_instance
. Per saperne di più sul valoretype
, consulta la scheda Protocollo in Elenca i tipi di risorse.
Di seguito è riportato un esempio del nome completo di una risorsa monitorata:
projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance
Protocollo
Per ottenere il descrittore per il tipo di risorsa gce_instance
:
Apri la pagina di riferimento
monitoredResourceDescriptors.get
.Nel riquadro Prova questo metodo, inserisci quanto segue:
name:
projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance
Sostituisci
PROJECT_ID
con l'ID del tuo progetto Google Cloud .
Fai clic su Esegui.
La seguente risposta di esempio mostra il descrittore per questa risorsa monitorata:
{ "type": "gce_instance", "displayName": "VM Instance", "description": "A virtual machine instance hosted in Compute Engine.", "labels": [ { "key": "project_id", "description": "The identifier of the Google Cloud project associated with this resource, such as \"my-project\"." }, { "key": "instance_id", "description": "The numeric VM instance identifier assigned by Compute Engine." }, { "key": "zone", "description": "The Compute Engine zone in which the VM is running." } ], "name": "projects/PROJECT_ID/monitoredResourceDescriptors/gce_instance" }
Per visualizzare la richiesta come comando curl
, come richiesta HTTP o in JavaScript, fai clic su fullscreen Schermo intero in Explorer API.
C#
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per eseguire l'autenticazione in Monitoring, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Se hai difficoltà, consulta la sezione Risoluzione dei problemi relativi alle chiamate API.
Passaggi successivi
- Per informazioni su come utilizzare l'API Cloud Monitoring per leggere i dati delle serie temporali, consulta Recuperare i dati delle serie temporali.
- Per un elenco dei tipi di risorse monitorate disponibili per l'utilizzo con le metriche definite dall'utente, consulta Scegliere un tipo di risorsa monitorata.