Questa pagina descrive alcune delle funzionalità dell'API Cloud Monitoring v3.
Per la documentazione di riferimento dell'API, consulta una delle seguenti pagine:
Nomi dei progetti nell'API Monitoring
Tutti i metodi nell'API Monitoring hanno un campo name
obbligatorio
. Solitamente, questo parametro ha una descrizione simile alla seguente:
Obbligatorio. Il progetto su cui eseguire la richiesta. Il formato è:
projects/[PROJECT_ID_OR_NUMBER]
PROJECT_ID_OR_NUMBER
identifica uno dei seguenti elementi:
- Un progetto Google Cloud
- Un progetto Google Cloud che è anche progetto di ambito di un ambito delle metriche
Alcuni metodi nell'API Monitoring richiedono che il progetto sia un progetto di definizione dell'ambito di un ambito delle metriche; al contrario di altri metodi. Un numero ridotto di possono restituire risultati diversi, a seconda del tipo di progetto.
Per descrivere queste classi di metodi, in questa discussione viene utilizzato il termine metriche API per fare riferimento alle seguenti risorse nell'API Monitoring:
progetto di definizione dell'ambito di un ambito delle metriche obbligatorio
Tutti i metodi dell'API Monitoring che non fanno parte dell'API Metrics
richiedono che il parametro name
faccia riferimento a un progetto di definizione dell'ambito in un ambito delle metriche.
progetto di definizione dell'ambito di un ambito delle metriche non obbligatorio
Nessuno dei metodi nell'API Metrics richiede che il parametro name
faccia riferimento
a un progetto di definizione dell'ambito per un ambito delle metriche, ma alcuni metodi si comportano diversamente quando
ossia:
I seguenti metodi nell'API Metrics operano sul metodo progetto Google Cloud. Questi metodi influiscono sui dati solo nel campo progetto, a prescindere dal fatto che sia anche un progetto di definizione dell'ambito di un ambito delle metriche.
timeSeries.create
metricDescriptors.create
metricDescriptors.delete
metricDescriptors.get
monitoredResourceDescriptors.get
I restanti metodi nell'API Metrics si comportano come segue:
- Se il progetto denominato non è un progetto di definizione dell'ambito di un ambito delle metriche, recuperano i dati solo dal progetto denominato.
- Se il progetto denominato è anche un progetto di definizione dell'ambito di un ambito delle metriche, recuperano i dati sia dal progetto denominato che da qualsiasi progetto monitor.
I metodi di questo gruppo sono i seguenti:
timeSeries.list
timeSeries.query
metricDescriptors.list
monitoredResourceDescriptors.list
Per informazioni sulla configurazione di un progetto Google Cloud come progetto di definizione dell'ambito di un ambito delle metriche, consulta Panoramica degli ambiti delle metriche.
Risorse API
Metriche
L'API Monitoring consente di accedere a circa 6500 metriche di Cloud Monitoring da Google Cloud e Amazon Web Services. Puoi creare metriche personalizzate possono organizzare le risorse cloud usando i gruppi.Per un'introduzione ai concetti delle metriche e alle strutture di dati che rappresentano consulta Metriche, serie temporali e risorse.
Per scoprire come gestire le metriche personalizzate e quelle integrate, consulta Panoramica delle metriche definite dall'utente.Per un elenco completo delle metriche disponibili, consulta Elenco delle metriche.
Risorse monitorate
Una risorsa monitorata riguarda le metriche raccolte. Ad esempio, potrebbe interessarti l'attività di un'istanza VM un componente hardware.
Per un elenco delle risorse monitorate disponibili, consulta Elenco delle risorse monitorate:
Gruppi di risorse monitorate
Un gruppo è una raccolta dinamica di risorse monitorate. Hai sempre è stato possibile creare manualmente gruppi nella console Google Cloud e puoi anche utilizzare l'API Cloud Monitoring per scrivere codice che crea e utilizza gruppi.
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Group
.
Criteri di avviso
Un criterio di avviso è una risorsa di configurazione che descrive
criteri per la generazione di incidenti e come inviare notifiche quando questi incidenti
vengono create. Concetti di base degli avvisi spiega i concetti di base.
dei criteri di avviso. Per ulteriori informazioni, consulta il riferimento API per
AlertPolicy
L'API consente inoltre di creare criteri di avviso basati su un rapporto di due metriche.
Al momento non è possibile creare i rapporti utilizzando Monitoring in
la console Google Cloud.
Per ulteriori informazioni, consulta la sezione MetricThreshold
della
Riferimento AlertPolicy
.
Canali di notifica
Un canale di notifica è una risorsa di configurazione che descrive come per ricevere una notifica in caso di incidenti. I canali di notifica possono fare riferimento a varietà di tipi diversi di servizi ed endpoint di comunicazione; questi elementi sono specificati in descriptors. I descrittori determinano insieme di parametri di configurazione inclusi in un oggetto canale.
Per ulteriori informazioni, consulta
Riferimento NotificationChannel
e
Riferimento NotificationChannelDescriptor
.
Monitoraggio dei servizi
Le risorse di service Monitoring vengono utilizzate per configurare il livello di servizio utilizzabili per monitorare l'integrità dei servizi.
Service Monitoring aggiunge le seguenti risorse all'API Monitoring:
Per ulteriori informazioni su questi concetti di monitoraggio dei servizi e sull'uso consulta l'articolo sul monitoraggio dello SLO.
Dashboard
Puoi creare e manipolare in modo programmatico le dashboard e i grafici
utilizzando l'endpoint Dashboards
. Per informazioni sull'utilizzo
questo endpoint per gestire dashboard e grafici,
Gestione delle dashboard tramite API.
Monitoring Query Language
Monitoring Query Language (MQL) fornisce un'interfaccia basata su testo per eseguire query dati delle serie temporali di Cloud Monitoring. MQL utilizza una query piped del modello ed è più espressivo dei filtri di Monitoring. Puoi usare le query MQL dall'API Monitoring oppure dall'editor di codice.
Per informazioni generali su MQL, consulta Utilizzo di Monitoring Query Language.
Per informazioni sull'utilizzo di MQL per recuperare i dati delle serie temporali utilizzando
l'API Monitoring, consulta il riferimento dell'API per
timeSeries.query
.
Filtri
L'API Monitoring utilizza i filtri per selezionare le metriche, recuperare dati di serie temporali e la raccolta di risorse monitorate in gruppi. Per saperne di più, consulta i filtri di Monitoring.L'API Monitoring utilizza anche i filtri per limitare l'insieme di risultati di
alcune operazioni di list
. Consulta
Ordinamento e filtri per i dettagli
sulla gestione dei risultati di alertPolicies.list
e notificationChannels.list
.
Passaggi successivi
- Consulta l'introduzione alle Metriche, serie temporali e risorse.
- Consulta l'introduzione alle Utilizzo dei criteri di avviso.
- Scopri come chiamare i metodi API dal Explorer API.
- Scopri come utilizzare il linguaggio di query di Monitoring basato su testo per l'esecuzione di query i dati delle serie temporali.
Consulta le librerie client per Cloud Monitoring per iniziare a utilizzare Cloud Monitoring nel linguaggio che preferisci.
Consulta il riferimento per l'API API Cloud Monitoring (REST) oppure API Cloud Monitoring (gRPC).