Migrer des quotas d'API des métriques globales aux métriques régionales

---

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.

Preview

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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^bêta
compute.googleapis.com/read_requests	compute.googleapis.com/read_requests_per_region^bêta
compute.googleapis.com/list_requests	compute.googleapis.com/list_requests_per_region^bêta
compute.googleapis.com/operation_read_requests	compute.googleapis.com/operation_read_requests_per_region^bêta
compute.googleapis.com/heavy_weight_read_requests	compute.googleapis.com/heavy_weight_read_requests_per_region^bêta
compute.googleapis.com/heavy_weight_write_requests	compute.googleapis.com/heavy_weight_write_requests_per_region^bêta
compute.googleapis.com/global_resource_write_requests	compute.googleapis.com/global_resource_write_requests_per_region^bêta

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^bêta
compute.googleapis.com/instance_list_referrers_requests	compute.googleapis.com/instance_list_referrers_requests_per_region^bêta
compute.googleapis.com/get_serial_port_output_requests	compute.googleapis.com/get_serial_port_output_requests_per_region^bêta
compute.googleapis.com/network_endpoint_write_requests	compute.googleapis.com/network_endpoint_write_requests_per_region^bêta
compute.googleapis.com/network_endpoint_list_requests	compute.googleapis.com/network_endpoint_list_requests_per_region^bêta

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:

1. Dans Google Cloud Console, sélectionnez Surveillance.
2. Dans le volet de navigation, sélectionnez Tableaux de bord.
3. Sélectionnez le tableau de bord que vous souhaitez modifier pour utiliser une métrique régionale.
4. Cliquez sur Modifier le tableau de bord.

5. Modifiez le filtre correspondant à la métrique que vous souhaitez migrer:

   1. Dans le champ Filtre, sélectionnez quota_metric.
   2. Dans le champ Comparator (Comparateur), sélectionnez =~.

   3. 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 quota compute.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.

   4. Cliquez sur OK pour enregistrer les modifications.

   5. 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.

6. 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:

1. Dans Google Cloud Console, sélectionnez Surveillance.
2. 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.
3. Cliquez sur la règle d'alerte que vous souhaitez modifier pour utiliser une métrique régionale.
4. Cliquez sur Modifier pour modifier la stratégie.

5. Modifiez le filtre correspondant à la métrique que vous souhaitez migrer:

   1. Dans le champ Filtre, sélectionnez quota_metric.
   2. Dans le champ Comparator (Comparateur), sélectionnez =~.

   3. 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 quota compute.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.

   4. Cliquez sur OK pour enregistrer les modifications apportées au filtre.

   5. 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).

6. 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: