Tous les produits
Search
Centre de documentation

ApsaraDB for OceanBase (Deprecated):DescribeMetricsDataV2

Dernière mise à jour :Aug 18, 2026

Retourne les données de métriques.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

InstanceId

string

Oui

L'identifiant du cluster OceanBase.

ob317v4uif****

Metrics

string

Oui

Les métriques. Séparez plusieurs métriques par des virgules (,). Exemple : "sql_all_count,sql_all_rt...".

sql_all_rt

StartTime

string

Oui

L'heure de début, au format AAAA-MM-JJThh:mm:ssZ.

2023-04-12T04:38:38Z

EndTime

string

Oui

L'heure de fin, au format AAAA-MM-JJThh:mm:ssZ.

2023-04-12T05:38:38Z

Labels

string

Oui

Une chaîne de paires clé-valeur séparées par des virgules (,). Chaque clé et sa valeur sont séparées par deux points (:). Les valeurs multiples d'une clé sont séparées par des points-virgules (;). Exemple : "clusterId:ob****,tenantId:t******;t*******,serverId:****,zoneId:cn-hangzhou-j". La chaîne ne peut contenir que les clés fixes suivantes :

  • clusterId : l'identifiant du cluster OceanBase.

  • tenantId : l'identifiant du tenant de la base de données OceanBase.

  • zoneId : l'identifiant de la zone.

  • serverId : l'identifiant du nœud OBServer.

clusterId:ob***

GroupByLabels

string

Oui

La ou les clés utilisées pour le regroupement. Séparez plusieurs clés par des virgules (,). Exemple : "clusterId,tenantId".

clusterId

SortMetricKey

string

Non

La colonne de tri.

tps

SortOrder

string

Non

La règle de tri. Valeurs valides :

  • ASC : par ordre croissant.

  • DESC : par ordre décroissant.

DESC

Limit

string

Non

La longueur du tableau de données renvoyé après le tri.

20

ReplicaType

string

Non

Le type de réplique. Les conditions de filtrage des nœuds sont configurées en fonction du type de réplique lors de l'interrogation des données de surveillance du cluster OceanBase.

  • Par défaut, le type de réplique n'est pas spécifié lors de l'interrogation des données de surveillance des clusters OceanBase ou du proxy d'accès. Si vous ne spécifiez pas le type de réplique lors de l'interrogation des données de surveillance d'un cluster OceanBase, les données de surveillance de tous les nœuds sont interrogées.

  • Si vous définissez le type de réplique sur FULL lors de l'interrogation des données de surveillance d'un cluster OceanBase, seules les données de surveillance des nœuds de réplique complète sont interrogées.

  • Si vous définissez le type de réplique sur READONLY lors de l'interrogation des données de surveillance d'un cluster OceanBase, seules les données de surveillance des nœuds de réplique en lecture seule sont interrogées.

FULL

Éléments de réponse

Élément

Type

Description

Exemple

object

Le résultat renvoyé par la requête.

RequestId

string

L'identifiant de la requête.

EE205C00-30E4-****-****-87E3A8A2AA0C

Data

array<object>

Les données renvoyées.

array<object>

Les données renvoyées.

Labels

object

L'étiquette de données.

string

Les détails de l'étiquette.

clusterId:ob********

Data

array<object>

Les données renvoyées.

array<object>

Les données renvoyées.

MetricValue

object

The metric data.

string

The metric data.

'load1': 1.29

Timestamp

integer

The timestamp.

1702434300

Exemples

JSON format

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": [
    {
      "Labels": {
        "key": "clusterId:ob********"
      },
      "Data": [
        {
          "MetricValue": {
            "key": "'load1': 1.29"
          },
          "Timestamp": 1702434300
        }
      ]
    }
  ]
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.