Outil de recommandation de limites (quotas) de service

L'outil de recommandation de limite de service analyse l'utilisation des quotas de service par les projets de votre organisation et fournit des recommandations pour vous aider à identifier les ressources qui s'approchent de leurs limites de quota.

Présentation

Les limites de quota sont conçues pour vous aider à gérer les ressources et à vous protéger contre les pics d'utilisation imprévus. Toutefois, elles peuvent être difficiles à suivre et à gérer. L'outil de recommandation de limite de service analyse votre utilisation des quotas et vous fournit les fonctionnalités suivantes pour vous aider à détecter les goulots d'étranglement potentiels avant qu'ils ne deviennent un problème :

  • Recommandations pour examiner les quotas avec une utilisation élevée
  • Insights sur l'utilisation de chaque quota avec une utilisation élevée

La surveillance proactive et l'application des recommandations sur les quotas peuvent vous aider à réduire les risques d'épuisement des quotas. En plus des recommandations qui sont mises à jour une fois par jour, vous pouvez configurer des alertes d'utilisation des quotas à l'aide de Cloud Monitoring pour tous les quotas pouvant nécessiter une surveillance en temps réel.

Fonctionnement

L'outil de recommandation de limites de service analyse l'utilisation des quotas de débit, d'allocation et de simultanéité au cours des 30 derniers jours. Si, à un moment donné au cours de ces 30 jours, votre utilisation atteint 80 % de votre limite actuelle, une recommandation sera générée.

Tarifs

Veuillez consulter les tarifs de l'outil de recommandation.

Avant de commencer

Avant de pouvoir afficher les insights et les recommandations, vous devez effectuer les opérations suivantes :

  • Vous devez activer l'API Recommender. Vous n'avez besoin d'activer l'API que sur un seul projet. Vous pouvez ensuite utiliser ce même projet pour examiner des recommandations et des insights pour d'autres projets à l'aide de la fonctionnalité --billing-project de gcloud/API.
  • Assurez-vous que l'un des rôles requis est attribué :
Description Rôles
Afficher les recommandations recommender.serviceLimitViewer
Afficher et mettre à jour les recommandations recommender.serviceLimitAdmin

Ces rôles fournissent un ensemble d'autorisations permettant d'accéder aux insights et aux recommandations. Pour plus d'informations sur les rôles, consultez les sections Comprendre les rôles et Accorder des autorisations IAM.

Vous pouvez également désactiver tous les insights et recommandations sur les limites de service dans le Centre de contrôle et de transparence. Pour modifier les paramètres de désactivation, vous devez disposer du rôle IAM dataprocessing.admin. Pour en savoir plus sur la désactivation, consultez la section Désactiver les insights et les recommandations.

ID de l'outil de recommandation

Voici l'ID de l'outil de recommandation de limites de service (quotas) et le type d'insights :

  • google.resourcemanager.serviceLimit.Recommender
  • google.resourcemanager.serviceLimit.Insight

Autorisations IAM requises

Pour accéder à la liste des recommandations et insights sur les limites de service, vous devez disposer des autorisations suivantes :

  • recommender.resourcemanagerServiceLimitRecommendations.get
  • recommender.resourcemanagerServiceLimitRecommendations.list
  • recommender.resourcemanagerServiceLimitInsights.get
  • recommender.resourcemanagerServiceLimitInsights.list

Pour mettre à jour les recommandations et les insights (par exemple, pour ignorer une recommandation), vous devez disposer des autorisations suivantes :

  • recommender.resourcemanagerServiceLimitRecommendations.update
  • recommender.resourcemanagerServiceLimitInsights.update

Afficher les recommandations de limites de service (quota)

Les insights et les recommandations sont accessibles via la console Google Cloud, gcloud ou l'API Recommender pour tous les clients.

L'exportation de recommandations via BigQuery est également disponible pour les clients bénéficiant d'une formule d'assistance Standard, Advanced ou Premium.

Console

  1. Accédez au centre de recommandations. Consultez également la section Premiers pas avec le centre de recommandations.

    Accéder au hub de recommandations

  2. Sur la fiche Examiner et gérer l'utilisation des quotas, cliquez sur Tout afficher.

gcloud

Pour afficher les recommandations et les insights à l'aide de gcloud, procédez comme indiqué ci-dessous. Pour en savoir plus, consultez les pages Utiliser l'API – Insights et Utiliser l'API – Recommandations.

