Introduzione all'API Cloud Monitoring

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 . Questo parametro ha in genere una descrizione come la seguente:

Obbligatorio. Il progetto su cui eseguire la richiesta. Il formato è:
projects/[PROJECT_ID_OR_NUMBER]

Nell'API Monitoring, il valore di PROJECT_ID_OR_NUMBER identifica uno dei seguenti elementi:

Alcuni metodi dell'API Monitoring richiedono che il progetto sia un progetto di ambito di un ambito delle metriche, mentre altri metodi no. Un numero limitato di metodi può 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, indipendentemente 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, i metodi recuperano i dati solo dal progetto denominato.
    • Se il progetto denominato è anche un progetto di definizione dell'ambito di un ambito delle metriche, i metodi recuperano i dati sia dal progetto denominato sia da eventuali progetti monitorati.

    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 ti consente di accedere a circa 6500 metriche di Cloud Monitoring da Google Cloud e Amazon Web Services. Puoi creare le tue metriche personalizzate e organizzare le risorse cloud utilizzando i gruppi.

Per un'introduzione ai concetti delle metriche e alle strutture di dati che le rappresentano, consulta Metriche, serie temporali e risorse.

Per scoprire come gestire le metriche personalizzate e quelle integrate, consulta la panoramica delle metriche definite dall'utente.

Per un elenco completo delle metriche disponibili, consulta Elenco delle metriche.

Risorse monitorate

Una risorsa monitorata è un elemento per cui vengono raccolte le metriche. Ad esempio, potrebbe interessarti l'attività di un'istanza VM un elemento 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 potuto creare gruppi manualmente nella console Google Cloud e puoi anche utilizzare l'API Cloud Monitoring per scrivere codice che crea e utilizza i 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 i criteri per la generazione di incidenti e come inviarti una notifica quando vengono creati. Concetti di base degli avvisi spiega i concetti di base. dei criteri di avviso. Per ulteriori informazioni, consulta il riferimento all'API per AlertPolicy.

L'API ti consente anche di creare criteri di avviso basati su un rapporto tra due metriche. Al momento non è possibile creare rapporti utilizzando il monitoraggio nella console Google Cloud. Per ulteriori informazioni, consulta MetricThreshold nella documentazione di 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 diversi tipi di servizi e endpoint di comunicazione, che vengono specificati nei descrittori. I descrittori determinano l'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 monitoraggio dei servizi vengono utilizzate per configurare gli obiettivi del livello di servizio che possono essere utilizzati per monitorare l'integrità dei servizi.

Il monitoraggio dei servizi 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 di questo endpoint per gestire dashboard e grafici, consulta Gestione delle dashboard tramite API.

Monitoring Query Language

Monitoring Query Language (MQL) fornisce un'interfaccia basata su testo per eseguire query sui dati delle serie temporali di Cloud Monitoring. MQL utilizza un modello di query con pipe ed è più espressivo dei filtri di monitoraggio. Puoi utilizzare le query MQL dall'API Monitoring o 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 mediante l'API Monitoring, consulta il riferimento all'API per il metodo 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 il set di risultati di determinate operazioni list. Consulta: Ordinamento e filtri per i dettagli sulla gestione dei risultati di alertPolicies.list e notificationChannels.list.

Passaggi successivi