Monitora il consumo delle prenotazioni

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

Monitoring raccoglie e archivia le informazioni sulle prestazioni dei servizi Google Cloud come Compute Engine. Le informazioni sulle prestazioni sono chiamate metriche e serie temporali. Puoi accedere alle metriche e alle serie temporali delle prenotazioni di Compute Engine per:

Questi metodi, ad esempio, possono aiutarti a verificare che le prenotazioni vengano consumate come hai pianificato o agisci tempestivamente per evitare costi inutili derivanti da risorse sprecate o prenotazioni inutilizzate.

Prima di iniziare

  • Esamina i requisiti e le limitazioni per le prenotazioni.

  • Attiva l'API Monitoring.

    Abilita l'API

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    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 di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init

    Per maggiori informazioni, consulta Autenticazione per REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

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

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

Autorizzazioni obbligatorie

Per creare dashboard di Monitoring o criteri di avviso al fine di monitorare il consumo delle prenotazioni, sono necessarie le autorizzazioni seguenti:

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

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Quando utilizzi Monitoring per accedere alle serie temporali di una prenotazione e visualizzarle, vengono applicate le seguenti limitazioni:

  • Dopo aver creato una prenotazione, le relative serie temporali diventano disponibili entro 30 minuti.

  • Quando una serie temporale diventa disponibile, Monitoring inizia ad aggiornarla almeno una volta ogni 30 minuti.

  • Se elimini una prenotazione, viene eliminata anche la relativa serie temporale, che non potrà essere recuperata.

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

Per ulteriori informazioni sulle restrizioni di Monitoring, consulta Quote e limiti di Cloud Monitoring.

Metriche relative alle prenotazioni

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

  • Riservata: il numero di istanze di macchine virtuali (VM) prenotate in ogni prenotazione nel progetto attuale.

  • Utilizzato: il numero di VM utilizzate in ogni prenotazione nel progetto attuale.

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 la sezione Filtri per le prenotazioni in questo documento.

Filtri per le prenotazioni

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

Selettore Nome dell'etichetta Descrizione
metadata.system machine_type Il tipo di macchina specificato nelle VM prenotate per una prenotazione.
metadata.system name Il nome di una prenotazione.
metadata.system state Lo stato di una prenotazione. Puoi monitorare solo le prenotazioni nello stato ACTIVE, ovvero quando esiste una prenotazione.
metric reserved_resource_type Il tipo di risorse di zona prenotate in base a 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 attuale.

Quando crei un filtro, devi specificare il selettore e il nome dell'etichetta, seguiti da un operatore di confronto e poi il 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.

Monitora 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 Monitoring e aggiungi widget alle aree del grafico per visualizzare i dati delle serie temporali collegati al consumo delle tue 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 associati al consumo delle prenotazioni raggiungono una soglia definita.

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

Crea una dashboard

Puoi creare dashboard di Monitoring e visualizzare le serie temporali legate al consumo delle tue 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 Monitoring, devi utilizzare uno dei seguenti metodi:

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

    Ad esempio, puoi utilizzare Query di base per visualizzare rapidamente quale delle tue prenotazioni in una zona specifica non è ancora stata utilizzata completamente.

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

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

Query di base

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

Console

Per creare una dashboard di Monitoring utilizzando la query di base, segui questi passaggi:

  1. Nella console Google Cloud, vai a Dashboard.

    Vai 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, segui questi passaggi:

    1. Inserisci Reservation e poi seleziona Prenotazione.

    2. Nell'elenco Categorie delle 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 disponibili per le prenotazioni. Per questo esempio, seleziona location.

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

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

  8. Fai clic su Applica.

Per ulteriori opzioni per la personalizzazione delle dashboard di Monitoring utilizzando la console Google Cloud, consulta Creazione e gestione di dashboard personalizzate.

REST

Per creare una dashboard di Monitoring 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 attuale.

  • FILTER: il filtro di Monitoring da utilizzare per la dashboard. Ad esempio, per monitorare le prenotazioni utilizzate 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 ulteriori opzioni per la personalizzazione delle dashboard di Monitoring utilizzando l'API Monitoring, consulta Creare e gestire le dashboard utilizzando l'API.

MQL

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

Console

Per creare una dashboard di Monitoring utilizzando MQL:

  1. Nella console Google Cloud, vai a Dashboard.

    Vai 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 query, inserisci una query MQL. Ad esempio, per visualizzare il rapporto tra le VM utilizzate e le 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

  7. Fai clic su Esegui query.

  8. Fai clic su Applica.

Per ulteriori opzioni per la personalizzazione delle dashboard di Monitoring utilizzando la console Google Cloud, consulta Creazione e gestione di dashboard personalizzate.

REST

Per creare una dashboard di Monitoring utilizzando MQL, 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": [
              {
                "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 attuale.

  • MQL_QUERY: la query MQL da utilizzare per il widget del grafico a linee. Ad esempio, per visualizzare il rapporto tra le VM utilizzate e le 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 ulteriori opzioni per la personalizzazione delle dashboard di Monitoring utilizzando l'API Monitoring, consulta Creare e gestire le dashboard utilizzando l'API.

Crea criteri di avviso

Puoi creare criteri di avviso di Monitoring per ricevere notifiche sull'utilizzo delle prenotazioni nel progetto attuale 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 condizioni di avviso semplici.

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

  • MQL: questo metodo è utile per recuperare, filtrare e manipolare i dati delle serie temporali in modo da 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 prenotate e VM utilizzate 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. In particolare, l'avviso si attiva quando il numero di VM utilizzate in una prenotazione è maggiore di 0.

Console

Per creare un criterio di avviso di Monitoring utilizzando la query di base, 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. Fai clic su Seleziona una metrica.

    Viene visualizzata la finestra Seleziona una metrica.

  4. Nella finestra Seleziona una metrica, segui questi passaggi:

    1. Nel campo Filtra per nome risorsa o 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 delle 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, procedi nel seguente modo:

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

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

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

      Ad esempio, seleziona = (uguale a) (valore predefinito).

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

    4. Fai clic su Fine.

  7. Tocca Avanti.

    Viene visualizzato il riquadro Configura trigger di avviso.

  8. Nella sezione Tipi di condizioni, 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 orario specifico, seleziona Assenza metrica.

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

    Ad esempio, seleziona Soglia (predefinita).

  9. Nell'elenco Attivazione dell'avviso, seleziona la condizione che attiva l'avviso.

    Ad esempio, seleziona Qualsiasi violazione di serie temporale (impostazione predefinita).

  10. Nell'elenco Posizione soglia, seleziona quando la condizione viene attivata.

    Ad esempio, seleziona Al di sopra della 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 che hai specificato nei passaggi precedenti.

  13. Tocca Avanti.

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

  14. Fai clic su Utilizza canali di notifica.

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

    Se non hai canali di notifica disponibili, fai clic su Gestisci canali di notifica, quindi segui i passaggi per creare canali di notifica. Per maggiori informazioni, consulta Creare e gestire canali di notifica.

  16. Nel campo Durata della chiusura automatica dell'incidente, seleziona la 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 che hai specificato nei passaggi precedenti.

  18. Tocca 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 ulteriori informazioni sulle opzioni disponibili quando crei criteri di avviso utilizzando la console Google Cloud e la query di base, consulta Creare criteri di avviso basati su metriche.

REST

Per creare un criterio di avviso di Monitoring utilizzando la query di base, effettua 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 attuale.

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

  • FILTER: il filtro di Monitoring 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 che deve trascorrere 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, vedi Creare e gestire canali di notifica.

Per ulteriori informazioni sulle opzioni disponibili quando crei 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 per le VM prenotate nelle prenotazioni è superiore al 90%.

Console

Per creare un criterio di avviso di Monitoring 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 raggruppa le prenotazioni per nome e attiva una condizione di avviso quando viene utilizzato oltre il 90% delle prenotazioni, inserisci la query seguente:

    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. Tocca Avanti.

    Viene visualizzato il riquadro Configura trigger di avviso.

  7. Se il campo 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 Utilizza canali di notifica.

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

    Se non hai canali di notifica disponibili, fai clic su Gestisci canali di notifica, quindi segui i passaggi per creare canali di notifica. Per maggiori informazioni, consulta Creare e gestire canali di notifica.

  11. Nel campo Durata della chiusura automatica dell'incidente, seleziona la 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. Tocca 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 saperne di più 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 Monitoring 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 attuale.

  • 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 prenotate è superiore al 90% nelle prenotazioni del progetto attuale, 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 che deve trascorrere 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, vedi Creare e gestire 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).

Passaggi successivi