Skip to main content
Active IQ Unified Manager
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Afficher les indicateurs de performance à l'aide des API

PDF

Active IQ Unified Manager vous fournit un ensemble d'API sous le /datacenter catégorie qui vous permet d'afficher les données de performances de vos clusters et objets de stockage dans un centre de données. Ces API récupèrent les données de performances des différents objets de stockage tels que les clusters, les nœuds, les LUN, les volumes, les agrégats, les machines virtuelles de stockage, les interfaces FC, les ports FC, les ports Ethernet et les interfaces IP.

Le /metrics et /analytics Les API offrent différentes vues des mesures de performances, grâce auxquelles vous pouvez accéder à différents niveaux de détails pour les objets de stockage suivants dans votre centre de données :

  • groupes

  • nœuds

  • machines virtuelles de stockage

  • agrégats

  • volumes

  • LUN

  • Interfaces FC

  • Ports FC

  • Ports Ethernet

  • Interfaces IP

Le tableau suivant établit une comparaison entre les /metrics et /analytics API concernant les détails des données de performances récupérées.

Métrique Analytique

Détails des performances pour un seul objet. Par exemple, le /datacenter/cluster/clusters/{key}/metrics L'API nécessite que la clé du cluster soit saisie comme paramètre de chemin pour récupérer les métriques de ce cluster spécifique.

Détails des performances de plusieurs objets du même type dans un centre de données. Par exemple, le /datacenter/cluster/clusters/analytics L'API récupère les métriques collectives de tous les clusters d'un centre de données.

Exemple de mesures de performances pour un objet de stockage basé sur le paramètre d'intervalle de temps pour la récupération.

La valeur agrégée de haut niveau des performances pour un certain type d'objet de stockage pendant une certaine période (supérieure à 72 heures).

Les détails de base de l'objet sont récupérés, tels que les détails d'un nœud ou d'un cluster.

Aucun détail spécifique n'est récupéré.

Les compteurs accumulés, tels que les valeurs de performances minimales, maximales, du 95e centile et moyennes sur une période donnée, sont récupérés pour un seul objet, tel que les compteurs de lecture, d'écriture, de total et autres.

Une seule valeur agrégée est affichée pour tous les objets du même type.

La plage horaire et les données d'échantillon sont basées sur le calendrier suivant : La plage horaire pour les données. Les exemples peuvent être 1h, 12h, 1j, 2j, 3j, 15j, 1s, 1m, 2m, 3m, 6m. Vous obtenez des échantillons d'une heure si la plage est supérieure à 3 jours (72 heures), sinon ce sont des échantillons de 5 minutes. La période pour chaque plage horaire est la suivante :

  • 1h : Mesures sur l'heure la plus récente échantillonnées sur 5 minutes.

  • 12h : Mesures sur les 12 heures les plus récentes échantillonnées sur 5 minutes.

  • 1d : Mesures sur la journée la plus récente échantillonnées sur 5 minutes.

  • 2d : Mesures sur les 2 derniers jours échantillonnés sur 5 minutes.

  • 3d : Mesures sur les 3 derniers jours échantillonnées sur 5 minutes.

  • 15j : métriques sur les 15 derniers jours échantillonnés sur 1 heure.

  • 1 semaine : métriques sur la semaine la plus récente échantillonnées sur 1 heure.

  • 1m : métriques sur le mois le plus récent échantillonnées sur 1 heure.

  • 2m : métriques sur les 2 derniers mois échantillonnés sur 1 heure.

  • 3m : métriques sur les 3 derniers mois échantillonnées sur 1 heure.

  • 6 m : métriques sur les 6 derniers mois échantillonnées sur 1 heure.

    Valeurs disponibles : 1h, 12h, 1j, 2j, 3j, 15j, 1s, 1m, 2m, 3m, 6m

    Valeur par défaut : 1h

Plus de 72 heures. La durée sur laquelle cet échantillon est calculé est représentée dans le format standard ISO-8601.

Exemple de sortie pour les API de métriques

Par exemple, le /datacenter/cluster/nodes/{key}/metrics L'API récupère les détails suivants (entre autres) pour un nœud :

Remarque Le 95e percentile dans la valeur récapitulative indique que 95 % des échantillons collectés pour la période ont une valeur de compteur inférieure à la valeur spécifiée comme 95e percentile. 
{
     "iops": {
       "local": {
         "other": 100.53,
         "read": 100.53,
         "total": 100.53,
         "write": 100.53
       },
       "other": 100.53,
       "read": 100.53,
       "total": 100.53,
       "write": 100.53
     },
     "latency": {
       "other": 100.53,
       "read": 100.53,
       "total": 100.53,
       "write": 100.53
     },
     "performance_capacity": {
       "available_iops_percent": 0,
       "free_percent": 0,
       "system_workload_percent": 0,
       "used_percent": 0,
       "user_workload_percent": 0
     },
     "throughput": {
       "other": 100.53,
       "read": 100.53,
       "total": 100.53,
       "write": 100.53
     },
     "timestamp": "2018-01-01T12:00:00-04:00",
     "utilization_percent": 0
   }
 ],
 "start_time": "2018-01-01T12:00:00-04:00",
 "summary": {
   "iops": {
     "local_iops": {
       "other": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       },
       "read": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       },
       "total": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       },
       "write": {
         "95th_percentile": 28,
         "avg": 28,
         "max": 28,
         "min": 5
       }
     },

