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
Paramètres de requête
| Paramètre | Type | Obligatoire | Exemple | Description |
| Action | String | Oui | DescribeDBInstancePerformance | Opération à effectuer. Définissez la valeur sur DescribeDBInstancePerformance. |
| DBInstanceId | String | Oui | rm-uf6wjk5xxxxxxx | ID de l'instance. Appelez l'opération DescribeDBInstances pour récupérer l'ID de l'instance. |
| Key | String | Oui | MySQL_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. |
| StartTime | String | Oui | 2012-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. |
| EndTime | String | Oui | 2012-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&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.