Esegui la migrazione delle quote API dalle metriche globali a quelle a livello di regione
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
La tabella seguente elenca tutte le metriche di cui viene eseguita la migrazione dalle metriche globali relative alle quote delle API
a quelle regionali:
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.
Le seguenti metriche non hanno API regionali o di zona. Pertanto, non
sono necessarie modifiche per effettuare la migrazione delle quote delle API regionali.
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:
Nella console Google Cloud , seleziona Monitoraggio.
Nel riquadro di navigazione, seleziona Dashboard.
Seleziona la dashboard che desideri 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 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.*.
(Facoltativo) Per visualizzare l'utilizzo delle quote per regione,
espandi l'intestazione Valori raggruppati e seleziona location nel
campo Raggruppa per.
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:
Nella console Google Cloud , seleziona Monitoraggio.
Nel riquadro di navigazione, seleziona Avvisi.
La pagina Avvisi mostra riquadri che riportano informazioni di riepilogo, incidenti
e policy di avviso.
Fai clic sulla policy di avviso che vuoi modificare per utilizzare una metrica regionale.
Fai clic su Modifica per modificare le policy.
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 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.*.
Fai clic su Fine per salvare le modifiche nel filtro.
(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.
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:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 UTC."],[[["\u003cp\u003eCompute Engine regional APIs are migrating from global to regional quota metrics, while global APIs continue to use global metrics and limits.\u003c/p\u003e\n"],["\u003cp\u003eSeveral global API quota metrics are being replaced by corresponding regional metrics, requiring updates to Cloud Monitoring setups.\u003c/p\u003e\n"],["\u003cp\u003eSome metrics do not have global APIs, therefore you must migrate them to their regional counterpart.\u003c/p\u003e\n"],["\u003cp\u003eUpdating Cloud Monitoring dashboards, alerting policies, and queries to use regional metrics involves modifying filters to specify the new regional metric names, such as \u003ccode\u003ecompute.googleapis.com/read_requests_per_region\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSome metrics don't have regional or zonal APIs, so no migration is needed for them.\u003c/p\u003e\n"]]],[],null,["*** ** * ** ***\n\nThis document describes the quota metrics for regional APIs and the limit\nfor each metric. It also describes how to update your Cloud Monitoring\ndashboards, alerting policies and queries to use the regional metrics.\n\nRegional API quota metrics\n\nCompute Engine regional APIs that used the global quota metrics are\nmigrated to use the regional metrics. Global APIs continue to use the global\nmetrics and quota limits. See [API rate limits for global metrics](/compute/api-quota#api-rate-limits-global).\n\nFor more information about the methods that use the regional metrics and the\nlimits, see [API rate limits for regional metrics](/compute/api-quota#api-rate-limits-regional).\n\nThe following table lists all metrics that are migrated from the global API quota\nmetrics to regional metrics:\n\n| **Global API quota metric** | **Regional API quota metric** |\n|---------------------------------------------------------|--------------------------------------------------------------------|\n| `compute.googleapis.com/default` | `compute.googleapis.com/default_per_region` |\n| `compute.googleapis.com/read_requests` | `compute.googleapis.com/read_requests_per_region` |\n| `compute.googleapis.com/list_requests` | `compute.googleapis.com/list_requests_per_region` |\n| `compute.googleapis.com/operation_read_requests` | `compute.googleapis.com/operation_read_requests_per_region` |\n| `compute.googleapis.com/heavy_weight_read_requests` | `compute.googleapis.com/heavy_weight_read_requests_per_region` |\n| `compute.googleapis.com/heavy_weight_write_requests` | `compute.googleapis.com/heavy_weight_write_requests_per_region` |\n| `compute.googleapis.com/global_resource_write_requests` | `compute.googleapis.com/global_resource_write_requests_per_region` |\n\nThe following metrics don't have any global APIs. If you are referencing these\nmetrics in the Cloud Monitoring dashboards, alerts, or queries, you *must*\nmigrate these metrics to the corresponding regional metrics.\n\n| **Global API quota metric** | **Regional API quota metric** |\n|--------------------------------------------------------------|-------------------------------------------------------------------------|\n| `compute.googleapis.com/simulate_maintenance_event_requests` | `compute.googleapis.com/simulate_maintenance_event_requests_per_region` |\n| `compute.googleapis.com/instance_list_referrers_requests` | `compute.googleapis.com/instance_list_referrers_requests_per_region` |\n| `compute.googleapis.com/get_serial_port_output_requests` | `compute.googleapis.com/get_serial_port_output_requests_per_region` |\n| `compute.googleapis.com/network_endpoint_write_requests` | `compute.googleapis.com/network_endpoint_write_requests_per_region` |\n| `compute.googleapis.com/network_endpoint_list_requests` | `compute.googleapis.com/network_endpoint_list_requests_per_region` |\n\nThe following metrics don't have any regional or zonal APIs. Therefore, no\nchanges are required for regional API quota migration.\n\n- `compute.googleapis.com/project_set_common_instance_metadata_requests`\n- `compute.googleapis.com/license_insert_requests`\n\nMigrate Cloud Monitoring metrics\n\nWhen you migrate from the existing API quota metrics to the regional API quota\nmetrics, you must manually update the Cloud Monitoring dashboards, alerts, and\nqueries to use regional metrics.\n\nUpdate Cloud Monitoring dashboard to use the regional metrics\n\nTo change an alerting policy that monitors a global API quota metric to a\nregional metric, do the following:\n\n1. In the Google Cloud console, select **Monitoring**.\n2. In the navigation pane, select **Dashboards**.\n3. Select the dashboard that you want to edit to use a regional metric.\n4. Click **Edit dashboard**.\n5. Edit the filter that corresponds to the metric that you want to migrate:\n\n 1. In the **Filter** field, select `quota_metric`.\n 2. In the **Comparator** field, select `=~`.\n 3. In the **Value** field, specify the metric name for the regional API quota.\n For example, the filter `quota_metric =~ compute.googleapis.com/read_requests.*`\n uses a regular expression to match all time-series data that uses the quota\n metric `compute.googleapis.com/read_requests.*`.\n\n For more information about the metrics, See [API rate limits for regional metrics](/compute/api-quota#api-rate-limits-regional).\n 4. Click **Done** to save changes.\n\n 5. Optional: If you want to view the usage of quota per region,\n expand the **Grouped** header and select `location` in the\n **Group by** field.\n\n6. Click **Close editor**.\n\nUpdate Cloud Monitoring alerting policies to use the regional API quota metrics\n\nTo change an alerting policy that monitors a global API quota metric to a\nregional metric, do the following:\n\n1. In the Google Cloud console, select **Monitoring**.\n2. In the navigation pane, select **Alerting**. The Alerting page displays panes that list summary information, incidents, and alerting policies.\n3. Click the alerting policy that you want to edit to use a regional metric.\n4. Click **Edit** to modify the policy.\n5. Edit the filter that corresponds to the metric that you want to migrate:\n\n 1. In the **Filter** field, select `quota_metric`.\n 2. In the **Comparator** field, select `=~`.\n 3. In the **Value** field, specify the metric name for the regional API quota.\n For example, the filter `quota_metric =~ compute.googleapis.com/read_requests.*`\n uses a regular expression to match all time-series data that uses the quota\n metric `compute.googleapis.com/read_requests.*`.\n\n For more information about the metrics, see [API rate limits for regional metrics](/compute/api-quota#api-rate-limits-regional).\n 4. Click **Done** to save changes in the filter.\n\n 5. Optional: If you want per-region alert for the regional metric,\n expand the **Across time series** header and select `location` in the\n **Time series group by** field.\n\n6. Click **Save policy**.\n\nUpdate Cloud Monitoring queries to use the regional quota metrics\n\nTo change the quota metric in an MQL-based alerting policy or a chart in\na dashboard, use the Query Editor and edit the query filter. See\n[Using the Query Editor](/monitoring/mql/query-editor).\n\nOpen the Query Editor and edit the filter for query metric as shown in the following\nexample:\n\nOptionally, you can group the alert based on a location by using the `group-by`\noperation:"]]
