Cloud Monitor:Créer une alerte globale pour les limites de débit des API

Cas d'utilisation

Un volume élevé d'appels d'API peut entraîner une limitation fréquente du débit (throttling), ce qui affecte la stabilité de votre activité. Au lieu de configurer des règles d'alerte individuelles pour chaque API, une règle d'alerte globale surveille toutes les limites de débit d'un service cloud et permet une planification proactive des quotas.

Vous pouvez surveiller l'utilisation et les quotas globaux des API via la console ou les opérations d'API.

Facturation

Les règles d'alerte de limite de débit des API consomment votre quota de notifications CloudMonitor. La facturation varie selon la méthode de notification :

• Appels téléphoniques : aucun quota gratuit n'est inclus. Vous devez activer le paiement à l'utilisation ou acheter un plan de ressources. Pour plus d'informations, consultez les rubriques Paiement à l'utilisation et Plans de ressources.

• Messages SMS : un quota gratuit de 1 000 messages par mois est inclus. Si vous dépassez ce quota gratuit, vous devez activer le paiement à l'utilisation ou acheter un plan de ressources. Pour plus d'informations, consultez les rubriques Quotas gratuits, Paiement à l'utilisation et Plans de ressources.

• E-mail et rappel d'alerte : ces deux options sont gratuites.

Prérequis

• Créez un contact d'alerte et un groupe de contacts d'alerte dans la console CloudMonitor. Pour plus d'informations, consultez la rubrique Créer un contact d'alerte ou un groupe de contacts d'alerte.

• Si vous utilisez un utilisateur RAM pour gérer les alertes de quota, cet utilisateur doit disposer des autorisations d'administrateur Quota Center (AliyunQuotasFullAccess) ainsi que des permissions nécessaires pour créer et supprimer des alertes de quota dans CloudMonitor.

  Le code suivant présente un exemple de politique d'autorisation. Pour plus d'informations, consultez les rubriques Créer une politique d'autorisation personnalisée et Gérer les autorisations d'un utilisateur RAM.

  {
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "cms:PutMetricRuleTargets",
          "cms:PutResourceMetricRules",
          "cms:DeleteMetricRules",
          "cms:DeleteMetricRuleTargets"
        ],
        "Resource": "*"
      }
    ],
    "Version": "1"
  }

Créer une alerte globale à l'aide de la console

Cet exemple crée une règle d'alerte globale pour toutes les limites de débit des API Compute Nest, déclenchée lorsque l'utilisation atteint 80 %. Une notification de niveau Avertissement est envoyée par SMS et e-mail au groupe de contacts d'alerte.

Utilisez la console Quota Center ou la console CloudMonitor.

Créer une alerte globale à l'aide d'une API

Cet exemple crée une règle d'alerte globale pour toutes les limites de débit des API Compute Nest, déclenchée lorsque l'utilisation atteint 80 %. Une notification de niveau Avertissement est envoyée par SMS et e-mail au groupe de contacts d'alerte.

1. Vérifiez que le service cloud cible (Compute Nest) prend en charge les règles d'alerte globales pour les limites de débit des API.

   Appelez l'opération ListProductQuotas et vérifiez le paramètre de réponse UsageMetric. Une valeur non vide pour UsageMetric indique la prise en charge des règles d'alerte globales.

   • Paramètres de requête : définissez ProductCode sur computenest et QuotaCategory sur FlowControl. Conservez les valeurs par défaut pour les autres paramètres.

   • Paramètres de réponse : l'objet UsageMetric contient les informations de surveillance des limites de débit des API provenant de CloudMonitor. La valeur MetricNamespace est acs_quotas_flowcontrol. Exemple de réponse pour une limite de débit d'API :

     {
           "QuotaDescription": "GetServiceTemplateParameterConstraints",
           "Consumable": false,
           "ProductCode": "computenest",
           "UsageMetric": {
             "MetricName": "Usage",
             "MetricDimensions": {
               "productCode": "computenest",
               "metricKey": "GetServiceTemplateParameterConstraints/2021-06-01",
               "regionId": "ap-southeast-1",
               "label": "none"
             },
             "MetricNamespace": "acs_quotas_flowcontrol"
           },
           "Dimensions": {
             "apiName": "GetServiceTemplateParameterConstraints",
             "apiVersion": "2021-06-01",
             "regionId": "ap-southeast-1"
           },
           "GlobalQuota": false,
           "Period": {
             "PeriodValue": 1,
             "PeriodUnit": "second"
           },
           "Adjustable": true,
           "QuotaActionCode": "f_4w8uhd",
           "QuotaName": "GetServiceTemplateParameterConstraints",
           "QuotaArn": "acs:quotas:ap-southeast-1:14133977********:quota/computenest/f_4w8uhd",
           "TotalQuota": 50,
           "QuotaCategory": "FlowControl"
         }

     Remarque

     metricKey est utilisé pour créer une règle d'alerte pour une limite de débit d'API unique et spécifiée.

