Esegui la migrazione delle quote API dalle metriche globali alle metriche regionali

---

Questo documento descrive le metriche della quota per le API regionali e il limite per ogni metrica. Descrive inoltre come aggiornare le dashboard, le query e i criteri di avviso di Cloud Monitoring per utilizzare le metriche regionali.

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Metriche delle quote API regionali

Viene eseguita la migrazione delle API regionali di Compute Engine che utilizzavano le metriche della quota globale per utilizzare le metriche a livello di regione. Le API globali continuano a usare le metriche globali e i limiti di quota. Consulta la sezione Limiti di frequenza API per le metriche globali.

Per ulteriori informazioni sui metodi che utilizzano le metriche a livello di regione e i limiti, consulta Limiti di frequenza API per le metriche regionali.

La seguente tabella elenca tutte le metriche di cui viene eseguita la migrazione dalle metriche delle quote dell'API globale alle metriche regionali:

Metrica della quota API globale	Metrica della quota API regionale
compute.googleapis.com/default	compute.googleapis.com/default_per_region ^BETA
compute.googleapis.com/read_requests	compute.googleapis.com/read_requests_per_region ^BETA
compute.googleapis.com/list_requests	compute.googleapis.com/list_requests_per_region ^BETA
compute.googleapis.com/operation_read_requests	compute.googleapis.com/operation_read_requests_per_region ^BETA
compute.googleapis.com/heavy_weight_read_requests	compute.googleapis.com/heavy_weight_read_requests_per_region ^BETA
compute.googleapis.com/heavy_weight_write_requests	compute.googleapis.com/heavy_weight_write_requests_per_region ^BETA
compute.googleapis.com/global_resource_write_requests	compute.googleapis.com/global_resource_write_requests_per_region ^BETA

Le seguenti metriche non hanno API globali. Se fai riferimento a queste metriche nelle dashboard, negli avvisi o nelle query di Cloud Monitoring, devi eseguire la migrazione di queste metriche alle metriche regionali corrispondenti.

Metrica della quota API globale	Metrica della quota API regionale
compute.googleapis.com/simulate_maintenance_event_requests	compute.googleapis.com/simulate_maintenance_event_requests_per_region ^BETA
compute.googleapis.com/instance_list_referrers_requests	compute.googleapis.com/instance_list_referrers_requests_per_region ^BETA
compute.googleapis.com/get_serial_port_output_requests	compute.googleapis.com/get_serial_port_output_requests_per_region ^BETA
compute.googleapis.com/network_endpoint_write_requests	compute.googleapis.com/network_endpoint_write_requests_per_region ^BETA
compute.googleapis.com/network_endpoint_list_requests	compute.googleapis.com/network_endpoint_list_requests_per_region ^BETA

Le metriche seguenti non dispongono di API a livello di regione o di zona. Pertanto, non sono necessarie modifiche per la migrazione della quota API a livello di regione.

• compute.googleapis.com/project_set_common_instance_metadata_requests
• compute.googleapis.com/license_insert_requests

Esegui la migrazione delle metriche di Cloud Monitoring

Quando esegui la migrazione dalle metriche delle quote dell'API esistenti alle metriche delle quote dell'API regionali, devi aggiornare manualmente le dashboard, gli avvisi e le query di Cloud Monitoring per utilizzare le metriche regionali.

Aggiorna la dashboard di Cloud Monitoring per utilizzare le metriche regionali

Per cambiare un criterio di avviso che monitora una metrica della quota API globale in una metrica a livello di regione, segui questi passaggi:

1. Nella console Google Cloud, seleziona Monitoring.
2. Nel riquadro di navigazione, seleziona Dashboard.
3. Seleziona la dashboard da modificare per utilizzare una metrica regionale.
4. Fai clic su Modifica dashboard.

5. Modifica il filtro corrispondente alla metrica di cui vuoi eseguire la migrazione:

   1. Nel campo Filtro, seleziona quota_metric.
   2. Nel campo Comparator (Comparatore), seleziona =~.

   3. Nel campo Valore, specifica il nome della metrica per la quota API regionale. Ad esempio, il filtro quota_metric =~ compute.googleapis.com/read_requests.* utilizza un'espressione regolare per trovare corrispondenze di tutti i dati delle serie temporali che utilizzano la metrica di quota compute.googleapis.com/read_requests.*.

      

      Per saperne di più sulle metriche, consulta Limiti di frequenza API per le metriche regionali.

   4. Fai clic su Fine per salvare le modifiche.

   5. (Facoltativo) Se vuoi visualizzare l'utilizzo della quota per regione, espandi l'intestazione Raggruppati e seleziona location nel campo Raggruppa per.

6. Fai clic su Chiudi editor.

Aggiorna i criteri di avviso di Cloud Monitoring per utilizzare le metriche delle quote API regionali

Per cambiare un criterio di avviso che monitora una metrica della quota API globale in una metrica a livello di regione, segui questi passaggi:

1. Nella console Google Cloud, seleziona Monitoring.
2. Nel riquadro di navigazione, seleziona Avvisi. La pagina Avvisi mostra riquadri con informazioni di riepilogo, incidenti e criteri di avviso.
3. Fai clic sul criterio di avviso che vuoi modificare per utilizzare una metrica a livello di regione.
4. Fai clic su Modifica per modificare il criterio.

5. Modifica il filtro corrispondente alla metrica di cui vuoi eseguire la migrazione:

   1. Nel campo Filtro, seleziona quota_metric.
   2. Nel campo Comparator (Comparatore), seleziona =~.

   3. Nel campo Valore, specifica il nome della metrica per la quota API regionale. Ad esempio, il filtro quota_metric =~ compute.googleapis.com/read_requests.* utilizza un'espressione regolare per trovare corrispondenze di tutti i dati delle serie temporali che utilizzano la metrica di quota compute.googleapis.com/read_requests.*.

      

      Per saperne di più sulle metriche, consulta Limiti di frequenza API per le metriche regionali.

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

   5. (Facoltativo) Se vuoi ricevere un avviso per la metrica regionale, espandi l'intestazione In serie temporali e seleziona location nel campo Raggruppa di serie temporali per.

6. Fai clic su Salva criterio.

Aggiorna le query di Cloud Monitoring per utilizzare le metriche della quota a livello di regione

Per modificare la metrica della quota in un criterio di avviso basato su MQL o in un grafico in una dashboard, utilizza l'editor query e modifica il filtro delle query. Consulta Utilizzo dell'Editor query.

Apri l'Editor query e modifica il filtro per la metrica di query come mostrato nell'esempio seguente:

Se vuoi, puoi raggruppare l'avviso in base a una località utilizzando l'operazione group-by: