Tous les produits
Search
Centre de documentation

:Interroger les métriques de performance

Dernière mise à jour :Aug 19, 2026

Appelez l'opération DescribeDBInstancePerformance pour interroger les métriques de performance d'une instance.

Interrogez les performances d'une instance sur une plage horaire spécifique en fonction de ses métriques. La génération des métriques de performance dépend du moteur de base de données, de sa version, de l'édition RDS, de la fréquence de surveillance (ModifyDBInstanceMonitor) et de la plage d'interrogation :

  • Pour les instances n'exécutant pas MySQL sur RDS High-availability Edition avec des disques SSD standard ou ESSD, ainsi que pour celles n'exécutant pas MariaDB :

    • Fréquence de surveillance de 5 secondes

      • Si la plage d'interrogation dépasse sept jours, les métriques sont collectées à des intervalles d'un jour.

      • Si la plage d'interrogation est supérieure à un jour et inférieure ou égale à sept jours, les métriques sont collectées à des intervalles d'une heure.

      • Si la plage d'interrogation est comprise entre une heure et un jour (inclus), les métriques sont collectées à des intervalles d'une minute.

      • Si la plage d'interrogation est inférieure à une heure, les métriques sont collectées à des intervalles de 5 secondes.

    • Fréquence de surveillance de 60 secondes

      • Si la plage d'interrogation dépasse 30 jours, les métriques sont collectées à des intervalles d'un jour.

      • Si la plage d'interrogation est supérieure à sept jours et inférieure ou égale à 30 jours, les métriques sont collectées à des intervalles d'une heure.

      • Si la plage d'interrogation est inférieure ou égale à sept jours, les métriques sont collectées à des intervalles d'une minute.

    • Fréquence de surveillance de 300 secondes

      • Si la plage d'interrogation dépasse 30 jours, les métriques sont collectées à des intervalles d'un jour.

      • Si la plage d'interrogation est supérieure à sept jours et inférieure ou égale à 30 jours, les métriques sont collectées à des intervalles d'une heure.

      • Si la plage d'interrogation est inférieure ou égale à sept jours, les métriques sont collectées à des intervalles de 5 minutes.

  • Pour les instances exécutant MySQL sur RDS High-availability Edition avec des disques SSD standard ou ESSD, ainsi que pour celles exécutant MariaDB :

    • Si la plage d'interrogation dépasse 30 jours, les métriques sont collectées à des intervalles d'un jour.

    • Si la plage d'interrogation est supérieure à sept jours et inférieure ou égale à 30 jours, les métriques sont collectées à des intervalles d'une heure.

    • Si la plage d'interrogation est inférieure ou égale à sept jours, les métriques sont collectées à des intervalles d'une minute.

  • Pour les instances exécutant PostgreSQL avec des disques SSD locaux, SSD standard ou ESSD :

    • Si la plage d'interrogation est inférieure ou égale à une heure, les métriques sont collectées à des intervalles de 5 secondes.

    • Si la plage d'interrogation est inférieure ou égale à 2 heures, les métriques sont collectées à des intervalles de 10 secondes.

    • Si la plage d'interrogation est inférieure ou égale à 6 heures, les métriques sont collectées à des intervalles de 30 secondes.

    • Si la plage d'interrogation est inférieure ou égale à 12 heures, les métriques sont collectées à des intervalles d'une minute.

    • Si la plage d'interrogation est inférieure ou égale à un jour, les métriques sont collectées à des intervalles de 2 minutes.

    • Si la plage d'interrogation est inférieure ou égale à cinq jours, les métriques sont collectées à des intervalles de 10 minutes.

    • Si la plage d'interrogation est inférieure ou égale à 15 jours, les métriques sont collectées à des intervalles de 30 minutes.

    • Si la plage d'interrogation est inférieure ou égale à 30 jours, les métriques sont collectées à des intervalles d'une heure.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer par souci de simplicité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiDescribeDBInstancePerformance

Opération à effectuer. Définissez la valeur sur DescribeDBInstancePerformance.

DBInstanceIdStringOui rm-uf6wjk5xxxxxxx

ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer l'ID de l'instance.

KeyStringOuiMySQL_Sessions

