Questo documento descrive le metriche relative alle quote per le API regionali e il limite per ogni metrica. Inoltre, descrive come aggiornare le dashboard, i criteri di avviso e le query di Cloud Monitoring per utilizzare le metriche regionali.
Metriche relative alle quote API a livello di regione
È stata eseguita la migrazione delle API regionali di Compute Engine che utilizzavano le metriche relative alle quote globali in modo che utilizzino le metriche regionali. Le API globali continuano a utilizzare le metriche e i limiti di quota 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 dell'API per le metriche regionali.
La tabella seguente elenca tutte le metriche di cui viene eseguita la migrazione dalle metriche relative alle quote API globali alle metriche regionali:
| Metrica quota API globale | Metrica quota API a livello di regione |
|---|---|
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 quota API globale | Metrica quota API a livello di regione |
|---|---|
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 zonali. Pertanto, non sono necessarie modifiche per la migrazione delle quote API a livello di regione.
compute.googleapis.com/project_set_common_instance_metadata_requestscompute.googleapis.com/license_insert_requests
Esegui la migrazione delle metriche di Cloud Monitoring
Quando esegui la migrazione dalle metriche relative alle quote API esistenti alle metriche relative alle quote 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 modificare un criterio di avviso che monitora una metrica della quota API globale in una metrica regionale, segui questi passaggi:
- Nella console Google Cloud, seleziona Monitoraggio.
- Nel riquadro di navigazione, seleziona Dashboard.
- Seleziona la dashboard da modificare per utilizzare una metrica regionale.
- Fai clic su Modifica dashboard.
Modifica il filtro corrispondente alla metrica di cui vuoi eseguire la migrazione:
- Nel campo Filtro, seleziona
quota_metric. - Nel campo Comparatore, seleziona
=~. 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 in tutti i dati delle serie temporali che utilizzano la metrica quotacompute.googleapis.com/read_requests.*.
Per ulteriori informazioni sulle metriche, consulta Limiti di frequenza dell'API per le metriche regionali.
Fai clic su Fine per salvare le modifiche.
(Facoltativo) Se vuoi visualizzare l'utilizzo della quota per regione, espandi l'intestazione Raggruppato e seleziona
locationnel campo Raggruppa per.
- Nel campo Filtro, seleziona
Fai clic su Chiudi editor.
Aggiorna i criteri di avviso di Cloud Monitoring per utilizzare le metriche sulle quote API a livello di regione
Per modificare un criterio di avviso che monitora una metrica della quota API globale in una metrica regionale, segui questi passaggi:
- Nella console Google Cloud, seleziona Monitoraggio.
- Nel riquadro di navigazione, seleziona Avvisi. La pagina Avvisi mostra riquadri che elencano informazioni di riepilogo, incidenti e criteri di avviso.
- Fai clic sul criterio di avviso che vuoi modificare per utilizzare una metrica regionale.
- Fai clic su Modifica per modificare le norme.
Modifica il filtro corrispondente alla metrica di cui vuoi eseguire la migrazione:
- Nel campo Filtro, seleziona
quota_metric. - Nel campo Comparatore, seleziona
=~. 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 in tutti i dati delle serie temporali che utilizzano la metrica quotacompute.googleapis.com/read_requests.*.
Per ulteriori informazioni sulle metriche, consulta Limiti di frequenza dell'API per le metriche regionali.
Fai clic su Fine per salvare le modifiche nel filtro.
(Facoltativo) Se vuoi un avviso per regione per la metrica regionale, espandi l'intestazione Nelle serie temporali e seleziona
locationnel campo Raggruppa per serie temporali.
- Nel campo Filtro, seleziona
Fai clic su Salva criterio.
Aggiorna le query di Cloud Monitoring per utilizzare le metriche relative alle quote a livello di regione
Per modificare la metrica quota in un criterio di avviso basato su MQL o in un grafico di una dashboard, utilizza l'editor di query e modifica il filtro della query. Consulta Utilizzare l'editor di query.
Apri l'editor di query e modifica il filtro per la metrica della query come mostrato nell'esempio seguente:
Se vuoi, puoi raggruppare l'avviso in base a una località utilizzando l'operazione group-by:
