Esegui la migrazione delle quote API dalle metriche globali a quelle a livello di regione

Il presente documento descrive le metriche relative alle quote delle API regionali e il limite per ogni metrica. Inoltre, descrive come aggiornare le dashboard, le policy di avviso e le query di Cloud Monitoring per utilizzare le metriche regionali.

Metriche delle quote per le API regionali

È stata eseguita la migrazione delle API regionali di Compute Engine che utilizzavano le metriche globali relative alle quote in modo che utilizzino le metriche regionali. Le API globali continuano a utilizzare i limiti di quota e le metriche globali. Consulta la sezione Limiti di frequenza delle richieste API per le metriche globali.

Per ulteriori informazioni sui metodi che utilizzano le metriche regionali e sui limiti, consulta Limiti di frequenza delle richieste API per le metriche regionali.

La tabella seguente elenca tutte le metriche di cui viene eseguita la migrazione dalle metriche globali relative alle quote delle API a quelle regionali:

Metrica relativa alla quota delle API globali	Metrica relativa alla quota delle API regionali
compute.googleapis.com/default	compute.googleapis.com/default_per_region
compute.googleapis.com/read_requests	compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests	compute.googleapis.com/list_requests_per_region
compute.googleapis.com/operation_read_requests	compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/heavy_weight_read_requests	compute.googleapis.com/heavy_weight_read_requests_per_region
compute.googleapis.com/heavy_weight_write_requests	compute.googleapis.com/heavy_weight_write_requests_per_region
compute.googleapis.com/global_resource_write_requests	compute.googleapis.com/global_resource_write_requests_per_region

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

Metrica relativa alla quota delle API globali	Metrica relativa alla quota delle API regionali
compute.googleapis.com/simulate_maintenance_event_requests	compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/instance_list_referrers_requests	compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/get_serial_port_output_requests	compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/network_endpoint_write_requests	compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/network_endpoint_list_requests	compute.googleapis.com/network_endpoint_list_requests_per_region

Le seguenti metriche non hanno API regionali o di zona. Pertanto, non sono necessarie modifiche per effettuare la migrazione delle quote delle API regionali.

• 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 relative alle quote delle API esistenti a quelle relative alle quote delle API regionali, per utilizzare le metriche regionali devi aggiornare manualmente le dashboard, gli avvisi e le query di Cloud Monitoring.

Aggiorna la dashboard di Cloud Monitoring per utilizzare le metriche regionali

Per trasformare una policy di avviso che monitora una metrica relativa alla quota dell'API globale in una metrica regionale, segui questi passaggi:

1. Nella console Trusted Cloud , seleziona Monitoraggio.
2. Nel riquadro di navigazione, seleziona Dashboard.
3. Seleziona la dashboard che desideri 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 Comparatore, seleziona =~.

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

      

      Per ulteriori informazioni sulle metriche, consulta Limiti di frequenza delle API per le metriche regionali.

   4. Fai clic su Fine per salvare le modifiche.

   5. (Facoltativo) Per visualizzare l'utilizzo delle quote per regione, espandi l'intestazione Valori raggruppati e seleziona location nel campo Raggruppa per.

6. Fai clic su Chiudi editor.

Aggiorna le policy di avviso di Cloud Monitoring per utilizzare le metriche relative alle quote API regionali

Per trasformare una policy di avviso che monitora una metrica relativa alla quota dell'API globale in una metrica regionale, segui questi passaggi:

1. Nella console Trusted Cloud , seleziona 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 sulla policy di avviso che vuoi modificare per utilizzare una metrica regionale.
4. Fai clic su Modifica per modificare le policy.

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

   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 regionale. Ad esempio, il filtro quota_metric =~ compute.googleapis.com/read_requests.* utilizza un'espressione regolare per trovare corrispondenze in tutti i dati delle serie temporali che utilizzano la metrica di quota compute.googleapis.com/read_requests.*.

      

      Per ulteriori informazioni sulle metriche, consulta Limiti di frequenza delle API per le metriche regionali.

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

   5. (Facoltativo) Per creare avvisi per ogni regione per la metrica regionale, espandi l'intestazione Tutte le serie temporali e seleziona location nel campo Raggruppa per serie temporali.

6. Fai clic su Salva policy.

Aggiorna le query di Cloud Monitoring per utilizzare le metriche regionali relative alle quote

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

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

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