Métrique de performance à interroger. Si vous saisissez plusieurs métriques, séparez-les par des virgules (,). Vous pouvez saisir jusqu'à 30 métriques. Pour plus d'informations, consultez la rubrique Paramètres de performance.

Remarque Si vous définissez le paramètre Key sur MySQL_SpaceUsage ou SQLServer_SpaceUsage, vous ne pouvez interroger la métrique que sur une journée.
StartTimeStringOui2012-06-08T15:00Z

Début de la plage d'interrogation. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mmZ. L'heure doit être exprimée en UTC.

Remarque L'intervalle entre l'heure de début et l'heure de fin doit être supérieur à la fréquence de surveillance. Sinon, cette opération peut renvoyer un tableau vide.
EndTimeStringOui2012-06-18T15:00Z

Fin de la plage d'interrogation. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mmZ. L'heure est affichée en UTC.

Remarque L'intervalle entre l'heure de début et l'heure de fin doit être supérieur à la fréquence de surveillance. Sinon, cette opération peut renvoyer un tableau vide.

Paramètres de réponse

Paramètre Type Exemple Description
EndTime String 2012-06-19T15:00Z

Fin de la plage d'interrogation. L'heure suit la norme ISO 8601 au format yyyy-MM-dd T HH:mm Z. L'heure est affichée en UTC.

StartTime String 2012-06-10T15:00Z

Début de la plage d'interrogation. L'heure suit la norme ISO 8601 au format yyyy-MM-dd T HH:mm Z. L'heure est affichée en UTC.

DBInstanceId String rm-uf6wjk5xxxxxxxxxx

ID de l'instance.

Engine String MySQL

Moteur de base de données de l'instance.

RequestId String A5409D02-D661-4BF3-8F3D-0A814D0574E7

ID de la requête.

PerformanceKeys Array of PerformanceKey

Tableau composé de métriques de performance.

PerformanceKey
Key String MySQL_Sessions

Nom de la métrique de performance.

ValueFormat String recv_k&sent_k

Format de renvoi de la valeur de la métrique de performance. Les différentes valeurs sont séparées par la chaîne &. Exemple : com_delete&com_insert&com_insert_select&com_replace.

Unit String KB

Unité de la métrique de performance.

Values Array of PerformanceValue

Tableau composé des valeurs de la métrique de performance au format suivant : {value1, value2, ...}.

PerformanceValue
Date String 2011-05-30T03:29:00Z

Date et heure d'enregistrement de la valeur de la métrique de performance. L'heure suit la norme ISO 8601 au format yyyy-MM-dd T HH:mm:ss Z. L'heure est affichée en UTC.

Value String 0,0&13,6

Valeur de la métrique de performance.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=DescribeDBInstancePerformance
&DBInstanceId= rm-uf6wjk5xxxxxxx
&Key=MySQL_Sessions
&StartTime=2012-06-08T15:00Z
&EndTime=2012-06-18T15:00Z
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeDBInstancePerformanceResponse>
    <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
    <DBInstanceID> rm-uf6wjk5xxxxxxx</DBInstanceID>
    <StartTime>2012-06-11T15:00Z</StartTime>
    <EndTime>2013-10-17T15:00Z</EndTime>
    <Engine>MySQL</Engine>
    <PerformanceKeys>
        <PerformanceKey>
            <Key>MySQL_NetworkTraffic</Key>
            <Unit>KB</Unit>
            <ValueFormat>recv_k&amp;sent_k</ValueFormat>
            <Values></Values>
        </PerformanceKey>
    </PerformanceKeys>
</DescribeDBInstancePerformanceResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
  "DBInstanceID" : " rm-uf6wjk5xxxxxxx",
  "StartTime" : "2012-06-11T15:00Z",
  "EndTime" : "2013-10-17T15:00Z",
  "Engine" : "MySQL",
  "PerformanceKeys" : {
    "PerformanceKey" : [ {
      "Key" : "MySQL_NetworkTraffic",
      "Unit" : "KB",
      "ValueFormat" : "recv_k&sent_k",
      "Values" : {
        "PerformanceValue" : [ ]
      }
    } ]
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.