2. Appelez l'opération DescribeMetricList pour interroger les données de surveillance des limites de débit des API. Utilisez les tendances d'utilisation pour déterminer les seuils d'alerte.

   • Paramètres de requête : définissez Namespace sur acs_quotas_flowcontrol, MetricName sur UsagePercentage et Dimensions sur [{"productCode":"computenest"}]. Conservez les valeurs par défaut pour les autres paramètres.

     Remarque

     Les valeurs possibles pour MetricName dans Quota Center incluent : Quota (valeur du quota), Usage (utilisation du quota), UsagePercentage (pourcentage d'utilisation du quota) et AvailablePercentage (pourcentage de quota disponible).

   • Paramètres de retour : le champ Value dans Datapoints peut servir de référence pour le seuil d'alerte. Exemple de réponse :

     {
       "RequestId": "2A7DB5BF-825C-51BB-AD91-D728857792F9",
       "Period": "60",
       "Datapoints": "[{\"timestamp\":1727337180000,\"productCode\":\"computenest\",\"metricKey\":\"GetServiceTemplateParameterConstraints/2021-05-21\",\"regionId\":\"cn-hangzhou\",\"label\":\"none\",\"userId\":\"14133977********\",\"Value\":2.0}]",
       "Code": "200",
       "Success": true
     }

3. Appelez l'opération PutResourceMetricRules pour créer une règle d'alerte globale pour les limites de débit des API.

   • Paramètres de requête : le tableau suivant répertorie les paramètres requis et des exemples de valeurs.

     Paramètre	Description	Exemple
     MetricName	Nom de la métrique. Valeurs valides : Quota : valeur du quota Usage : utilisation du quota UsagePercentage : pourcentage d'utilisation AvailablePercentage : pourcentage disponible Remarque Les règles d'alerte globales ne peuvent utiliser que UsagePercentage et AvailablePercentage.	UsagePercentage
     Escalations.Warn.Threshold	Seuil pour les alertes de niveau Avertissement.	80
     EffectiveInterval	Période effective de la règle d'alerte.	00:00-23:59 +0800 dayofweek 1,2,3,4,5,6,7
     RuleId	ID de la règle d'alerte.	quota-computenest-ruleid-test
     Escalations.Warn.ComparisonOperator	Opérateur de comparaison pour le seuil de niveau Avertissement. Valeurs valides : GreaterThanOrEqualToThreshold : supérieur ou égal à GreaterThanThreshold : supérieur à LessThanOrEqualToThreshold : inférieur ou égal à LessThanThreshold : inférieur à NotEqualToThreshold : différent de GreaterThanYesterday : augmentation en pourcentage par rapport à la même heure la veille LessThanYesterday : diminution en pourcentage par rapport à la même heure la veille GreaterThanLastWeek : augmentation en pourcentage par rapport à la même heure la semaine précédente LessThanLastWeek : diminution en pourcentage par rapport à la même heure la semaine précédente GreaterThanLastPeriod : augmentation en pourcentage par rapport à la période précédente LessThanLastPeriod : diminution en pourcentage par rapport à la période précédente	GreaterThanOrEqualToThreshold
     Resources	Informations sur la ressource. Remarque Pour créer une alerte pour une seule API, spécifiez le paramètre Resources comme suit : [{"productCode":"computenest","metricKey":"GetServiceTemplateParameterConstraints/2021-06-01"}].	[{"productCode":"computenest"}]
     ContactGroups	Groupe de contacts d'alerte.	CloudMonitor
     Namespace	Espace de noms de données du service cloud.	acs_quotas_flowcontrol
     RuleName	Nom de la règle d'alerte.	quota-computenest-rulename-test
     Escalations.Warn.Times	Nombre de périodes consécutives durant lesquelles la condition doit être remplie pour déclencher une alerte de niveau Avertissement.	3
     Escalations.Warn.Statistics	Méthode statistique pour une alerte de niveau Avertissement.	Value

   • Une réponse réussie indique que la règle a été créée.

     {
       "Message": "",
       "RequestId": "BE4CAC0F-A134-55BA-909B-FF62568FE884",
       "FailedListResult": {
         "Target": []
       },
       "Code": "200",
       "Success": true
     }

4. Appelez l'opération DescribeMetricRuleList pour vérifier la règle d'alerte en utilisant RuleName ou RuleId.

Documents connexes

• Créer une alerte pour une limite de débit d'API unique : Créer une règle d'alerte pour un quota

• Demander une augmentation de quota après une alerte : Créer une demande d'augmentation de quota

• Consulter les détails de la règle d'alerte : Consulter la liste et les détails des règles d'alerte

• Consulter l'historique des alertes : Consulter l'historique des alertes de quota