Outil d'ajustement de quota

Cette page explique comment ajuster les quotas à l'aide du système d'ajustement des quotas.

L'outil d'ajustement des quotas observe votre consommation de ressources et envoie de manière proactive des demandes d'ajustement de quota en votre nom. Surveiller votre utilisation des ressources et envoyer des demandes d'ajustement de quota de manière proactive permet d'éviter les pannes causées par l'atteinte de votre quota. L'utilisation de l'outil d'ajustement de quota réduit le besoin de surveiller les augmentations non planifiées de votre utilisation des ressources et vous permet d'envoyer moins de demandes manuelles d'ajustement des quotas.

Fonctionnement de l'outil d'ajustement de quota

Lorsque vous activez l'outil d'ajustement de quota, il surveille tous les quotas applicables et applique la logique suivante:

  • L'outil d'ajustement de quota vérifie si l'utilisation maximale s'est approchée de la valeur de quota pendant une durée spécifiée.
  • Si tel est le cas, l'outil d'ajustement de quota tente d'augmenter la valeur de quota (généralement d'environ 10 à 20 %).

S'il est possible d'augmenter la valeur de quota, l'augmentation est approuvée et la valeur est ajustée. Vous pouvez toujours demander à tout moment d'augmenter les valeurs de quota, que l'outil d'ajustement de quota soit activé ou non.

L'outil d'ajustement de quota n'envoie des demandes d'ajustement de quota que pour augmenter la valeur d'un quota. Il ne tente pas de réduire la valeur. Pour les quotas associés à un plafond de quota manuel, l'outil d'ajustement de quota n'envoie pas de demandes d'ajustement de quota.

Vous pouvez afficher les demandes effectuées par l'outil d'ajustement de quota sur la page "Quotas et limites du système" de la console Google Cloud. Vous pouvez également configurer des alertes pour surveiller les modifications initiées par l'outil d'ajustement de quota.

Limites

L'outil d'ajustement de quota présente les limites suivantes :

  • Les paramètres de l'outil d'ajustement des quotas ne sont disponibles que pour chaque projet.
  • Les paramètres de l'outil d'ajustement des quotas ne sont accessibles que depuis la console Google Cloud.

Disponibilité

L'outil d'ajustement de quota nécessite un volume suffisant de données d'historique d'utilisation afin de déterminer précisément quand demander un quota supplémentaire. Pour cette raison, l'option d'activation de l'outil d'ajustement de quota n'est disponible que pour les projets dont l'activité historique est suffisante pour permettre des prédictions précises.

Pour afficher la liste des quotas pouvant être ajustés par l'outil d'ajustement de quota, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Quotas et limites du système:

    Accéder à la page Quotas et limites du système

  2. Cliquez sur l'onglet Configurations pour afficher la liste.

    Vous pouvez également consulter le tableau suivant:

    Service Quotas
    API Compute Engine Processeurs C2
    API Compute Engine Processeurs C2D
    API Compute Engine Processeurs C3
    API Compute Engine Processeurs
    API Compute Engine Processeurs par famille de VM
    API Compute Engine Adresses IPv4 externes régionales utilisées
    API Compute Engine Processeurs N2
    API Compute Engine Processeurs N2D
    API Compute Engine Disque persistant SSD (Go)
    API Compute Engine Disque persistant standard (Go)
    API Compute Engine GPU NVIDIA A100 80 Go préemptifs
    API Compute Engine GPU NVIDIA A100 préemptifs
    API Compute Engine GPU NVIDIA H100 préemptifs
    API Compute Engine GPU NVIDIA H100 MEGA préemptifs
    API Compute Engine GPU NVIDIA K80 préemptifs
    API Compute Engine GPU NVIDIA L4 préemptifs
    API Compute Engine GPU de poste de travail virtuel NVIDIA L4 préemptifs
    API Compute Engine GPU NVIDIA P100 préemptifs
    API Compute Engine GPU de poste de travail virtuel NVIDIA P100 préemptifs
    API Compute Engine GPU NVIDIA P4 préemptifs
    API Compute Engine GPU de poste de travail virtuel NVIDIA P4 préemptifs
    API Compute Engine GPU NVIDIA T4 préemptifs
    API Compute Engine GPU de poste de travail virtuel NVIDIA T4 préemptifs
    API Compute Engine GPU NVIDIA V100 préemptifs

Activer l'outil d'ajustement de quota

