Ce document décrit les métriques de quota pour les API régionales et la limite pour chaque métrique. Il explique également comment mettre à jour vos tableaux de bord, règles d'alerte et requêtes Cloud Monitoring afin qu'ils utilisent les métriques régionales.
Métriques de quota pour API régionales
Les API régionales de Compute Engine qui ont utilisé les métriques de quotas mondiales sont migrées afin d'utiliser les métriques régionales. Les API globales continuent à utiliser les métriques globales et les limites de quota. Consultez la page Limites de débit des API pour les métriques globales.
Pour plus d'informations sur les méthodes qui utilisent les métriques régionales et les limites, consultez la page Limites de débit des API pour les métriques régionales.
Le tableau suivant répertorie toutes les métriques migrées des métriques de quotas de l'API mondiales vers les métriques régionales:
Métriques de quota d'API globales | Métriques de quota d'API régionales |
---|---|
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 |
Les métriques suivantes ne possèdent aucune API globale. Si vous référencez ces métriques dans les tableaux de bord, les alertes ou les requêtes Cloud Monitoring, vous devez les migrer vers les métriques régionales correspondantes.
Métriques de quota d'API globales | Métriques de quota d'API régionales |
---|---|
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 |
Les métriques suivantes ne disposent d'aucune API régionale ou zonale. Par conséquent, aucune modification n'est requise pour la migration de quotas de l'API régionale.
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/license_insert_requests
Migrer les métriques Cloud Monitoring
Lorsque vous migrez les métriques de quota existantes d'API vers les métriques de quota d'API régionales, vous devez mettre à jour manuellement les tableaux de bord, les alertes et les requêtes Cloud Monitoring pour utiliser des métriques régionales.
Mettre à jour le tableau de bord Cloud Monitoring pour utiliser les métriques régionales
Pour remplacer une règle d'alerte qui surveille une métrique de quota d'API globale par une métrique régionale, procédez comme suit:
- Dans Google Cloud Console, sélectionnez Surveillance.
- Dans le volet de navigation, sélectionnez Tableaux de bord.
- Sélectionnez le tableau de bord que vous souhaitez modifier pour utiliser une métrique régionale.
- Cliquez sur Modifier le tableau de bord.
Modifiez le filtre correspondant à la métrique que vous souhaitez migrer:
- Dans le champ Filtre, sélectionnez
quota_metric
. - Dans le champ Comparator (Comparateur), sélectionnez
=~
. Dans le champ Valeur, spécifiez le nom de la métrique pour le quota d'API régionale. Par exemple, le filtre
quota_metric =~ compute.googleapis.com/read_requests.*
utilise une expression régulière pour faire correspondre toutes les données de séries temporelles qui utilisent la métrique de quotacompute.googleapis.com/read_requests.*
.Pour en savoir plus sur les métriques, consultez la page Limites de débit des API pour les métriques régionales.
Cliquez sur OK pour enregistrer les modifications.
Facultatif: Si vous souhaitez afficher l'utilisation du quota par région, développez l'en-tête Affichage groupé et sélectionnez
location
dans le champ Grouper par.
- Dans le champ Filtre, sélectionnez
Cliquez sur Fermer l'éditeur.
Mettre à jour les règles d'alerte Cloud Monitoring pour utiliser les métriques de quota d'API régionales
Pour remplacer une règle d'alerte qui surveille une métrique de quota d'API globale par une métrique régionale, procédez comme suit:
- Dans Google Cloud Console, sélectionnez Surveillance.
- Dans le volet de navigation, sélectionnez Alertes. La page "Alertes" affiche des volets répertoriant les informations récapitulatives, les incidents et les règles d'alerte.
- Cliquez sur la règle d'alerte que vous souhaitez modifier pour utiliser une métrique régionale.
- Cliquez sur Modifier pour modifier la stratégie.
Modifiez le filtre correspondant à la métrique que vous souhaitez migrer:
- Dans le champ Filtre, sélectionnez
quota_metric
. - Dans le champ Comparator (Comparateur), sélectionnez
=~
. Dans le champ Valeur, spécifiez le nom de la métrique pour le quota d'API régionale. Par exemple, le filtre
quota_metric =~ compute.googleapis.com/read_requests.*
utilise une expression régulière pour faire correspondre toutes les données de séries temporelles qui utilisent la métrique de quotacompute.googleapis.com/read_requests.*
.Pour en savoir plus sur les métriques, consultez la page Limites de débit des API pour les métriques régionales.
Cliquez sur OK pour enregistrer les modifications apportées au filtre.
Facultatif: Si vous souhaitez recevoir une alerte par région pour la métrique régionale, développez l'en-tête Across time series (Pour l'ensemble des séries temporelles) et sélectionnez
location
dans le champ Time series group by (Séries temporelles groupées par).
- Dans le champ Filtre, sélectionnez
Cliquez sur Enregistrer la règle.
Mettre à jour les requêtes Cloud Monitoring pour utiliser les métriques régionales de quota
Pour modifier la métrique de quota dans une règle d'alerte basée sur MQL ou un graphique dans un tableau de bord, utilisez l'éditeur de requête et modifiez le filtre de requête. Consultez la page Utiliser l'éditeur de requête.
Ouvrez l'éditeur de requête et modifiez le filtre pour la métrique de requête comme indiqué dans l'exemple suivant:
Vous pouvez éventuellement regrouper l'alerte en fonction d'un emplacement à l'aide de l'opération group-by
: