Monitorare il consumo delle prenotazioni

Questo documento spiega come monitorare il consumo delle prenotazioni delle risorse zonali di Compute Engine utilizzando Cloud Monitoring.

Il monitoraggio raccoglie e immagazzina le informazioni sul rendimento dei servizi Google Cloud come Compute Engine. Le informazioni sul rendimento sono chiamate metriche e serie temporali. Puoi accedere alle metriche e alle serie temporali delle prenotazioni di Compute Engine per eseguire le seguenti operazioni:

Questi metodi possono, ad esempio, aiutarti a verificare che le prenotazioni vengano consumate come previsto o ad agire in tempo per evitare costi non necessari dovuti a risorse sprecate o prenotazioni inutilizzate.

Prima di iniziare

  • Esamina i requisiti e le limitazioni per le prenotazioni.

  • Enable the Monitoring API.

    Enable the API

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    REST

    Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

      Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init

    Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare dashboard di monitoraggio o criteri di avviso per monitorare il consumo delle prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore monitoraggio (roles/monitoring.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare dashboard di monitoraggio o criteri di avviso per monitorare il consumo delle prenotazioni. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare dashboard di monitoraggio o criteri di avviso per monitorare il consumo delle prenotazioni, sono necessarie le seguenti autorizzazioni:

  • Per creare dashboard: monitoring.dashboards.create nel progetto
  • Per creare avvisi relativi ai criteri: monitoring.alertPolicies.create nel progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Quando utilizzi il monitoraggio per accedere e visualizzare le serie temporali di una prenotazione, si applicano le seguenti limitazioni:

  • Dopo aver creato una prenotazione, la relativa serie temporale diventa disponibile entro 30 minuti.

  • Una volta che una serie temporale diventa disponibile, il monitoraggio inizia a aggiornarla almeno ogni 30 minuti.

  • Se elimini una prenotazione, viene eliminata anche la relativa serie temporale e non può essere recuperata.

  • Puoi accedere e visualizzare solo le serie temporali di una prenotazione creata nel progetto corrente.

Per ulteriori informazioni sulle limitazioni del monitoraggio, consulta Quote e limiti di Cloud Monitoring.

Metriche prenotazioni

Quando crei dashboard di monitoraggio o criteri di avviso, devi prima selezionare la metrica Google Cloud per misurare il rendimento del servizio Google Cloud. Per le prenotazioni, puoi selezionare le seguenti metriche di Compute Engine:

  • Prenotate: il numero di istanze di macchine virtuali (VM) prenotate in ogni prenotazione del progetto corrente.

  • Utilizzate: il numero di VM consumate in ogni prenotazione nel progetto corrente.

Dopo aver selezionato una metrica, puoi filtrare o raggruppare ulteriormente le misurazioni della metrica delle prenotazioni. Per ulteriori informazioni sui filtri disponibili per le prenotazioni, consulta Filtri prenotazioni in questo documento.

Filtri delle prenotazioni

Puoi utilizzare i filtri di monitoraggio per agrupare o filtrare i dati delle serie temporali associati a una o più prenotazioni. In particolare, quando crei dashboard di monitoraggio o criteri di avviso, puoi limitare i dati delle serie temporali utilizzati specificando una o più delle seguenti etichette:

Selettore Nome dell'etichetta Descrizione
metadata.system machine_type Il tipo di macchina specificato nelle VM riservate per una prenotazione.
metadata.system name Il nome di una prenotazione.
metadata.system state Lo stato di una prenotazione. Puoi monitorare le prenotazioni solo nello stato ACTIVE, ovvero quando esiste una prenotazione.
metric reserved_resource_type Il tipo di risorse zonali riservate da una prenotazione. Puoi monitorare solo il tipo instance, che è un'istanza VM.
resource location La zona in cui si trova una prenotazione.
resource reservation_id L'identificatore (ID) di una prenotazione.
resource resource_container Il numero del progetto in cui esiste una prenotazione. Puoi monitorare solo le prenotazioni create nel progetto corrente.

Quando crei un filtro, devi specificare il selettore e il nome dell'etichetta, seguito da un operatore di confronto e poi dal valore da filtrare. Ad esempio, se vuoi che la query filtri le prenotazioni per zona us-central1-a, utilizza il seguente filtro:

resource.location = "us-central1-a"

Per assicurarti che il valore specificato in un filtro corrisponda al valore del campo di una prenotazione, visualizza i dettagli della prenotazione.

Monitorare il consumo delle prenotazioni

Per monitorare il consumo delle prenotazioni, seleziona uno dei seguenti metodi specificati in questo documento:

  • Crea una dashboard: crea dashboard di monitoraggio e aggiungi widget alle aree dei grafici per visualizzare i dati delle serie temporali correlati al consumo delle prenotazioni.

    Questo metodo è utile quando, ad esempio, vuoi verificare che una VM stia utilizzando correttamente una prenotazione o confrontare la tendenza di consumo di più prenotazioni.

  • Crea criteri di avviso: crea criteri di avviso per inviare avvisi quando i dati delle serie temporali legati al consumo delle tue prenotazioni raggiungono una soglia definita.

    Questo metodo è utile quando, ad esempio, vuoi ricevere una notifica quando il numero di VM utilizzate nel progetto corrente è inferiore a un rapporto specifico o quando una prenotazione rimane inutilizzata per un determinato periodo di tempo.

Crea una dashboard

Puoi creare dashboard di monitoraggio e visualizzare le serie temporali correlate al consumo delle prenotazioni utilizzando la console Google Cloud (opzione consigliata) e l'API Monitoring.

Quando definisci la modalità di visualizzazione dei dati delle serie temporali di un filtro di monitoraggio, devi utilizzare uno dei seguenti metodi:

  • Query di base: questo metodo è utile per configurare rapidamente i dati delle serie temporali per un widget della dashboard.

    Ad esempio, puoi utilizzare la query di base per visualizzare rapidamente una delle tue prenotazioni in una zona specifica non ancora completamente utilizzata.

  • MQL: questo metodo è utile per recuperare, filtrare e manipolare i dati delle serie temporali per creare configurazioni più complesse per un widget della dashboard.

    Ad esempio, puoi utilizzare Monitoring Query Language (MQL) per visualizzare il rapporto tra le VM consumate e le VM prenotate nelle tue prenotazioni.

Query di base

L'esempio seguente descrive come creare una dashboard di monitoraggio con un widget grafico a linee per visualizzare le prenotazioni consumate nella zona us-central1-a.

Console

Per creare una dashboard di monitoraggio utilizzando Query di base:

  1. Nella console Google Cloud, vai a Dashboard.

    Accedi a Dashboard

  2. Fai clic su Crea dashboard.

    Viene visualizzata la pagina Nuova dashboard.

  3. Fai clic su Aggiungi widget.

    Viene visualizzato il riquadro Aggiungi widget.

  4. Fai clic su uno dei widget disponibili. Ad esempio, fai clic sul widget Linea.

    Viene visualizzato il riquadro Configura widget.

  5. Fai clic su Seleziona una metrica.

  6. Nella finestra Seleziona una metrica, procedi nel seguente modo:

    1. Inserisci Reservation, quindi seleziona Prenotazione.

    2. Nell'elenco Categorie di metriche attive, seleziona di nuovo Prenotazione.

    3. Nell'elenco Metriche attive, seleziona una delle metriche disponibili. Ad esempio, seleziona Usato.

    4. Fai clic su Applica.

  7. Per filtrare le prenotazioni in base a una zona specifica:

    1. Nell'elenco Aggiungi filtro, seleziona uno dei filtri per le prenotazioni disponibili. Per questo esempio, seleziona posizione.

    2. Nell'elenco Comparatore, seleziona uno degli operatori disponibili. Per questo esempio, seleziona = (è uguale a) (impostazione predefinita).

    3. Nell'elenco Valore, seleziona la zona da utilizzare per filtrare le prenotazioni. Per questo esempio, seleziona us-central1-a.

  8. Fai clic su Applica.

Per altre opzioni per personalizzare le dashboard di monitoraggio utilizzando la console Google Cloud, consulta Creare e gestire dashboard personalizzate.

REST

Per creare una dashboard di monitoraggio utilizzando la query di base, effettua una richiesta POST al metodo dashboards.create.

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "minAlignmentPeriod": "60s",
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesFilter": {
                    "aggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_MEAN"
                    },
                    "filter": "FILTER",
                    "secondaryAggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_NONE"
                    }
                  }
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6
      }
    ]
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto corrente.

  • FILTER: il filtro Monitoraggio da utilizzare per la dashboard. Ad esempio, per monitorare le prenotazioni consumate nella zona us-central1-a, specifica quanto segue:

    resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND resource.location = 'us-central1-a'

