Monitora il consumo delle prenotazioni


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

Monitoring raccoglie e archivia le informazioni sulle prestazioni dei servizi Google Cloud, in Compute Engine. Le informazioni sulle prestazioni 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, ad esempio, possono aiutarti a verificare che le prenotazioni consumato come previsto o come azione tempestiva per evitare costi inutili sprecati risorse o prenotazioni inutilizzate.

Prima di iniziare

  • Leggi lo requisiti e . 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 eseguire l'autenticazione 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 di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci 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 o avvisi di Monitoring per monitorare il consumo delle prenotazioni, chiedi all'amministratore di concederti Ruolo IAM Amministratore Monitoring (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 o avvisi di Monitoring per monitorare il consumo delle prenotazioni. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare dashboard o avvisi di Monitoring sono necessarie le seguenti autorizzazioni criteri per monitorare il consumo delle prenotazioni:

  • Per creare le dashboard: monitoring.dashboards.create del progetto
  • Per creare avvisi relativi ai criteri: monitoring.alertPolicies.create del 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, le relative serie temporali diventano disponibili entro 30 minuti.

  • Quando una serie temporale diventa disponibile, Monitoring avvia aggiornarlo almeno una volta ogni 30 minuti.

  • Se elimini una prenotazione, vengono eliminate anche le relative serie temporali e non possono essere recuperato.

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

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

Metriche delle prenotazioni

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

  • Riservato: il numero di istanze di macchina virtuale (VM) prenotate in ogni nel progetto attuale.

  • 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 o una metrica di valutazione. Per ulteriori informazioni sui filtri disponibili per prenotazioni, consulta Filtri di prenotazione in questo documento.

Filtri per le prenotazioni

Puoi utilizzare i filtri di Monitoring Raggruppare o filtrare i dati delle serie temporali associati a una o più prenotazioni. Nello specifico, durante la creazione di dashboard o avvisi di Monitoring, , puoi limitare i dati delle serie temporali che utilizzano specificando uno o tra le seguenti:

Selettore Nome dell'etichetta Descrizione
metadata.system machine_type Il tipo di macchina specificato nel di VM prenotate 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 account riservato risorse tramite una prenotazione. Puoi monitorerà 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 un 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 quindi il valore da filtrare. Ad esempio, se vuoi che la query filtri per la zona us-central1-a, usa il seguente filtro:

resource.location = "us-central1-a"

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

Monitora 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 avvisi criteri per inviare avvisi quando i dati delle serie temporali sono associati al consumo le tue prenotazioni raggiungono una soglia definita.

    Questo metodo è utile quando, ad esempio, vuoi ricevere una notifica quando di VM utilizzate nel progetto attuale è inferiore a un rapporto specifico o quando la 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 Query di base per visualizzare rapidamente quale le prenotazioni in una zona specifica non sono ancora state consumate completamente.

  • MQL: questo metodo è utile per recuperare, filtrare e manipolare le 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.

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

    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 località.

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

    3. Nell'elenco Valore, seleziona la zona da utilizzare per filtrare le tue 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 Monitoring utilizzando la query di base, crea una Richiesta di POST inviata a 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 progetto.

  • FILTER: filtro Monitoring per la tua dashboard. Ad esempio, per monitorare il consumo 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 personalizzare le dashboard di Monitoring utilizzando l'API Monitoring, consulta Creare e gestire le dashboard tramite 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.

    Si apre 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 prenotate nelle tue prenotazioni, seguenti:

    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 Monitoring utilizzando MQL, crea un POST richiesta alla 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 VM utilizzate e VM prenotate VM nelle 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 Monitoring per ricevere notifiche sul consumo delle prenotazioni nell'ambiente utilizzando la console Google Cloud e l'API Monitoring.

Quando definisci una condizione per un criterio di avviso, devi utilizzare una delle seguenti opzioni: 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 le serie temporali per creare condizioni di avviso più complesse.

    Ad esempio, puoi utilizzare Monitoring Query Language (MQL) per crea una condizione di avviso che viene attivata quando il rapporto di VM prenotate al consumo di VM raggiunge una soglia specifica.

Query di base

L'esempio seguente crea un criterio di avviso che invia un avviso una notifica quando una prenotazione viene consumata 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 Monitoring utilizzando Basic Query, segui questi passaggi:

  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 per nome risorsa o metrica, inserisci Reservation.

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

      1. Deseleziona Mostra solo risorse attive e metriche.

        Viene visualizzato l'elenco Risorse inattive.

      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 una delle etichette disponibili filtri 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) (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 condizione, 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 dispone di dati per un un momento specifico, seleziona Assenza metrica.

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

    Ad esempio, seleziona Soglia (impostazione predefinita).

  9. Nell'elenco Trigger di avviso, seleziona la condizione che attiva avviso.

    Ad esempio, seleziona Qualsiasi violazione delle serie temporali (impostazione predefinita).

  10. Nell'elenco Posizione soglia, 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 del che hai 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 l'avviso. .

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

    Dove RESERVATION_NAME è il nome del che hai 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 attuale progetto.

  • RESERVATION_NAME: il nome di un elemento esistente che si trova nel progetto attuale.

  • 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 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 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 un avviso una notifica ogni volta che la percentuale di VM utilizzate per le VM prenotate 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.

    Si apre 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 oltre il 90% delle prenotazioni consumato, 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 trigger di avviso.

  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, quindi segui i passaggi per creare canali di notifica. Per ulteriori informazioni, vedi 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. Questo 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 Monitoring utilizzando MQL, crea una Richiesta di POST inviata a 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 prenotate è superiore al 90% nell'attuale delle prenotazioni del progetto, 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 ulteriori informazioni sulla creazione di criteri di avviso utilizzando API Monitoring e MQL, consulta Crea criteri di avviso (API) MQL.

Risoluzione dei problemi

Scopri come risolvere i problemi relativi al monitoraggio della prenotazione.

Passaggi successivi