Ver métricas de rendimiento mediante las API en Active IQ Unified Manager
Sugerir cambios
PDF
Active IQ Unified Manager te ofrece un conjunto de API en la categoría /datacenter que te permiten consultar los datos de rendimiento de tus clústeres y objetos de almacenamiento en un centro de datos. Estas API recuperan los datos de rendimiento de los distintos objetos de almacenamiento, como clústeres, nodos, LUN, volúmenes, agregados, máquinas virtuales de almacenamiento, interfaces FC, puertos FC, puertos Ethernet e interfaces IP.
Las API /metrics y /analytics ofrecen diferentes vistas de las métricas de rendimiento, con las que puedes profundizar en distintos niveles de detalle para los siguientes objetos de almacenamiento de tu centro de datos:
-
clústeres
-
nodos
-
máquinas virtuales de almacenamiento
-
agregados
-
volúmenes
-
LUN
-
Interfaces de FC
-
Puertos FC
-
Puertos Ethernet
-
Interfaces de IP
La siguiente tabla ofrece una comparación entre las API /metrics y /analytics en lo que respecta a los detalles de los datos de rendimiento obtenidos.
| Métricas | Análisis |
|---|---|
Detalles de rendimiento de un único objeto. Por ejemplo, la API |
Detalles de rendimiento de varios objetos del mismo tipo en un centro de datos. Por ejemplo, la |
Ejemplo de métricas de rendimiento para un objeto de almacenamiento basadas en el parámetro de intervalo de tiempo para la recuperación. |
El valor agregado a grandes rasgos del rendimiento de un determinado tipo de objeto de almacenamiento durante un periodo concreto (superior a 72 horas). |
Se obtienen los detalles básicos del objeto, como los detalles de un nodo o un clúster. |
No se han obtenido detalles concretos. |
Se recuperan los contadores acumulados, como el mínimo, el máximo, el percentil 95 y los valores promedio de rendimiento durante un periodo de tiempo, para un único objeto, como los contadores de lectura, escritura, total y otros. |
Se muestra un único valor agregado para todos los objetos del mismo tipo. |
El intervalo de tiempo y los datos de muestra se basan en la siguiente programación: el intervalo de tiempo de los datos. Algunos ejemplos son: 1h, 12h, 1d, 2d, 3d, 15d, 1w, 1m, 2m, 3m, 6m. Obtienes muestras de 1 hora si el intervalo es superior a 3 días (72 hr); de lo contrario, son muestras de 5 minutos. El periodo para cada intervalo de tiempo es el siguiente:
|
Más de 72 horas. El periodo de tiempo sobre el que se calcula esta muestra se expresa en el formato estándar ISO-8601. |
Ejemplo de salida para las API de métricas
Por ejemplo, la /datacenter/cluster/nodes/{key}/metrics API recupera los siguientes datos (entre otros) de un nodo:
|
El percentil 95 del valor resumido indica que el 95 % de las muestras recogidas durante ese periodo tienen un valor de contador inferior al valor especificado como percentil 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
}
},
Ejemplo de salida para las API de análisis
Por ejemplo, la /datacenter/cluster/nodes/analytics API recupera los siguientes valores (entre otros) para todos los nodos:
{ "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"
}
}
},
Lista de las API disponibles
La siguiente tabla describe en detalle las API /metrics y /analytics.
|
|
Las métricas de IOPS y rendimiento que devuelven estas API son valores de doble precisión, por ejemplo |
| Verbo HTTP | Ruta | Descripción |
|---|---|---|
|
|
Recupera datos de rendimiento (muestra y resumen) de un clúster especificado por el parámetro de entrada de la clave del clúster. Devuelve información como la clave del clúster y el UUID, el intervalo de tiempo, las IOPS, el rendimiento y el número de muestras. |
|
|
Recopila métricas de rendimiento a grandes rasgos para todos los clústeres de un centro de datos. Puedes filtrar los resultados según los criterios que necesites. Devuelve valores como las IOPS agregadas, el rendimiento y el período de recopilación (en horas). |
|
|
Recupera datos de rendimiento (muestras y resumen) de un nodo especificado mediante el parámetro de entrada de la clave del nodo. Devuelve información como el UUID del nodo, el intervalo de tiempo, el resumen de las IOPS, el throughput, la latencia y el rendimiento, el número de muestras recopiladas y el porcentaje de utilización. |
|
|
Recupera métricas de rendimiento a grandes rasgos para todos los nodos de un centro de datos. Puedes filtrar los resultados según los criterios que desees. Devuelve información, como las claves de nodos y clústeres, y valores, como las IOPS agregadas, el rendimiento y el periodo de recopilación (en horas). |
|
|
Recupera datos de rendimiento (muestra y resumen) para un agregado especificado por el parámetro de entrada de la clave de agregado. Devuelve información como el intervalo de tiempo, el resumen de las IOPS, la latencia, el throughput y la capacidad de rendimiento, el número de muestras recopiladas para cada contador y el porcentaje utilizado. |
|
|
Obtiene métricas de rendimiento a grandes rasgos para todos los agregados de un centro de datos. Puedes filtrar los resultados según los criterios que desees. Devuelve información, como las claves de agregados y clústeres, y valores, como IOPS agregadas, rendimiento y el período de recopilación (en horas). |
|
|
Recupera datos de rendimiento (muestra y resumen) de un LUN o un recurso compartido de archivos (volumen) especificado por el parámetro de entrada de la clave de LUN o volumen. Devuelve información, como el resumen de los valores mínimos, máximos y medios de las IOPS de lectura, escritura y totales, la latencia y el rendimiento, así como el número de muestras recopiladas para cada contador. |
|
|
Recupera métricas de rendimiento a grandes rasgos para todos los LUN o volúmenes de un centro de datos. Puedes filtrar los resultados según los criterios que necesites. Devuelve información, como las claves de la VM de almacenamiento y del clúster, y valores, como las IOPS agregadas, el rendimiento y el período de recopilación (en horas). |
|
|
Recupera datos de rendimiento (muestra y resumen) de una máquina virtual de almacenamiento especificada mediante el parámetro de entrada de la clave de la máquina virtual de almacenamiento. Devuelve un resumen de las IOPS en función de cada protocolo compatible, como |
|
|
Obtiene métricas de rendimiento a grandes rasgos para todas las máquinas virtuales de almacenamiento de un centro de datos. Puedes filtrar los resultados según los criterios que necesites. Devuelve información como el UUID de la máquina virtual de almacenamiento, las IOPS agregadas, la latencia, el throughput y el período de recopilación (en horas). |
|
|
Recupera las métricas de rendimiento de un puerto Ethernet específico indicado por el parámetro de entrada de la clave del puerto. Cuando se proporciona un intervalo (rango de tiempo) dentro del rango admitido, la API devuelve los contadores acumulados, como los valores mínimos, máximos y medios de rendimiento durante ese periodo de tiempo. |
|
|
Recupera las métricas de rendimiento a grandes rasgos de todos los puertos Ethernet de tu entorno de centro de datos. Se devuelve información como la clave y el UUID del clúster y del nodo, el rendimiento, el periodo de recopilación y el porcentaje de utilización de los puertos. Puedes filtrar el resultado según los parámetros disponibles, como la clave del puerto, el porcentaje de utilización, el nombre y el UUID del clúster y del nodo, etc. |
|
|
Recupera las métricas de rendimiento de una interfaz de red FC específica indicada por el parámetro de entrada de la clave de interfaz. Cuando se proporciona un intervalo (rango de tiempo) dentro del rango admitido, la API devuelve los contadores acumulados, como los valores mínimos, máximos y promedio de rendimiento durante ese periodo de tiempo. |
|
|
Recupera las métricas de rendimiento a grandes rasgos de todos los puertos Ethernet de tu entorno de centro de datos. Se devuelve información como la clave y el UUID del clúster y de la interfaz FC, el rendimiento, las IOPS, la latencia y la VM de almacenamiento. Puedes filtrar el resultado según los parámetros disponibles, como el nombre y el UUID del clúster y de la interfaz FC, la VM de almacenamiento, el rendimiento, etc. |
|
|
Recupera las métricas de rendimiento de un puerto FC específico indicado por el parámetro de entrada de la clave del puerto. Cuando se proporciona un intervalo (rango de tiempo) dentro del rango admitido, la API devuelve los contadores acumulados, como los valores mínimos, máximos y promedio de rendimiento durante ese periodo de tiempo. |
|
|
Recupera las métricas de rendimiento a grandes rasgos de todos los puertos FC del entorno de tu centro de datos. Se devuelve información como la clave y el UUID del cluster y del nodo, el rendimiento, el período de recopilación y el porcentaje de utilización de los puertos. Puedes filtrar el resultado según los parámetros disponibles, como la clave del puerto, el porcentaje de utilización, el nombre y el UUID del cluster y del nodo, etc. |
|
|
Recupera las métricas de rendimiento de una interfaz IP de red según lo especificado por el parámetro de entrada de la clave de interfaz. Cuando se proporciona un intervalo (rango de tiempo) dentro del rango admitido, la API devuelve información como el número de muestras, los contadores acumulados, el rendimiento y el número de paquetes recibidos y transmitidos. |
|
|
Recupera las métricas de rendimiento a grandes rasgos de todas las interfaces IP de red de tu entorno de centro de datos. Se devuelve información como la clave y el UUID del clúster y de la interfaz IP, el rendimiento, las IOPS y la latencia. Puedes filtrar el resultado según los parámetros disponibles, como el nombre y el UUID del clúster y de la interfaz IP, las IOPS, la latencia, el rendimiento, etc. |