Per altre opzioni per personalizzare le dashboard di monitoraggio utilizzando l'API Monitoring, consulta Crea e gestisci le dashboard utilizzando l'API.

MQL

L'esempio seguente descrive come creare una dashboard di monitoraggio con un widget grafico a linee per visualizzare il rapporto tra le VM utilizzate e quelle prenotate nelle prenotazioni.

Console

Per creare una dashboard di monitoraggio utilizzando MQL, segui questi passaggi:

  1. Nella console Google Cloud, vai a Dashboard.

    Accedi a Dashboard

  2. Fai clic su Crea dashboard.

    Viene visualizzata la pagina Nuova dashboard.

  3. Fai clic su Aggiungi widget.

    Viene visualizzato il riquadro Aggiungi widget.

  4. Fai clic su uno dei widget disponibili. Ad esempio, fai clic sul widget Linea.

    Viene visualizzato il riquadro Configura widget.

  5. Fai clic su MQL.

  6. Nell'editor di query, inserisci una query MQL. Ad esempio, per visualizzare il rapporto tra le VM utilizzate e le VM riservate nelle tue prenotazioni, specifica quanto segue:

    fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
    | group_by [metadata.system.name], sliding(1m), max(value.used)
  ; metric compute.googleapis.com/reservation/reserved
    | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio

  7. Fai clic su Esegui query.

  8. Fai clic su Applica.

Per altre opzioni per personalizzare le dashboard di monitoraggio utilizzando la console Google Cloud, consulta Creare e gestire dashboard personalizzate.

REST

Per creare una dashboard di monitoraggio utilizzando MQL, invia una richiesta POST al metodo dashboards.create.

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesQueryLanguage": "MQL_QUERY"
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6,
        "xPos": 6
      }
    ]
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto corrente.

  • MQL_QUERY: la query MQL da utilizzare per il widget grafico a linee. Ad esempio, per visualizzare il rapporto tra VM utilizzate e VM prenotate nelle tue prenotazioni, specifica quanto segue:

    fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
 | group_by [metadata.system.name], sliding(1m), max(value.used)
; metric compute.googleapis.com/reservation/reserved
 | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio

Per altre opzioni per personalizzare le dashboard di monitoraggio utilizzando l'API Monitoring, consulta Creare e gestire le dashboard utilizzando l'API.

Crea criteri di avviso

Puoi creare criteri di avviso di monitoraggio per ricevere notifiche sul consumo delle prenotazioni nel progetto corrente utilizzando la console Google Cloud e l'API Monitoring.

Quando definisci una condizione di avviso per un criterio di avviso, devi utilizzare uno dei seguenti metodi:

  • Query di base: questo metodo è utile per creare semplici condizioni di avviso.

    Ad esempio, puoi utilizzare Query di base per creare una condizione di avviso che viene attivata ogni volta che una prenotazione viene utilizzata per la prima volta.

  • MQL: questo metodo è utile per recuperare, filtrare e manipolare i dati delle serie temporali per creare condizioni di avviso più complesse.

    Ad esempio, puoi utilizzare Monitoring Query Language (MQL) per creare una condizione di avviso che viene attivata quando il rapporto tra VM riservate e VM consumate raggiunge una soglia specifica.

Query di base

L'esempio seguente crea un criterio di avviso che invia una notifica di avviso quando una prenotazione viene utilizzata per la prima volta. Nello specifico, l'avviso si attiva ogni volta che il numero di VM consumate in una prenotazione è maggiore di 0.

Console

