Utiliser des métriques de quota d'API simplifiées dans Cloud Monitoring

---

Ce document explique comment utiliser les métriques de quota simplifiées de l'API Compute Engine dans vos tableaux de bord, règles d'alerte et requêtes Cloud Monitoring.

Preview

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Métriques de quota d'API simplifiées

Pour améliorer la visibilité et la gestion des quotas de l'API Compute Engine, Google Cloud a réduit le nombre de métriques de quota en les regroupant dans moins de groupes de quotas. Ces métriques de quota simplifiées offrent également des limites plus élevées pour chaque groupe de quota.

Le tableau suivant répertorie toutes les métriques de quota d'API simplifiées qui consolident les métriques de quota d'API existantes:

Métriques de quota d'API existantes	Métrique de quota d'API simplifiée
compute.googleapis.com/list_requests	Read requests per minute compute.googleapis.com/global_reads^BÊTA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default Métrique de quota existante pour les méthodes qui listent des ressources Compute Engine.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default Métrique de quota existante pour les méthodes globales qui créent, modifient ou suppriment des ressources Compute Engine.	Mutation requests per minute compute.googleapis.com/global_writes^BÊTA
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region	Read requests per minute per region compute.googleapis.com/reads_per_region^BÊTA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region Métrica de quota existante pour les méthodes régionales et zonales qui listent les ressources Compute Engine.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region	Mutation requests per minute per region compute.googleapis.com/writes_per_region^BÊTA
compute.googleapis.com/default_per_region Métrique de quota existante pour les méthodes régionales et zonales qui créent, modifient ou suppriment des ressources Compute Engine.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region	RegionInstances RecommendLocations requests per minute per region compute.googleapis.com/recommend_locations_per_region^BÊTA
compute.googleapis.com/cache_invalidation_requests	Cache invalidation requests per minute compute.googleapis.com/global_cache_invalidation_requests^BÊTA

Utiliser des métriques simplifiées dans Cloud Monitoring

Pour surveiller l'utilisation de l'API Compute Engine par rapport aux métriques d'API simplifiées, ajoutez des filtres pour ces métriques dans vos tableaux de bord, alertes et requêtes Cloud Monitoring.

Utiliser les métriques simplifiées dans les tableaux de bord Cloud Monitoring

Pour utiliser une métrique de quota simplifiée dans les tableaux de bord, procédez comme suit:

1. Dans Google Cloud Console, accédez à Monitoring.

   Accéder à Monitoring

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 simplifiée.

4. Cliquez sur Modifier le tableau de bord, puis ajoutez un widget.

5. Ajoutez un filtre correspondant à la métrique que vous souhaitez surveiller:

   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. Par exemple, le filtre quota_metric = compute.googleapis.com/global_reads 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/global_reads.

6. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils.

Utiliser les métriques de quota d'API simplifiées dans les règles d'alerte Cloud Monitoring

Pour créer une règle d'alerte afin de surveiller l'utilisation d'une métrique de quota d'API simplifiée, procédez comme suit:

1. Dans Google Cloud Console, accédez à Monitoring.

   Accéder à Monitoring

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 Créer une règle pour ajouter une règle d'alerte.

4. Sélectionnez un filtre correspondant à la métrique que vous souhaitez surveiller:

   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 simplifié. Par exemple, le filtre quota_metric = compute.googleapis.com/global_reads 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/global_reads.
   4. Cliquez sur OK pour enregistrer les modifications apportées au filtre.

5. Cliquez sur Enregistrer la règle.

Vous pouvez également utiliser le Google Cloud fournisseur Terraform pour créer des règles d'alerte dans votre projet Google Cloud. Pour en savoir plus, consultez la section Créer des règles d'alerte avec Terraform.

Utiliser des métriques de quota simplifiées dans les requêtes Cloud Monitoring

Pour utiliser la métrique de quota simplifiée dans une règle d'alerte basée sur MQL ou PromQL, ou dans un graphique d'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 ajoutez le filtre comme indiqué dans les exemples suivants : MQL:

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]

Remarque: Les requêtes marketing seront abandonnées le 22 juillet 2025. Utilisez PromQL pour créer vos tableaux de bord. Pour en savoir plus, consultez la page Abandon de MQL. PromQL:

   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 

   quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))