Exemple de sortie pour les API d'analyse

Par exemple, le /datacenter/cluster/nodes/analytics L'API récupère les valeurs suivantes (entre autres) pour tous les nœuds :

{     "iops": 1.7471,
     "latency": 60.0933,
     "throughput": 5548.4678,
     "utilization_percent": 4.8569,
     "period": 72,
     "performance_capacity": {
       "used_percent": 5.475,
       "available_iops_percent": 168350
     },
     "node": {
       "key": "37387241-8b57-11e9-8974-00a098e0219a:type=cluster_node,uuid=95f94e8d-8b4e-11e9-8974-00a098e0219a",
       "uuid": "95f94e8d-8b4e-11e9-8974-00a098e0219a",
       "name": "ocum-infinity-01",
       "_links": {
         "self": {
           "href": "/api/datacenter/cluster/nodes/37387241-8b57-11e9-8974-00a098e0219a:type=cluster_node,uuid=95f94e8d-8b4e-11e9-8974-00a098e0219a"
         }
       }
     },
     "cluster": {
       "key": "37387241-8b57-11e9-8974-00a098e0219a:type=cluster,uuid=37387241-8b57-11e9-8974-00a098e0219a",
       "uuid": "37387241-8b57-11e9-8974-00a098e0219a",
       "name": "ocum-infinity",
       "_links": {
         "self": {
           "href": "/api/datacenter/cluster/clusters/37387241-8b57-11e9-8974-00a098e0219a:type=cluster,uuid=37387241-8b57-11e9-8974-00a098e0219a"
         },
     "_links": {
       "self": {
         "href": "/api/datacenter/cluster/nodes/analytics"
       }
     }
   },

Liste des API disponibles

Le tableau suivant décrit les /metrics et /analytics Les API en détail.

Remarque

Les IOPS et les mesures de performances renvoyées par ces API sont des valeurs doubles, par exemple 100.53 . Le filtrage de ces valeurs flottantes par les caractères pipe (|) et générique (*) n'est pas pris en charge.
Verbe HTTP Chemin Description

GET

/datacenter/cluster/clusters/{key}/metrics

Récupère les données de performances (échantillon et résumé) pour un cluster spécifié par le paramètre d'entrée de la clé de cluster. Des informations telles que la clé du cluster et l'UUID, la plage horaire, les IOPS, le débit et le nombre d'échantillons sont renvoyées.

GET

/datacenter/cluster/clusters/analytics

Récupère les mesures de performances de haut niveau pour tous les clusters d'un centre de données. Vous pouvez filtrer vos résultats en fonction des critères requis. Des valeurs telles que les IOPS agrégées, le débit et la période de collecte (en heures) sont renvoyées.

GET

/datacenter/cluster/nodes/{key}/metrics

Récupère les données de performances (échantillon et résumé) pour un nœud spécifié par le paramètre d'entrée de la clé de nœud. Des informations telles que l'UUID du nœud, la plage horaire, le résumé des IOPS, le débit, la latence et les performances, le nombre d'échantillons collectés et le pourcentage utilisé sont renvoyés.

GET

/datacenter/cluster/nodes/analytics

Récupère les mesures de performances de haut niveau pour tous les nœuds d'un centre de données. Vous pouvez filtrer vos résultats en fonction des critères requis. Des informations, telles que les clés de nœud et de cluster, ainsi que des valeurs, telles que les IOPS agrégées, le débit et la période de collecte (en heures) sont renvoyées.

GET

/datacenter/storage/aggregates/{key}/metrics

Récupère les données de performances (échantillon et résumé) pour un agrégat spécifié par le paramètre d'entrée de la clé d'agrégat. Des informations telles que la plage horaire, le résumé des IOPS, la latence, le débit et la capacité de performance, le nombre d'échantillons collectés pour chaque compteur et le pourcentage utilisé sont renvoyés.

GET

/datacenter/storage/aggregates/analytics

Récupère des mesures de performances de haut niveau pour tous les agrégats d'un centre de données. Vous pouvez filtrer vos résultats en fonction des critères requis. Des informations, telles que les clés agrégées et de cluster, ainsi que des valeurs, telles que les IOPS agrégées, le débit et la période de collecte (en heures) sont renvoyées.

GET

/datacenter/storage/luns/{key}/metrics

/datacenter/storage/volumes/{key}/metrics

Récupère les données de performances (échantillon et résumé) pour un LUN ou un partage de fichiers (volume) spécifié par le paramètre d'entrée de la clé LUN ou de volume. Des informations telles que le résumé du minimum, du maximum et de la moyenne des IOPS de lecture, d'écriture et totales, la latence et le débit, ainsi que le nombre d'échantillons collectés pour chaque compteur sont renvoyées.

GET

/datacenter/storage/luns/analytics

/datacenter/storage/volumes/analytics

Récupère les mesures de performances de haut niveau pour tous les LUN ou volumes d'un centre de données. Vous pouvez filtrer vos résultats en fonction des critères requis. Des informations, telles que les clés de cluster et de machine virtuelle de stockage, ainsi que des valeurs, telles que les IOPS agrégées, le débit et la période de collecte (en heures) sont renvoyées.

GET

/datacenter/svm/svms/{key}/metrics

Récupère les données de performances (échantillon et résumé) pour une machine virtuelle de stockage spécifiée par le paramètre d'entrée de la clé de machine virtuelle de stockage. Résumé des IOPS en fonction de chaque protocole pris en charge, tel que nvmf, fcp, iscsi, et nfs , le débit, la latence et le nombre d'échantillons collectés sont renvoyés.

GET

/datacenter/svm/svms/analytics

Récupère les mesures de performances de haut niveau pour toutes les machines virtuelles de stockage d'un centre de données. Vous pouvez filtrer vos résultats en fonction des critères requis. Des informations telles que l'UUID de la machine virtuelle de stockage, les IOPS agrégées, la latence, le débit et la période de collecte (en heures) sont renvoyées.

GET

/datacenter/network/ethernet/ports/{key}/metrics

Récupère les mesures de performances pour un port Ethernet spécifique spécifié par le paramètre d'entrée de la clé de port. Lorsqu'un intervalle (plage de temps) est fourni à partir de la plage prise en charge, l'API renvoie les compteurs accumulés, tels que les valeurs de performances minimales, maximales et moyennes sur la période.

GET

/datacenter/network/ethernet/ports/analytics

Récupère les mesures de performances de haut niveau pour tous les ports Ethernet de votre environnement de centre de données. Des informations telles que la clé du cluster et du nœud et l'UUID, le débit, la période de collecte et le pourcentage d'utilisation des ports sont renvoyées. Vous pouvez filtrer le résultat en fonction des paramètres disponibles, tels que la clé de port, le pourcentage d'utilisation, le nom du cluster et du nœud et l'UUID, etc.

GET

/datacenter/network/fc/interfaces/{key}/metrics

Récupère les mesures de performances pour une interface FC réseau spécifique spécifiée par le paramètre d'entrée de la clé d'interface. Lorsqu'un intervalle (plage de temps) est fourni à partir de la plage prise en charge, l'API renvoie les compteurs accumulés, tels que les valeurs de performances minimales, maximales et moyennes sur la période.

GET

/datacenter/network/fc/interfaces/analytics

Récupère les mesures de performances de haut niveau pour tous les ports Ethernet de votre environnement de centre de données. Des informations telles que la clé et l'UUID de l'interface cluster et FC, le débit, les IOPS, la latence et la machine virtuelle de stockage sont renvoyées. Vous pouvez filtrer le résultat en fonction des paramètres disponibles, tels que le nom et l'UUID du cluster et de l'interface FC, la machine virtuelle de stockage, le débit, etc.

GET

/datacenter/network/fc/ports/{key}/metrics

Récupère les mesures de performances pour un port FC spécifique spécifié par le paramètre d'entrée de la clé de port. Lorsqu'un intervalle (plage de temps) est fourni à partir de la plage prise en charge, l'API renvoie les compteurs accumulés, tels que les valeurs de performances minimales, maximales et moyennes sur la période.

GET

/datacenter/network/fc/ports/analytics

Récupère les mesures de performances de haut niveau pour tous les ports FC de votre environnement de centre de données. Des informations telles que la clé du cluster et du nœud et l'UUID, le débit, la période de collecte et le pourcentage d'utilisation des ports sont renvoyées. Vous pouvez filtrer le résultat en fonction des paramètres disponibles, tels que la clé de port, le pourcentage d'utilisation, le nom du cluster et du nœud et l'UUID, etc.

GET

/datacenter/network/ip/interfaces/{key}/metrics

Récupère les mesures de performances d'une interface IP réseau telles que spécifiées par le paramètre d'entrée de la clé d'interface. Lorsqu'un intervalle (plage de temps) est fourni à partir de la plage prise en charge, l'API renvoie des informations, telles que le nombre d'échantillons, les compteurs accumulés, le débit et le nombre de paquets reçus et transmis.

GET

/datacenter/network/ip/interfaces/analytics

Récupère les mesures de performances de haut niveau pour toutes les interfaces IP réseau de votre environnement de centre de données. Des informations telles que la clé et l'UUID du cluster et de l'interface IP, le débit, les IOPS et la latence sont renvoyées. Vous pouvez filtrer le résultat en fonction des paramètres disponibles, tels que le nom du cluster et de l'interface IP, l'UUID, les IOPS, la latence, le débit, etc.