Recommandations

  1. Pour répertorier les recommandations pour le projet dans lequel vous avez activé l'API Recommender, exécutez la commande suivante :

      gcloud recommender recommendations list \
      --project=PROJECT_ID \
      --location=LOCATION \
      --recommender=google.resourcemanager.serviceLimit.Recommender
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet
    • LOCATION: région ou zone Cloud. Si un type de quota n'est pas défini au niveau régional ou zonal, il est placé à l'emplacement "global".
  2. Pour répertorier les recommandations dans un autre projet tout en utilisant un projet dans lequel vous avez activé l'API Recommender (comme à l'étape précédente), exécutez la commande suivante :

      gcloud recommender recommendations list \
      --billing-project=BILLING_PROJECT_ID \
      --project=PROJECT_ID \
      --location=LOCATION \
      --recommender=google.resourcemanager.serviceLimit.Recommender
    

    Remplacez les éléments suivants :

    • BILLING_PROJECT_ID : ID du projet que vous avez activé avec l'API Recommender (il s'agit de la même valeur PROJECT_ID que celle donnée à l'étape précédente).
    • PROJECT_ID : ID d'un autre projet pour lequel vous souhaitez afficher les recommandations.
    • LOCATION : région ou zone Cloud. Si un type de quota n'est pas défini au niveau régional ou zonal, il est placé à l'emplacement "global".

Insights

Un ensemble de commandes semblable peut être utilisé pour recenser des insights. Il vous suffit d'apporter deux modifications à chacune des commandes ci-dessus:

  • Au lieu d'exécuter gcloud recommender recommendations list, exécutez gcloud recommender insights list.
  • Au lieu de transmettre --recommender=google.resourcemanager.serviceLimit.Recommender, transmettez --insight-type=google.resourcemanager.serviceLimit.Insight.

Par exemple, pour répertorier les insights d'un projet donné, exécutez la commande suivante :

    gcloud recommender insights list 
--project=PROJECT_ID
--location=LOCATION
--insight-type=google.resourcemanager.serviceLimit.Insight

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet
  • LOCATION: région ou zone Cloud. Si un type de quota n'est pas défini au niveau régional ou zonal, il est placé à l'emplacement "global".

API

Pour afficher les recommandations et les insights, vous pouvez utiliser curl pour envoyer une requête aux API de l'outil de recommandation. Pour autoriser des requêtes à partir de la ligne de commande, vous utilisez des jetons d'accès OAuth. Un jeton d'accès OAuth est une chaîne qui accorde un accès temporaire à une API.

Recommandations

  1. Pour répertorier les recommandations pour le projet dans lequel vous avez activé l'API Recommender, exécutez la commande suivante :

    curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/\
    recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations"
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet
    • LOCATION: région ou zone Cloud. Si un type de quota n'est pas défini au niveau régional ou zonal, il est placé à l'emplacement "global".
  2. Pour répertorier les recommandations dans un autre projet tout en utilisant un projet dans lequel vous avez activé l'API Recommender (comme à l'étape précédente), exécutez la commande suivante :

    curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
    -H "x-goog-user-project: BILLING_PROJECT_ID" \
    "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/\
    recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations"
    

    Remplacez les éléments suivants :

    • BILLING_PROJECT_ID : ID du projet que vous avez activé avec l'API Recommender (il s'agit de la même valeur PROJECT_ID que celle donnée à l'étape précédente).
    • PROJECT_ID : ID d'un autre projet pour lequel vous souhaitez afficher les recommandations.
    • LOCATION : région ou zone Cloud. Si un type de quota n'est pas défini au niveau régional ou zonal, il est placé à l'emplacement "global".

Insights

Un ensemble de commandes semblable peut être utilisé pour recenser des insights. Il vous suffit pour cela de remplacer recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations par insightTypes/google.resourcemanager.serviceLimit.Insight/insights dans l'URL.

Par exemple, pour répertorier les insights d'un projet donné, exécutez la commande suivante :

  curl 
-H "Authorization: Bearer $(gcloud auth print-access-token)"
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/
insightTypes/google.resourcemanager.serviceLimit.Insight/insights"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet
  • LOCATION: région ou zone Cloud. Si un type de quota n'est pas défini au niveau régional ou zonal, il est placé à l'emplacement "global".

BigQuery Export

Vous pouvez également exporter les recommandations et les insights de manière groupée vers une table BigQuery. Pour en savoir plus, consultez la documentation sur l'exportation BigQuery.