Pour activer l'outil d'ajustement de quota, vous devez disposer des autorisations IAM suivantes :

  • cloudquotas.quotas.update
  • cloudquotas.quotas.get

Pour activer l'outil d'ajustement de quota sur votre projet Google Cloud, sélectionnez l'onglet approprié et suivez les instructions:

Console

Pour activer l'outil d'ajustement de quota sur votre Google Cloud projet depuis la console Google Cloud, procédez comme suit:

  1. Accédez à la page IAM et administration > Quotas et limites du système.

    Accéder à la page Quotas et limites du système

  2. Cliquez sur l'onglet Configurations.
  3. Cliquez sur le bouton Activer.

Lorsque la colonne État indique Activé, l'outil d'ajustement de quota surveille votre utilisation et émet des demandes d'ajustement de quota lorsque l'utilisation des ressources approche de sa valeur de quota.

REST

  1. Pour activer l'outil d'ajustement de quota dans votre Google Cloud projet à l'aide de l'API REST (Preview), envoyez une requête HTTP pour mettre à jour les paramètres de l'outil d'ajustement de quota:

    PATCH https://cloudquotas.googleapis.com/v1beta/projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
    
  2. Dans le corps de la requête, spécifiez la ressource de paramètres du correcteur de quota et définissez le champ enablement sur ENABLED. Vous pouvez également spécifier une balise ETag, mais ce n'est pas obligatoire:

    {
      name: projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
      enablement: ENABLED
      etag: OPTIONAL_ETAG
    }
    

    Remplacez les éléments suivants :

    • PROJECT_ID_OR_NUMBER: ID ou numéro du projet pour lequel vous souhaitez activer l'ajusteur de quota.
    • OPTIONAL_ETAG: chaîne ETag facultative pour les paramètres du correcteur de quota.

    L'état d'activation est alors défini sur enabled.

gcloud

Pour activer l'outil d'ajustement de quota sur votre Google Cloud projet à l'aide de la gcloud CLI (Preview), procédez comme suit:

  1. Authentifiez-vous à l'aide de la CLI gcloud:

    gcloud auth login
    
  2. Activez les paramètres de l'outil d'ajustement de quota:

    gcloud beta quotas adjuster settings update --project==PROJECT_ID_OR_NUMBER --enablement=enabled
    

    Remplacez PROJECT_ID_OR_NUMBER par l'ID ou le numéro du projet pour lequel vous souhaitez activer l'ajusteur de quota.

  3. Vérifiez l'état de l'activation:

    gcloud beta quotas adjuster settings describe --project=PROJECT_ID_OR_NUMBER
    

    Tant que vous disposez des autorisations requises, l'état est enabled.

Afficher les demandes d'ajustement de quota

Pour afficher les demandes d'augmentation de quota, vous devez disposer des autorisations IAM suivantes :

  • resourcemanager.projects.get
  • serviceusage.services.list
  • serviceusage.quotas.get

Pour afficher les demandes d'ajustement de quota émises par l'outil d'ajustement de quota :

  1. Accédez à la page IAM et administration > Quotas et limites du système.

    Accéder à la page Quotas et limites du système

  2. Cliquez sur l'onglet Augmenter les demandes. La vue Augmenter les demandes affiche les demandes d'augmentation pour votre projet, y compris les augmentations demandées manuellement et les demandes émises par l'outil d'ajustement de quota.
  3. Cliquez sur le champ Filtre.
  4. Sélectionnez Type dans le menu, puis saisissez Auto. Ce filtre permet de rechercher les demandes effectuées par l'outil d'ajustement de quota.

Configurer des alertes de l'outil d'ajustement de quota

Pour recevoir des alertes de l'outil d'ajustement de quota :

  1. Accédez à la page IAM et administration > Quotas et limites du système.

    Accéder à la page Quotas et limites du système

  2. Cliquez sur l'onglet Configurations.
  3. Cliquez sur Créer l'alerte.
  4. Choisissez l'un des modèles d'alerte, ou les deux :
    1. L'option Tous les ajustements de l'outil d'ajustement de quota envoie une alerte chaque fois que l'outil d'ajustement de quota émet une demande d'ajustement de quota pour le projet.
    2. Erreurs et échecs de l'outil d'ajustement de quota n'envoie des alertes que lorsque l'outil d'ajustement de quota tente d'augmenter une valeur de quota et qu'il ne peut pas le faire.
  5. (Facultatif) Ajustez les valeurs par défaut pour la durée minimale entre les alertes et la durée de la fermeture automatique de l'incident en cliquant sur Afficher les options.
  6. Sélectionnez le canal de notification pour recevoir les alertes. Pour ajuster les paramètres de votre canal de notification ou en créer un, cliquez sur Gérer les canaux de notification.
  7. Cliquez sur Créer.

Modifier ou supprimer des alertes de l'outil d'ajustement de quota

Vous pouvez modifier ou supprimer les alertes de l'outil d'ajustement des quotas dans la console Google Cloud :

  1. Accédez à la page Règles dans la console Cloud Monitoring.

    Accéder à "Règles"

  2. Recherchez votre règle d'alerte de l'outil d'ajustement de quota. Ces règles d'alerte portent les noms suivants :

    • Quota adjuster errors and failures
    • All adjustments by quota adjuster
  3. Dans la ligne affichant votre règle d'alerte de l'outil d'ajustement de quota, cliquez sur Afficher plus.

  4. Cliquez sur Modifier ou sur Supprimer.

Désactiver l'outil d'ajustement de quota

Pour désactiver l'outil d'ajustement de quota, vous devez disposer des autorisations IAM suivantes:

  • cloudquotas.quotas.update
  • cloudquotas.quotas.get

Pour désactiver l'outil d'ajustement de quota sur votre projet Google Cloud, sélectionnez l'onglet approprié et suivez les instructions:

Console

  1. Accédez à la page IAM et administration > Quotas et limites du système.

    Accéder à la page Quotas et limites du système

  2. Cliquez sur l'onglet Configurations.
  3. Cliquez sur le bouton Activer. Le bouton est grisé.

Lorsque le bouton est gris et que la colonne d'état indique Non activé, l'outil d'ajustement de quota ne surveille plus votre utilisation ni n'émet de demandes d'ajustement de quota.

REST

  1. Pour désactiver l'outil d'ajustement des quotas dans votre Google Cloud projet à l'aide de l'API REST (Preview), envoyez une requête HTTP pour mettre à jour les paramètres de l'outil d'ajustement des quotas:

    PATCH https://cloudquotas.googleapis.com/v1beta/projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
    
  2. Dans le corps de la requête, spécifiez la ressource de paramètres du correcteur de quota et définissez le champ enablement sur DISABLED. Vous pouvez également spécifier une balise ETag, mais ce n'est pas obligatoire:

    {
      name: projects/PROJECT_ID_OR_NUMBER/locations/global/quotaAdjusterSettings
      enablement: DISABLED
      etag: OPTIONAL_ETAG
    }
    

    Remplacez les éléments suivants :

    • PROJECT_ID_OR_NUMBER: ID ou numéro du projet pour lequel vous souhaitez désactiver l'ajusteur de quota.
    • OPTIONAL_ETAG: chaîne ETag facultative pour les paramètres du correcteur de quota.

    L'état d'activation est alors défini sur disabled.

gcloud

Pour désactiver l'outil d'ajustement de quota sur votre projet Google Cloud à l'aide de la gcloud CLI (Preview), procédez comme suit:

  1. Authentifiez-vous sur la CLI gcloud:

    gcloud auth login
    
  2. Désactivez les paramètres de l'outil d'ajustement de quota:

    gcloud beta quotas adjuster settings update --project==PROJECT_ID_OR_NUMBER --enablement=disabled
    

    Remplacez PROJECT_ID_OR_NUMBER par l'ID ou le numéro du projet pour lequel vous souhaitez désactiver l'ajusteur de quota.

  3. Vérifiez l'état de l'activation:

    gcloud beta quotas adjuster settings describe --project=PROJECT_ID_OR_NUMBER
    

    Tant que vous disposez des autorisations requises, l'état est disabled.

Résoudre les problèmes d'augmentation de quota

Il est possible qu'une augmentation de quota initiée par l'outil d'ajustement de quota soit refusée. Cela se produit parfois lorsque Google Cloud ne peut pas augmenter la valeur de quota pour un projet, une ressource ou une région spécifique. Vous pouvez toujours demander une augmentation manuelle du quota dans ces scénarios.

Pour recevoir des notifications lorsqu'une demande d'ajustement de quota effectuée par l'outil d'ajustement de quota est refusée, configurez des alertes de l'outil d'ajustement de quota.