Commencez
Affichage des metrics de performances à l'aide d'API
Suggérer des modifications
PDF
Active IQ Unified Manager fournit un ensemble d'API sous /datacenter catégorie qui vous permet d'afficher les données de performance des clusters et des objets de stockage dans un data center. Ces API récupère les données de performance des différents objets de stockage tels que les clusters, les nœuds, les LUN, les volumes, les agrégats, Machines virtuelles de stockage, interfaces FC, ports FC, ports Ethernet et interfaces IP.
Le /metrics et /analytics Les API fournissent différentes vues des metrics de performance, et permettent d'accéder à différents niveaux de détails pour les objets de stockage suivants dans votre data Center :
-
clusters
-
nœuds
-
Machines virtuelles de stockage
-
64 bits
-
volumes
-
LUN
-
Interfaces FC
-
Ports FC
-
Ports Ethernet
-
Interfaces IP
Le tableau suivant établit une comparaison entre le /metrics et /analytics API en ce qui concerne les détails des données de performance récupérées.
| Métriques | Analytique |
|---|---|
Détails de performance pour un seul objet. Par exemple, le |
Détails de performance pour plusieurs objets du même type dans un data Center. Par exemple, le |
Des exemples de metrics de performances d'un objet de stockage basés sur le paramètre d'intervalle de temps pour la récupération. |
Valeur agrégée générale de performance pour un certain type d'objet de stockage pendant une certaine période (au-dessus de 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'a été récupéré. |
Les compteurs cumulés, tels que minimum, maximum, 95e percentile et les valeurs de performances moyennes sur une période de temps, sont récupérés pour un seul objet, tel que lecture, écriture, total et autres compteurs. |
Une valeur agrégée unique s'affiche 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 des données. Les exemples peuvent être 1h, 12h, 1d, 2d, 3d, 15d, 1 w, 1 m, 2 m, 3 m, 6 m. Vous obtenez des échantillons d'1 heure si la plage est supérieure à 3 jours (72 h) sinon il s'agit de 5 minutes d'échantillons. La période pour chaque plage horaire est la suivante :
|
Au-dessus de 72 heures. La durée de calcul de cet échantillon est représentée au format standard ISO-8601. |
Exemple de résultat pour les API de metrics
Par exemple, le /datacenter/cluster/nodes/{key}/metrics L'API récupère les détails suivants (entre autres) pour un nœud :
|
Les 95 percentiles de la valeur sommaire indiquent que 95 % des échantillons prélevés pour la période ont une valeur de compteur inférieure à la valeur indiquée comme percentile 95. |
{
"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 résultat pour les API d'analytique
Par exemple, le /datacenter/cluster/nodes/analytics L'API récupère les valeurs suivantes (entre autres) pour l'ensemble des 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 le /metrics et /analytics API dans les détails
|
|
Les mesures d'IOPS et de performance renvoyées par ces API sont des valeurs doubles, par exemple |
| Verb. HTTP | Chemin | Description |
|---|---|---|
|
|
Récupère les données de performances (échantillon et récapitulatif) d'un cluster spécifié par le paramètre d'entrée de la clé de cluster. Les informations telles que la clé de cluster et l'UUID, la plage horaire, les IOPS, le débit et le nombre d'échantillons sont renvoyées. |
|
|
Récupère les mesures de performance de haut niveau pour tous les clusters d'un data Center. 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. |
|
|
Récupère les données de performances (échantillon et récapitulatif) d'un nœud spécifié par le paramètre d'entrée de la clé de nœud. Les informations telles que l'UUID du nœud, la plage de temps, l'aperçu des IOPS, le débit, la latence et les performances, le nombre d'échantillons collectés et le pourcentage utilisés sont renvoyées. |
|
|
Récupère les mesures de performance de haut niveau pour tous les nœuds d'un data Center. Vous pouvez filtrer vos résultats en fonction des critères requis. Les informations telles que les clés de nœud et de cluster, ainsi que les valeurs telles que les IOPS agrégées, le débit et la période de collecte (en heures) sont renvoyées. |
|
|
Récupère les données de performances (échantillon et récapitulatif) d'un agrégat spécifié par le paramètre d'entrée de la clé d'agrégat. Les informations telles que la plage de temps, un récapitulatif des IOPS, de la latence, du débit et de la capacité des performances, le nombre d'échantillons collectés pour chaque compteur et le pourcentage utilisés sont renvoyées. |
|
|
Récupère les mesures de performances de haut niveau pour tous les agrégats du data Center. Vous pouvez filtrer vos résultats en fonction des critères requis. Les informations, telles que les clés d'agrégat et de cluster, ainsi que les valeurs telles que les IOPS agrégées, le débit et la période de collecte (en heures) sont renvoyées. |
|
|
Récupère les données de performances (échantillon et récapitulatif) d'une LUN ou d'un partage de fichiers (volume) spécifié par le paramètre d'entrée de la clé de volume ou de la LUN. Des informations telles que un récapitulatif des valeurs minimale, maximale et moyenne des valeurs totales d'IOPS, de latence et de débit, et le nombre d'échantillons prélevés pour chaque compteur est renvoyé. |
|
|
Récupère les mesures de performances de haut niveau pour toutes les LUN ou volumes d'un data Center. Vous pouvez filtrer vos résultats en fonction des critères requis. Les informations, telles que les machines virtuelles de stockage et les clés 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. |
|
|
Récupère les données de performances (échantillon et récapitulatif) d'une machine virtuelle de stockage spécifiée par le paramètre d'entrée de la clé de la machine virtuelle de stockage. Les IOPS sont récapitulatifs sur la base de chaque protocole pris en charge, comme |
|
|
Récupère les mesures de performances de haut niveau pour toutes les machines virtuelles de stockage d'un data Center. Vous pouvez filtrer vos résultats en fonction des critères requis. Les informations telles que l'UUID (UUID) du serveur virtuel de stockage, les IOPS agrégées, la latence, le débit et la période de collecte sont renvoyées (en heures). |
|
|
Récupère les mesures de performances d'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 minimum, maximum et les valeurs de performances moyennes sur la période de temps. |
|
|
Récupère les mesures de performances de haut niveau de tous les ports ethernet de l'environnement de votre datacenter. Les informations telles que la clé du cluster et des nœuds, ainsi que 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 par exemple en fonction des paramètres disponibles, par exemple la clé de port, le pourcentage d'utilisation, le nom du cluster, du nœud et son UUID, etc. |
|
|
Récupère les mesures de performances d'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 minimum, maximum et les valeurs de performances moyennes sur la période de temps. |
|
|
Récupère les mesures de performances de haut niveau de tous les ports ethernet de l'environnement de votre datacenter. Des informations telles que la clé du cluster et de l'interface FC, ainsi que l'UUID, le débit, les IOPS, la latence et la machine virtuelle de stockage sont renvoyés. Vous pouvez filtrer le résultat en fonction des paramètres disponibles, par exemple le nom du cluster et de l'interface FC, l'UUID, la machine virtuelle de stockage, le débit, etc. |
|
|
Récupère les metrics de performances d'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 minimum, maximum et les valeurs de performances moyennes sur la période de temps. |
|
|
Récupère les metrics de performance de haut niveau pour tous les ports FC de votre environnement de data Center. Les informations telles que la clé du cluster et des nœuds, ainsi que 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 par exemple en fonction des paramètres disponibles, par exemple la clé de port, le pourcentage d'utilisation, le nom du cluster, du nœud et son UUID, etc. |
|
|
Récupère les mesures de performances d'une interface IP réseau comme spécifié 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. |
|
|
Récupère les mesures de performances de haut niveau pour toutes les interfaces IP réseau de l'environnement de votre centre de données. Des informations telles que le cluster et l'interface IP, ainsi que l'UUID, le débit, les IOPS et la latence sont renvoyés. Vous pouvez filtrer le résultat par les paramètres disponibles, par exemple le nom du cluster et de l'interface IP, ainsi que l'UUID, les IOPS, la latence, le débit, etc. |