Per creare un criterio di avviso di monitoraggio utilizzando Query di base:

  1. Nella console Google Cloud, vai ad Avvisi.

    Vai ad Avvisi

  2. Fai clic su Crea criterio.

    Viene visualizzata la pagina Crea criterio di avviso.

  3. Fai clic su Seleziona una metrica.

    Viene visualizzata la finestra Seleziona una metrica.

  4. Nella finestra Seleziona una metrica, procedi nel seguente modo:

    1. Nel campo Filtra in base al nome della risorsa o della metrica, inserisci Reservation.

    2. Se la metrica Prenotazione viene visualizzata nell'elenco Risorse attive, selezionala. In caso contrario:

      1. Deseleziona Mostra solo risorse e metriche attive.

        Viene visualizzato l'elenco Risorse non attive.

      2. Nell'elenco Risorse non attive, seleziona Prenotazione.

    3. Nell'elenco Categorie di metriche attive, seleziona di nuovo Prenotazione.

      Viene visualizzato l'elenco Metriche attive.

    4. Nell'elenco Metriche attive, seleziona una delle metriche disponibili.

      Ad esempio, seleziona Usato.

    5. Fai clic su Applica.

  5. Fai clic su Aggiungi filtro.

    Viene visualizzata la sezione Aggiungi filtro.

  6. Nella sezione Aggiungi filtro:

    1. Nell'elenco Etichetta, seleziona uno dei filtri per le prenotazioni disponibili specificati in questo documento.

      Ad esempio, per filtrare le prenotazioni per nome, seleziona name.

    2. Nell'elenco Confronto, seleziona uno degli operatori disponibili.

      Ad esempio, seleziona = (è uguale a) (impostazione predefinita).

    3. Nell'elenco Valore, seleziona il nome della prenotazione che vuoi monitorare.

    4. Fai clic su Fine.

  7. Fai clic su Avanti.

    Viene visualizzato il riquadro Configura l'attivatore di avvisi.

  8. Nella sezione Tipi di condizione, seleziona una delle seguenti opzioni:

    1. Per attivare la condizione se una serie temporale è superiore o inferiore a un valore specifico, seleziona Soglia.

    2. Per attivare la condizione se una serie temporale non ha dati per un momento specifico, seleziona Absence of metric (Assenza di metrica).

    3. Per attivare la condizione se è previsto che una serie temporale superi la soglia nel prossimo futuro, seleziona Previsione.

    Ad esempio, seleziona Soglia (impostazione predefinita).

  9. Nell'elenco Attivatore di avvisi, seleziona la condizione che attiva l'avviso.

    Ad esempio, seleziona Qualsiasi violazione della serie temporale (valore predefinito).

  10. Nell'elenco Soglia posizione, seleziona quando viene attivata la condizione.

    Ad esempio, seleziona Sopra la soglia.

  11. Nel campo Valore soglia, inserisci un valore per la condizione.

    Ad esempio, inserisci 0.

  12. Nel campo Nome condizione, inserisci un nome per la condizione.

    Ad esempio, inserisci Reservation RESERVATION_NAME consumed.

    dove RESERVATION_NAME è il nome della prenotazione specificato nei passaggi precedenti.

  13. Fai clic su Avanti.

    Viene visualizzato il riquadro Configura le notifiche e finalizza l'avviso.

  14. Fai clic su Usa canali di notifica.

  15. Nel campo Canali di notifica, seleziona i canali su cui vuoi ricevere una notifica relativa all'incidente.

    Se non hai canali di notifica disponibili, fai clic su Gestisci canali di notifica e segui i passaggi per crearli. Per saperne di più, consulta la pagina Creare e gestire i canali di notifica.

  16. Nel campo Durata chiusura automatica incidenti, seleziona una durata dopo la quale un incidente viene chiuso automaticamente.

    Ad esempio, seleziona 3 giorni.

  17. Nel campo Nome criterio di avviso, inserisci un nome per il criterio di avviso.

    Ad esempio, inserisci Alert: you started consuming reservation RESERVATION_NAME!

    dove RESERVATION_NAME è il nome della prenotazione specificato nei passaggi precedenti.

  18. Fai clic su Avanti.

    Si apre la pagina di revisione della condizione di avviso.

  19. Fai clic su Crea criterio.

    La creazione del criterio di avviso potrebbe richiedere alcuni secondi. Questa azione ti reindirizza alla pagina Crea criterio di avviso.

Per saperne di più sulle opzioni disponibili per la creazione di criteri di avviso utilizzando la console Google Cloud e Query di base, consulta Creare criteri di avviso basati su metriche.

REST

Per creare un criterio di avviso di monitoraggio utilizzando la query di base, invia una richiesta POST al metodo projects.alertPolicies.create.

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: you started consuming reservation RESERVATION_NAME!",
  "conditions": [
    {
      "displayName": "Reservation RESERVATION_NAME consumed.",
      "conditionThreshold": {
        "filter": "FILTER",
        "aggregations": [
          {
            "alignmentPeriod": "300s",
            "crossSeriesReducer": "REDUCE_NONE",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "thresholdValue": 0
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto corrente.

  • RESERVATION_NAME: il nome di una prenotazione esistente che si trova nel progetto corrente.

  • FILTER: il filtro di monitoraggio da utilizzare per il criterio di avviso. Ad esempio, per monitorare la metrica used per la prenotazione RESERVATION_NAME, specifica quanto segue:

    resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND metadata.system.name = 'RESERVATION_NAME'

  • AUTO_CLOSE_TIME: il tempo in secondi prima che un incidente venga chiuso automaticamente. Il valore deve essere compreso tra 0s e 604800s (7 giorni). Ad esempio, inserisci 259200s (3 giorni).

  • NOTIFICATION_CHANNEL: il nome di un canale di notifica esistente. Per configurare un canale di notifica, consulta Creare e gestire i canali di notifica.

Per ulteriori informazioni sulle opzioni disponibili per la creazione di criteri di avviso utilizzando l'API Monitoring e la query di base, consulta Creare criteri di avviso utilizzando l'API.

MQL

L'esempio seguente crea un criterio di avviso che invia una notifica di avviso ogni volta che la percentuale di VM utilizzate rispetto alle VM riservate nelle tue prenotazioni è superiore al 90%.

Console

Per creare un criterio di avviso di monitoraggio utilizzando MQL, segui questi passaggi:

  1. Nella console Google Cloud, vai ad Avvisi.

    Vai ad Avvisi

  2. Fai clic su Crea criterio.

    Viene visualizzata la pagina Crea criterio di avviso.

  3. Nella barra degli strumenti, fai clic su MQL.

    Viene visualizzato il riquadro Modifica query.

  4. Nel riquadro Modifica query, inserisci una query MQL.

    Ad esempio, per creare una query che raggruppi le prenotazioni per nome e attivi una condizione di avviso quando viene consumato più del 90% delle prenotazioni, inserisci la seguente query:

    fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
    | group_by [metadata.system.name], sliding(1m), max(value.used)
  ; metric compute.googleapis.com/reservation/reserved
    | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
| every 1m
| condition gt(val(), 0.9)

  5. Per eseguire la query appena inserita, fai clic su Esegui query.

  6. Fai clic su Avanti.

    Viene visualizzato il riquadro Configura l'attivatore di avvisi.

  7. In Nome condizione, inserisci un nome per la condizione.

    Ad esempio, inserisci Over 90% of your reservations are consumed.

  8. Fai di nuovo clic su Avanti.

    Viene visualizzato il riquadro Configura le notifiche e finalizza l'avviso.

  9. Fai clic su Usa canali di notifica.

  10. Nel campo Canali di notifica, seleziona i canali su cui vuoi ricevere una notifica relativa all'incidente.

    Se non hai canali di notifica disponibili, fai clic su Gestisci canali di notifica e segui i passaggi per crearli. Per saperne di più, consulta la pagina Creare e gestire i canali di notifica.

  11. Nel campo Durata chiusura automatica incidenti, seleziona una durata dopo la quale un incidente viene chiuso automaticamente.

    Ad esempio, seleziona 3 giorni.

  12. Nel campo Nome criterio di avviso, inserisci un nome per il criterio di avviso.

    Ad esempio, inserisci Alert: over 90% of your reservations are consumed..

  13. Fai clic su Avanti.

    Si apre la pagina di revisione della condizione di avviso.

  14. Fai clic su Crea criterio.

    La creazione del criterio di avviso potrebbe richiedere alcuni secondi. Questa azione ti reindirizza alla pagina Crea criterio di avviso.

Per ulteriori informazioni sulla creazione di criteri di avviso utilizzando la console Google Cloud e MQL, consulta Creare criteri di avviso MQL (console).

REST

Per creare un criterio di avviso di monitoraggio utilizzando MQL, effettua una richiesta POST al metodo projects.alertPolicies.create.

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: over 90% of your reservations are consumed.",
  "conditions": [
    {
      "displayName": "Over 90% of your reservations are consumed.",
      "conditionMonitoringQueryLanguage": {
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "query": "MQL_QUERY"
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto corrente.

  • MQL_QUERY: una query MQL da utilizzare per il criterio di avviso. Ad esempio, per creare una query che monitori quando la percentuale di VM utilizzate rispetto alle VM riservate è superiore al 90% nelle prenotazioni del progetto corrente, specifica quanto segue:

    fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
 | group_by [metadata.system.name], sliding(1m), max(value.used)
; metric compute.googleapis.com/reservation/reserved
 | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
| every 1m
| condition gt(val(), 0.9)

  • AUTO_CLOSE_TIME: il tempo in secondi prima che un incidente venga chiuso automaticamente. Il valore deve essere compreso tra 0s e 604800s (7 giorni). Ad esempio, inserisci 259200s (3 giorni).

  • NOTIFICATION_CHANNEL: il nome di un canale di notifica esistente. Per configurare un canale di notifica, consulta Creare e gestire i canali di notifica.

Per saperne di più sulla creazione di criteri di avviso utilizzando l'API Monitoring e MQL, consulta Creare criteri di avviso MQL (API).

Risoluzione dei problemi

Scopri come risolvere i problemi relativi al monitoraggio delle prenotazioni.

Passaggi successivi