Alcune o tutte le informazioni in questa pagina potrebbero non essere applicabili a Trusted Cloud di S3NS.

Monitora l'utilizzo delle prenotazioni

Questo documento spiega come monitorare l'utilizzo delle prenotazioni delle risorse di zona di Compute Engine utilizzando Cloud Monitoring.

Monitoring raccoglie e archivia le informazioni sul rendimento dei servizi Trusted Cloud by S3NS 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:

Vedere come vengono utilizzate le prenotazioni utilizzando le dashboard di Monitoring.
Ricevere notifiche tempestive quando l'utilizzo delle tue prenotazioni è in uno stato specifico utilizzando le policy di avviso di Monitoring.

Questi metodi possono, ad esempio, aiutarti a verificare che le prenotazioni vengano utilizzate come previsto o ad agire in modo tempestivo 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 è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS 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.
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare dashboard di Monitoring o policy di avviso per monitorare l'utilizzo delle prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Monitoring Admin (roles/monitoring.admin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare dashboard di Monitoring o policy di avviso per monitorare l'utilizzo delle prenotazioni. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare dashboard di Monitoring o policy di avviso per monitorare l'utilizzo delle prenotazioni, sono necessarie le seguenti autorizzazioni:

Per creare dashboard: monitoring.dashboards.create sul progetto
Per creare avvisi sulle policy: monitoring.alertPolicies.create sul progetto

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

Limitazioni

Quando utilizzi Monitoring 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 ad 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 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 Monitoring o policy di avviso, devi prima selezionare la metricaTrusted Cloud per misurare il rendimento del servizio Trusted 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 utilizzate 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 delle prenotazioni in questo documento.

Filtri delle 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 policy 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 di zona riservate da una prenotazione. Puoi monitorare solo il tipo `instance`, che è un'istanza VM.
`metric`	`service_name`	Quando selezioni la metrica Utilizzate nella console Trusted Cloud , puoi visualizzare il prodotto Trusted Cloud che utilizza la prenotazione. Il valore può essere uno dei seguenti: `COMPUTE_ENGINE`: VM in Compute Engine `VERTEX_ONLINE_PREDICTION`: VM nei job di previsione di Vertex AI `VERTEX_TRAINING`: VM nei job di addestramento personalizzato di Vertex AI Se utilizzi le prenotazioni sia in Compute Engine sia in Vertex AI, crea un filtro per ogni valore precedente.
`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 tuo progetto.

Quando crei un filtro, devi specificare il selettore e il nome dell'etichetta, seguito da un operatore di confronto e dal valore da filtrare. Ad esempio, se vuoi che la query filtri le prenotazioni per la 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 l'utilizzo delle prenotazioni

Per monitorare l'utilizzo delle prenotazioni, seleziona uno dei seguenti metodi specificati in questo documento:

Crea una dashboard: crea delle dashboard di Monitoring e aggiungi widget alle aree dei grafici per visualizzare i dati delle serie temporali correlati all'utilizzo delle prenotazioni.

Questo metodo è utile quando, ad esempio, vuoi verificare che una VM stia utilizzando correttamente una prenotazione o confrontare la tendenza di utilizzo di più prenotazioni.
Crea policy di avviso: crea policy di avviso per inviare avvisi quando i dati delle serie temporali legati all'utilizzo 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 correlate all'utilizzo delle prenotazioni utilizzando la console Trusted 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:

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

Ad esempio, puoi utilizzare Basic Query per visualizzare rapidamente una delle tue prenotazioni in una zona specifica che non è ancora stata 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 VM utilizzate e VM prenotate nelle tue prenotazioni.

Suggerimento: per altri metodi per configurare le serie temporali delle prenotazioni in una dashboard di Monitoring, consulta PromQL in Cloud Monitoring.

Basic Query

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

Console

Per creare una dashboard di Monitoring utilizzando Basic Query:

Nella console Trusted Cloud , vai a Dashboard.

Vai a Dashboard
Fai clic su Crea dashboard.

Viene visualizzata la pagina Nuova dashboard.
Fai clic su Aggiungi widget.

Viene visualizzato il riquadro Aggiungi widget.
Fai clic su uno dei widget disponibili. Ad esempio, fai clic sul widget Linea.

Viene visualizzato il riquadro Configura widget.
Fai clic su Seleziona una metrica.
Nella finestra Seleziona una metrica, segui questi passaggi:
1. Inserisci Reservation, quindi seleziona Prenotazione.
  
  Importante: se non riesci a visualizzare la metrica Prenotazione, consulta Metrica non elencata nel menu.
2. Nell'elenco Categorie di metriche attive, seleziona nuovamente Prenotazione.
3. Nell'elenco Metriche attive, seleziona una delle metriche disponibili. Ad esempio, seleziona Usate.
4. Fai clic su Applica.
Per filtrare le prenotazioni in base a una zona specifica, segui questi passaggi:
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.
Fai clic su Applica.

Per altre opzioni per personalizzare le dashboard di Monitoring utilizzando la console Trusted Cloud , consulta Crea e gestisci dashboard personalizzate.

REST

Per creare una dashboard di Monitoring utilizzando Basic Query, 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": [
              {
                "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 di Monitoring 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 Monitoring utilizzando l'API Monitoring, consulta Crea e gestisci le dashboard utilizzando l'API.

MQL

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

Console

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

Nella console Trusted Cloud , vai a Dashboard.

Vai a Dashboard
Fai clic su Crea dashboard.

Viene visualizzata la pagina Nuova dashboard.
Fai clic su Aggiungi widget.

Viene visualizzato il riquadro Aggiungi widget.
Fai clic su uno dei widget disponibili. Ad esempio, fai clic sul widget Linea.

Viene visualizzato il riquadro Configura widget.
Fai clic su MQL.

Nell'editor di query, inserisci una query MQL. 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

Fai clic su Esegui query.
Fai clic su Applica.

Per altre opzioni per personalizzare le dashboard di Monitoring utilizzando la console Trusted Cloud , consulta Crea e gestisci dashboard personalizzate.

REST

Per creare una dashboard di Monitoring 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 del 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
```
Importante: per specificare una query MQL che si estende su più righe nel campo timeSeriesQueryLanguage, assicurati di includere il carattere \n alla fine di ogni riga.

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

Crea policy di avviso

Puoi creare policy di avviso per Monitoring per ricevere notifiche sull'utilizzo delle prenotazioni nel progetto corrente utilizzando la console Trusted Cloud e l'API Monitoring.

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

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

Ad esempio, puoi utilizzare Basic Query 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 prenotate e VM utilizzate raggiunge una soglia specifica.

Basic Query

L'esempio seguente crea una policy 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 utilizzate in una prenotazione è maggiore di 0.

Console

Per creare una policy di avviso di Monitoring utilizzando Basic Query:

Nella console Trusted Cloud , vai ad Avvisi.

Vai ad Avvisi
Fai clic su Crea policy.

Viene visualizzata la pagina Crea policy di avviso.
Fai clic su Seleziona una metrica.

Viene visualizzata la finestra Seleziona una metrica.
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 nell'elenco Risorse attive, selezionala. In caso contrario, segui questi passaggi:
  1. Disattiva Mostra solo risorse e metriche attive.
    
    Viene visualizzato l'elenco Risorse non attive.
  2. Nell'elenco Risorse non attive, seleziona Prenotazione.
    
    Importante: se ancora non riesci a visualizzare la metrica Prenotazione, consulta Metrica non elencata nel menu.
3. Nell'elenco Categorie di metriche attive, seleziona nuovamente Prenotazione.
  
  Viene visualizzato l'elenco Metriche attive.
4. Nell'elenco Metriche attive, seleziona una delle metriche disponibili.
  
  Ad esempio, seleziona Usate.
5. Fai clic su Applica.
Fai clic su Aggiungi filtro.

Viene visualizzata la sezione Aggiungi filtro.
Nella sezione Aggiungi filtro, segui questi passaggi:
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 nome.
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.
Fai clic su Avanti.

Viene visualizzato il riquadro Configura trigger di avviso.
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 Assenza 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).
Nell'elenco Trigger di avviso, seleziona la condizione che attiva l'avviso.

Ad esempio, seleziona Qualsiasi violazione della serie temporale (valore predefinito).
Nell'elenco Posizione soglia, seleziona quando deve attivarsi la condizione.

Ad esempio, seleziona Sopra la soglia.
Nel campo Valore soglia, inserisci un valore per la condizione.

Ad esempio, inserisci 0.
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.
Fai clic su Avanti.

Viene visualizzato il riquadro Configura le notifiche e finalizza l'avviso.
Fai clic su Usa canali di notifica.
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 Crea e gestisci canali di notifica.
Nel campo Durata chiusura automatica incidenti, seleziona una durata dopo la quale un incidente viene chiuso automaticamente.

Ad esempio, seleziona 3 giorni.
Nel campo Nome policy di avviso, inserisci un nome per la policy di avviso.

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

Dove RESERVATION_NAME è il nome della prenotazione specificato nei passaggi precedenti.
Fai clic su Avanti.

Si apre la pagina di revisione della condizione di avviso.
Fai clic su Crea policy.

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

Per saperne di più sulle opzioni disponibili per la creazione di policy di avviso utilizzando la console Trusted Cloud e Basic Query consulta Crea policy di avviso basati su metriche.

REST

Per creare una policy di avviso di Monitoring utilizzando Basic Query, 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 Monitoring da utilizzare per la policy 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 Crea e gestisci canali di notifica.

Per ulteriori informazioni sulle opzioni disponibili per la creazione di policy di avviso utilizzando l'API Monitoring e Basic Query, consulta Crea policy di avviso utilizzando l'API.

MQL

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

Console

Per creare una policy di avviso di Monitoring utilizzando MQL, segui questi passaggi:

Nella console Trusted Cloud , vai ad Avvisi.

Vai ad Avvisi
Fai clic su Crea policy.

Viene visualizzata la pagina Crea policy di avviso.
Nella barra degli strumenti, fai clic su MQL.

Viene visualizzato il riquadro Modifica query.
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 utilizzato 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)
```
Importante: per creare una condizione di avviso basata su MQL, devi utilizzare uno dei seguenti operatori alla fine della query:
- Per gli avvisi di soglia, specifica condition.
- Per gli avvisi di assenza, specifica absent_for.
Il tentativo di eseguire una query senza uno di questi operatori causa. Per saperne di più, consultaOperazioni di avviso MQL.
Per eseguire la query appena inserita, fai clic su Esegui query.
Fai clic su Avanti.

Viene visualizzato il riquadro Configura trigger di avviso.
In Nome condizione, inserisci un nome per la condizione.

Ad esempio, inserisci Over 90% of your reservations are consumed.
Fai di nuovo clic su Avanti.

Viene visualizzato il riquadro Configura le notifiche e finalizza l'avviso.
Fai clic su Usa canali di notifica.
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 Crea e gestisci canali di notifica.
Nel campo Durata chiusura automatica incidenti, seleziona una durata dopo la quale un incidente viene chiuso automaticamente.

Ad esempio, seleziona 3 giorni.
Nel campo Nome policy di avviso, inserisci un nome per la policy di avviso.

Ad esempio, inserisci Alert: over 90% of your reservations are consumed.
Fai clic su Avanti.

Si apre la pagina di revisione della condizione di avviso.
Fai clic su Crea policy.

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

Per saperne di più sulla creazione di policy di avviso utilizzando la consoleTrusted Cloud e MQL, consulta Crea policy di avviso MQL (console).

REST

Per creare una policy 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 corrente.
MQL_QUERY: una query MQL da utilizzare per la policy 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 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)
```
Importante: verifica quanto segue:
- Per specificare una query MQL che si estende su più righe nel campo query, includi il carattere \n alla fine di ogni riga.
- Per creare una condizione di avviso utilizzando una query MQL, devi utilizzare uno tra i seguenti operatori alla fine della query:
  - Per gli avvisi di soglia, specifica condition.
  - Per gli avvisi di assenza, specifica absent_for.
  Il tentativo di eseguire una query senza uno di questi operatori causa. Per saperne di più, consultaOperazioni di avviso MQL.
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 Crea e gestisci canali di notifica.

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

Passaggi successivi

Scopri come utilizzare le prenotazioni.
Scopri come collegare le prenotazioni agli impegni.
Scopri come modificare le prenotazioni.
Scopri come eliminare le prenotazioni.