Tous les produits
Search
Centre de documentation

:Interroger les métriques de surveillance avancée disponibles

Dernière mise à jour :Aug 08, 2026

Appelez l'opération DescribeAvailableMetrics pour interroger les métriques de surveillance avancée disponibles pour une instance ApsaraDB RDS for PostgreSQL.

Prérequis

Avant d'appeler cette opération, assurez-vous que l'instance exécute PostgreSQL.

Pour plus d'informations, consultez la rubrique Afficher les métriques de surveillance avancée d'une instance ApsaraDB RDS for PostgreSQL.

Débogage

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

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeAvailableMetrics

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

DBInstanceName

String

Oui

pgm-bp1s1j103lo6****

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

ResourceGroupId

String

Non

rg-acfmy*

ID du groupe de ressources auquel appartient l'instance.

Paramètres de réponse

Paramètre Type Exemple Description
TotalRecordCount Integer 4

Nombre total de métriques de surveillance avancée disponibles pour l'instance.

RequestId String 5CD61041-35F7-10F7-BE94-33A48B221218

ID de la requête.

Items Array of Metrics

Détails de la métrique de surveillance avancée.

GroupKey String os.cpu_usage

Clé du groupe auquel appartient la métrique de surveillance avancée.

SortRule Integer 1

Numéro de série de la métrique de surveillance avancée.

Description String OS CPU utilization, equal to the number of OS-consumed CPUs divided by the total number of CPUs

Description de la métrique de surveillance avancée.

Unit String %

Unité de la métrique de surveillance avancée.

MetricsKey String os.cpu_usage.sys.avg

Clé de la métrique de surveillance avancée.

GroupKeyType String CPU utilization

Nom du groupe auquel appartient la métrique de surveillance avancée.

MetricsKeyAlias String cpu_sys_per_core

Alias de la métrique de surveillance avancée.

Method String avg

Méthode d'agrégation des données de surveillance de la métrique. Valeurs valides :

  • avg : le système calcule la valeur moyenne de la métrique de surveillance avancée.
  • min : le système calcule la valeur minimale de la métrique de surveillance avancée.
  • max : le système calcule la valeur maximale de la métrique de surveillance avancée.
Dimension String os

Catégorie de la métrique de surveillance avancée. Valeurs valides :

  • os : métrique OS
  • db : métrique de base de données
DBInstanceName String rm-bp1*****

ID de l'instance.

Exemples

Exemple de requête

http(s)://rds.aliyun.cs/?Action=DescribeAvailableMetrics
&DBInstanceName=pgm-bp1s1j103lo6****
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<DescribeAvailableMetricsResponse>
<TotalRecordCount>2</TotalRecordCount>
<RequestId>A467D279-68A8-57B3-BDA4-35F8B3DDB1B7</RequestId>
<Items>
    <Description>OS CPU utilization, equal to the number of OS-consumed CPUs divided by the total number of CPUs</Description>
    <MetricsKey>os.cpu_usage.sys.avg</MetricsKey>
    <GroupKeyType>CPU utilization</GroupKeyType>
    <GroupKey>os.cpu_usage</GroupKey>
    <Method>avg</Method>
    <Dimension>os</Dimension>
    <Unit>%</Unit>
    <SortRule>1</SortRule>
    <DbType>pgsql</DbType>
    <MetricsKeyAlias>os.cpu_usage.sys</MetricsKeyAlias>
</Items>
<Items>
    <Description>User CPU utilization, equal to the number of user-consumed CPUs divided by the total number of CPUs</Description>
    <MetricsKey>os.cpu_usage.user.avg</MetricsKey>
    <GroupKeyType>CPU utilization</GroupKeyType>
    <GroupKey>os.cpu_usage</GroupKey>
    <Method>avg</Method>
    <Dimension>os</Dimension>
    <Unit>%</Unit>
    <SortRule>2</SortRule>
    <DbType>pgsql</DbType>
    <MetricsKeyAlias>os.cpu_usage.user</MetricsKeyAlias>
</Items>
</DescribeAvailableMetricsResponse>

Format JSON

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

{
  "TotalRecordCount" : 2,
  "RequestId" : "A467D279-68A8-57B3-BDA4-35F8B3DDB1B7",
  "Items" : [ {
    "Description": "OS CPU utilization, equal to the number of OS-consumed CPUs divided by the total number of CPUs",
    "MetricsKey" : "os.cpu_usage.sys.avg",
    "GroupKeyType": "CPU utilization",
    "GroupKey" : "os.cpu_usage",
    "Method" : "avg",
    "Dimension" : "os",
    "Unit" : "%",
    "SortRule" : 1,
    "DbType" : "pgsql",
    "MetricsKeyAlias" : "os.cpu_usage.sys"
  }, {
    "Description": "User CPU utilization, equal to the number of user-consumed CPUs divided by the total number of CPUs",
    "MetricsKey" : "os.cpu_usage.user.avg",
    "GroupKeyType": "CPU utilization",
    "GroupKey" : "os.cpu_usage",
    "Method" : "avg",
    "Dimension" : "os",
    "Unit" : "%",
    "SortRule" : 2,
    "DbType" : "pgsql",
    "MetricsKeyAlias" : "os.cpu_usage.user"
  } ]
}

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

400

InvalidDBInstanceEngineType.Format

the DB instance engine type does not support this operation.

L'opération n'est pas prise en charge par le moteur de base de données de l'instance.

404

InvalidDBInstanceName.NotFound

The database instance does not exist.

Le nom de l'instance est introuvable. Vérifiez le nom de l'instance et réessayez.

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