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. Tu puoi accedere alle metriche e alle serie temporali dei tuoi Compute Engine per effettuare 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 già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.

    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 ulteriori informazioni, vedi Esegui 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 le dashboard: monitoring.dashboards.create del progetto
  • Per creare avvisi relativi ai criteri: monitoring.alertPolicies.create nel progetto

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.

Limitazioni

Quando utilizzi Monitoring per accedere e visualizzare il serie temporali di una prenotazione, il seguente con 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, vengono eliminate anche le relative serie temporali e non possono essere recuperato.

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

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

Metriche delle 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 seleziona 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 nell'attuale periodo progetto.

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

Filtri per le 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 di monitorare solo le prenotazioni ACTIVE, ovvero quando prenotazione esistente.
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 viene effettuata una prenotazione individuarlo.
resource reservation_id L'identificatore (ID) di una prenotazione.
resource resource_container Il numero del progetto in cui esiste una prenotazione. Puoi di monitorare solo le prenotazioni sono stati creati progetto.

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 tue prenotazioni, seleziona una delle seguenti opzioni metodi specificati in questo documento:

  • Crea una dashboard: crea un monitoraggio dashboard e aggiungi widget alle aree del grafico per visualizzare i dati delle serie temporali legati al consumo delle tue prenotazioni.

    Questo metodo è utile, ad esempio, quando vuoi verificare che una VM sia gestire correttamente una prenotazione o confrontare la tendenza di consumo 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 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 come visualizzare i dati delle serie temporali di un monitoraggio devi utilizzare uno dei seguenti metodi:

  • Query di base: questo metodo è utile per configurare rapidamente le 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 mostra il rapporto tra le VM consumate e le VM prenotate nelle prenotazioni.

Query di base

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

Console

Per creare una dashboard di Monitoring utilizzando Basic Query, 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 pulsante A linee widget.

    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, poi seleziona Prenotazione.

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

    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 una delle opzioni disponibili filtri per le prenotazioni. 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 ulteriori opzioni per personalizzare le dashboard di Monitoring utilizzando la console Google Cloud, 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 Creare e gestire le dashboard utilizzando l'API.

MQL

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

Console

Per creare una dashboard di Monitoring utilizzando MQL, segui questi passaggi: 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 pulsante A linee widget.

    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 ulteriori opzioni per personalizzare le dashboard di Monitoring utilizzando la console Google Cloud, 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 attuale progetto.

  • MQL_QUERY: la query MQL da utilizzare per la riga widget grafico. Ad esempio, per visualizzare il rapporto tra le VM utilizzate e quelle 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 personalizzare le dashboard di Monitoring utilizzando l'API Monitoring, consulta Creare e gestire le dashboard tramite 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 condizioni di avviso semplici.

    Ad esempio, puoi utilizzare la query di base per creare una condizione di avviso che attivati ogni volta che una prenotazione viene consumata 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. In particolare, 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.

    Si apre 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 in base al nome della risorsa o della metrica, inserisci Reservation.

    2. Se la metrica Prenotazione viene visualizzata nella sezione Risorse attive dall'elenco, selezionalo. In caso contrario:

      1. Deseleziona Mostra solo risorse e metriche attive.

        Viene visualizzato l'elenco Risorse non attive.

      2. Nell'elenco Risorse inattive, seleziona Prenotazione.

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

      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 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) (valore predefinito).

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

    4. Fai clic su Fine.

  7. Fai clic su Avanti.

    Viene visualizzato il riquadro Configura trigger di avviso.

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

    1. Per attivare la condizione se una serie temporale è superiore o inferiore a una per 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 si prevede 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 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 ulteriori informazioni, vedi Creare e gestire i canali di notifica.

  16. Nel campo Durata chiusura automatica incidente, seleziona una durata dopo in cui 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. Questo ti reindirizza alla pagina Crea criterio di avviso.

Per ulteriori informazioni sulle opzioni a tua disposizione durante la creazione degli avvisi utilizzando la console Google Cloud e Basic Query, consulta Crea criteri di avviso basati su metriche.

REST

Per creare un criterio di avviso di Monitoring utilizzando Basic Query, invia una richiesta POST a 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: filtro Monitoring da utilizzare per il criterio di avviso. Ad esempio, per monitorare used metrica per 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 elemento esistente canale di notifica. Per configurare un canale di notifica, consulta Creare e gestire i canali di notifica.

Per ulteriori informazioni sulle opzioni a tua disposizione durante la creazione degli avvisi che utilizzano l'API Monitoring e Basic Query, consulta Crea 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. Se 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 sull'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 incidente, seleziona una durata dopo in cui un incidente viene chiuso automaticamente.

    Ad esempio, seleziona 3 giorni.

  12. Nel campo Nome criterio di avviso, inserisci un nome per l'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 per la console Google Cloud e MQL, consulta Crea 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 attuale progetto.

  • MQL_QUERY: una query MQL da utilizzare per 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 l'incidente viene automaticamente chiuso. Il valore deve essere compreso tra 0s e 604800s (7 giorni). Ad esempio, inserisci 259200s (3 giorni).

  • NOTIFICATION_CHANNEL: il nome di un elemento esistente canale di notifica. 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