Utilizzare metriche semplificate delle quote API in Cloud Monitoring

Questo documento descrive come utilizzare le metriche semplificate relative alle quote dell'API Compute Engine nelle dashboard, nelle policy di avviso e nelle query di Cloud Monitoring.

Metriche semplificate delle quote API

Per migliorare la rilevabilità e la gestibilità della quota dell'API Compute Engine, Google Cloud ha ridotto il numero di metriche relative alle quote raggruppandole in un numero inferiore di gruppi di quote. Queste metriche delle quote semplificate offrono anche limiti più elevati per ciascun gruppo di quote.

Metriche legacy e semplificate delle quote API

La tabella seguente elenca le metriche delle quote API legacy e le relative metriche equivalenti semplificate:

Metriche delle quote API legacy Metrica semplificata di quota API
compute.googleapis.com/list_requests compute.googleapis.com/global_reads
Richieste di lettura al minuto
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Metrica di quota legacy per i metodi che elencano le risorse di Compute Engine.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
Metrica di quota legacy per i metodi globali che creano, modificano o eliminano risorse di Compute Engine.		 compute.googleapis.com/global_writes
Richieste di mutazione al minuto
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region compute.googleapis.com/reads_per_region
Richieste di lettura al minuto per regione
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Metrica di quota legacy per i metodi a livello di regione e zona che elencano le risorse di Compute Engine.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region compute.googleapis.com/writes_per_region
Richieste di mutazione al minuto per regione
compute.googleapis.com/default_per_region
Metrica di quota legacy per i metodi a livello di regione e zona che creano, modificano o eliminano risorse di Compute Engine.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region compute.googleapis.com/recommend_locations_per_region
Richieste RegionInstances RecommendLocations al minuto per regione
compute.googleapis.com/cache_invalidation_requests compute.googleapis.com/global_cache_invalidation_requests
Richieste di annullamento convalida della cache al minuto

Utilizza le metriche semplificate nelle dashboard di Cloud Monitoring

Per monitorare l'utilizzo dell'API Compute Engine rispetto alle metriche API semplificate, aggiungi filtri per queste metriche nelle dashboard, negli avvisi e nelle query di Cloud Monitoring.

Crea una dashboard che utilizza metriche semplificate della quota API

Per creare una dashboard che utilizza metriche semplificate:

  1. Nella console Google Cloud , vai a Monitoraggio:

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Dashboard.

  3. Fai clic su Crea dashboard personalizzata.

  4. Nella barra degli strumenti della dashboard, fai clic su Aggiungi widget e seleziona un tipo di widget (ad esempio, Grafico a linee). Si apre la pagina Configura widget.

  5. Nella sezione Seleziona una metrica, segui questi passaggi:

    1. Seleziona Quota consumer per la risorsa.
    2. Seleziona Quota per la categoria di metriche.
    3. Seleziona Utilizzo della quota di frequenza per la metrica e poi fai clic su Applica.

  6. Nella sezione Aggiungi filtro, utilizza il filtro quota_metric e seleziona la metrica della quota API semplificata corrispondente. Per trovare la metrica semplificata, consulta Metriche legacy e semplificate delle quote API.

  7. Fai clic su Applica per aggiungere il widget alla dashboard.

  8. Nella barra degli strumenti, fai clic su Salva per salvare la dashboard.

Modificare una dashboard che utilizza una metrica della quota legacy

Per aggiornare una dashboard che contiene una metrica legacy:

  1. Nella console Google Cloud , vai a Monitoraggio:

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Dashboard.

  3. Apri la dashboard contenente il grafico che deve essere aggiornato.

  4. Fai clic su Modifica.

  5. Trova il widget che vuoi aggiornare e modificalo.

  6. Nella sezione Seleziona una metrica, aggiorna il filtro contenente la metrica legacy:

    1. Nel campo Filtro, seleziona quota_metric.
    2. Nel campo Valore, aggiorna il valore corrente con la metrica della quota dell'API semplificata corrispondente. Per trovare la sostituzione della metrica legacy, consulta Metriche di quota API legacy e semplificate. Ad esempio, modifica compute.googleapis.com/read_requests in compute.googleapis.com/global_reads.

  7. Per applicare le modifiche, fai clic su Applica.

Utilizza le metriche semplificate delle quote API nelle policy di avviso di Cloud Monitoring

Per monitorare l'utilizzo dell'API Compute Engine rispetto alle metriche API semplificate, aggiungi filtri per queste metriche nelle policy di avviso di Cloud Monitoring.

Crea una criterio di avviso che utilizza metriche semplificate delle quote API

Per creare un criterio di avviso che utilizzi metriche semplificate:

  1. Nella console Google Cloud , vai a Monitoraggio:

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Avvisi.

  3. Fai clic su Crea policy.

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

    1. Seleziona Quota consumer per la risorsa.
    2. Seleziona Quota per la categoria di metriche.
    3. Seleziona Utilizzo della quota di frequenza per la metrica e poi fai clic su Applica.

  5. Nella sezione Aggiungi filtro, utilizza il filtro quota_metric e seleziona la metrica della quota API semplificata corrispondente. Per trovare la metrica semplificata, consulta Metriche legacy e semplificate delle quote API.

  6. Configura la condizione, i canali di notifica e la documentazione in base alle esigenze.

  7. Fai clic su Salva policy.

Puoi anche utilizzare il provider Google Cloud Terraform per creare policy di avviso nel tuo progettoGoogle Cloud . Per ulteriori informazioni, consulta Crea policy di avviso con Terraform.

Modificare una criterio di avviso che utilizza una metrica di quota legacy

Per aggiornare una policy di avviso esistente che utilizza una metrica di quota precedente:

  1. Nella console Google Cloud , vai a Monitoraggio:

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Avvisi. La pagina Avvisi mostra riquadri che riportano informazioni di riepilogo, incidenti e policy di avviso.

  3. Per modificare una policy esistente, fai clic sul nome della policy in Policy.

  4. Nella sezione Seleziona una metrica, aggiorna il filtro contenente la metrica legacy:

    1. Nel campo Filtro, seleziona quota_metric.
    2. Nel campo Valore, aggiorna il valore alla metrica della quota dell'API semplificata corrispondente. Per trovare la sostituzione della metrica legacy, consulta Metriche di quota API legacy e semplificate. Ad esempio, modifica compute.googleapis.com/read_requests in compute.googleapis.com/global_reads.

  5. Fai clic su Fine per salvare le modifiche nel filtro.

  6. Fai clic su Salva policy.

Utilizza metriche di quota semplificate nelle query di Cloud Monitoring

Per aggiornare una criterio di avviso basata su PromQL o un grafico in una dashboard, utilizza l'Editor query e modifica il filtro della query. Per ulteriori informazioni, consulta Utilizzare l'editor di codice per PromQL.

Per aggiornare la query, sostituisci il nome della metrica precedente nel filtro quota_metric con il nome della metrica semplificata corrispondente.

Esempio 1:

Query che utilizza una metrica legacy:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/read_requests"}[1m])

Query modificata utilizzando la metrica semplificata:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/global_reads"}[1m])

Esempio 2:

Query che utilizza una metrica legacy:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/heavy_weight_write_requests_per_region"}[1m])

Query modificata utilizzando la metrica semplificata:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/writes_per_region"}[1m])