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, Trusted Cloud by S3NS 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.

La tabella seguente elenca tutte le metriche semplificate delle quote API che consolidano le metriche delle quote API esistenti:

Metriche delle quote API esistenti Metrica semplificata di quota API
compute.googleapis.com/list_requests Read requests per minute
compute.googleapis.com/global_readsBETA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Metrica di quota esistente 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 esistente per i metodi globali che creano, modificano o eliminano risorse di Compute Engine.		 Mutation requests per minute
compute.googleapis.com/global_writesBETA
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 Read requests per minute per region
compute.googleapis.com/reads_per_regionBETA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Metrica di quota esistente 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 Mutation requests per minute per region
compute.googleapis.com/writes_per_regionBETA
compute.googleapis.com/default_per_region
Metrica di quota esistente 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 RegionInstances RecommendLocations requests per minute per region
compute.googleapis.com/recommend_locations_per_regionBETA
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requestsBETA

Utilizza metriche semplificate in 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.

Utilizza le metriche semplificate nelle dashboard di Cloud Monitoring

Per utilizzare una metrica di quota semplificata nelle dashboard:

  1. Nella console Trusted Cloud , vai a Monitoraggio:

    Vai a Monitoraggio

  2. Nel riquadro di navigazione, seleziona Dashboard.

  3. Seleziona la dashboard che desideri modificare per utilizzare una metrica semplificata.

  4. Fai clic su Modifica dashboard e aggiungi un widget.

  5. Aggiungi un filtro corrispondente alla metrica che vuoi monitorare:

    1. Nel campo Filtro, seleziona quota_metric.
    2. Nel campo Comparatore, seleziona =.
    3. Nel campo Valore, specifica il nome della metrica per la quota dell'API. Ad esempio, il filtro quota_metric = compute.googleapis.com/global_reads utilizza un'espressione regolare per trovare corrispondenze in tutti i dati delle serie temporali che utilizzano la metrica di quota compute.googleapis.com/global_reads.

  6. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti.

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

Per creare una policy di avviso per monitorare l'utilizzo di una metrica di quota API semplificata:

  1. Nella console Trusted 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. Fai clic su Crea policy per aggiungere una policy di avviso.

  4. Seleziona un filtro corrispondente alla metrica che vuoi monitorare:

    1. Nel campo Filtro, seleziona quota_metric.
    2. Nel campo Comparatore, seleziona =.
    3. Nel campo Valore, specifica il nome della metrica per la quota semplificata. Ad esempio, il filtro quota_metric = compute.googleapis.com/global_reads utilizza un'espressione regolare per trovare corrispondenze in tutti i dati delle serie temporali che utilizzano la metrica di quota compute.googleapis.com/global_reads.
    4. Fai clic su Fine per salvare le modifiche nel filtro.

  5. Fai clic su Salva policy.

Puoi anche utilizzare il provider Trusted Cloud by S3NS Terraform per creare policy di avviso nel tuo progettoTrusted Cloud . Per ulteriori informazioni, consulta Crea policy di avviso con Terraform.

Utilizza metriche di quota semplificate nelle query di Cloud Monitoring

Per utilizzare la metrica di quota semplificata in una policy di avviso basata su MQL o PromQL o in un grafico di una dashboard, utilizza l'editor di query e modifica il filtro delle query. Consulta Utilizzo dell'editor di query. Apri l'editor di query e aggiungi il filtro come mostrato negli esempi seguenti: MQL: 

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]
Nota: MQL verrà ritirato il 22 luglio 2025. Utilizza PromQL per creare le dashboard. Per ulteriori informazioni, consulta Ritiro di MQL. PromQL: 
   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 

   quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))