Skip to main content
Active IQ Unified Manager
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Ver métricas de rendimiento mediante API

Active IQ Unified Manager le proporciona un conjunto de API bajo el /datacenter categoría que le permite ver los datos de rendimiento de sus clústeres y objetos de almacenamiento en un centro de datos. Estas API recuperan los datos de rendimiento de los diferentes 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.

El /metrics y /analytics Las API brindan diferentes vistas de las métricas de rendimiento, con las cuales puede explorar en profundidad diferentes niveles de detalle para los siguientes objetos de almacenamiento en su centro de datos:

  • grupos

  • nodos

  • máquinas virtuales de almacenamiento

  • agregados

  • volúmenes

  • LUN

  • Interfaces FC

  • Puertos FC

  • Puertos Ethernet

  • Interfaces IP

En la siguiente tabla se presenta una comparación entre los /metrics y /analytics API con respecto a los detalles de los datos de rendimiento recuperados.

Métrica Analítica

Detalles de rendimiento para un solo objeto. Por ejemplo, el /datacenter/cluster/clusters/{key}/metrics La API requiere que la clave del clúster se ingrese como parámetro de ruta para recuperar las métricas de ese clúster específico.

Detalles de rendimiento para múltiples objetos del mismo tipo en un centro de datos. Por ejemplo, el /datacenter/cluster/clusters/analytics La API recupera las métricas colectivas de todos los clústeres en un centro de datos.

Muestra de métricas de rendimiento para un objeto de almacenamiento basado en el parámetro de intervalo de tiempo para la recuperación.

El valor agregado de alto nivel del rendimiento para un determinado tipo de objeto de almacenamiento durante un período determinado (más de 72 horas).

Se recuperan detalles básicos del objeto, como detalles de un nodo o clúster.

No se recuperan detalles específicos.

Los contadores acumulados, como el mínimo, el máximo, el percentil 95 y los valores de rendimiento promedio durante un período de tiempo, se recuperan para un solo objeto, como contadores de lectura, escritura, totales y otros.

Se muestra un único valor agregado para todos los objetos del mismo tipo.

El rango de tiempo y los datos de muestra se basan en el siguiente cronograma: El rango de tiempo para los datos. Los ejemplos pueden ser 1h, 12h, 1d, 2d, 3d, 15d, 1w, 1m, 2m, 3m, 6m. Obtendrá muestras de 1 hora si el rango es más de 3 días (72 horas); de lo contrario, son muestras de 5 minutos. El período para cada rango de tiempo es el siguiente:

  • 1h: Métricas de la hora más reciente muestreadas durante 5 minutos.

  • 12h: Métricas de las últimas 12 horas muestreadas durante 5 minutos.

  • 1d: Métricas del día más reciente muestreadas durante 5 minutos.

  • 2d: Métricas de los 2 días más recientes muestreadas durante 5 minutos.

  • 3d: Métricas de los últimos 3 días muestreadas durante 5 minutos.

  • 15d: Métricas de los últimos 15 días muestreadas durante 1 hora.

  • 1w: Métricas de la semana más reciente muestreadas durante 1 hora.

  • 1m: Métricas del mes más reciente muestreadas durante 1 hora.

  • 2m: Métricas de los 2 meses más recientes muestreadas durante 1 hora.

  • 3m: Métricas de los últimos 3 meses muestreadas durante 1 hora.

  • 6m: Métricas de los últimos 6 meses muestreadas durante 1 hora.

    Valores disponibles: 1h, 12h, 1d, 2d, 3d, 15d, 1s, 1m, 2m, 3m, 6m

    Valor predeterminado: 1h

Más de 72 horas. La duración durante la cual se calcula esta muestra se representa en el formato estándar ISO-8601.

Ejemplo de salida para API de métricas

Por ejemplo, el /datacenter/cluster/nodes/{key}/metrics La API recupera los siguientes detalles (entre otros) para un nodo:

Nota El percentil 95 en el valor de resumen indica que el 95% de las muestras recolectadas durante el período tienen un valor de contador menor que el 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 API de análisis

Por ejemplo, el /datacenter/cluster/nodes/analytics La 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 la /metrics y /analytics API en detalle.

Nota

Las métricas de IOPS y rendimiento devueltas por estas API son valores dobles, por ejemplo 100.53 . No se admite el filtrado de estos valores flotantes mediante caracteres comodín (|) y de barra vertical (*).

Verbo HTTP Camino Descripción

GET

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

Recupera datos de rendimiento (muestra y resumen) para un clúster especificado por el parámetro de entrada de la clave del clúster. Se devuelve información como la clave del clúster y el UUID, el rango de tiempo, las IOPS, el rendimiento y la cantidad de muestras.

GET

/datacenter/cluster/clusters/analytics

Recupera métricas de rendimiento de alto nivel para todos los clústeres en un centro de datos. Puede filtrar sus resultados según los criterios requeridos. Se devuelven valores como IOPS agregados, rendimiento y el período de recopilación (en horas).

GET

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

Recupera datos de rendimiento (muestra y resumen) de un nodo especificado por el parámetro de entrada de la clave del nodo. Se devuelve información como el UUID del nodo, el rango de tiempo, el resumen de IOPS, el rendimiento, la latencia y el desempeño, la cantidad de muestras recopiladas y el porcentaje utilizado.

GET

/datacenter/cluster/nodes/analytics

Recupera métricas de rendimiento de alto nivel para todos los nodos de un centro de datos. Puede filtrar sus resultados según los criterios requeridos. Se devuelve información, como claves de nodo y de clúster, y valores, como IOPS agregados, rendimiento y el período de recopilación (en horas).

GET

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

Recupera datos de rendimiento (muestra y resumen) para un agregado especificado por el parámetro de entrada de la clave de agregado. Se devuelve información como el rango de tiempo, el resumen de IOPS, la latencia, el rendimiento y la capacidad de rendimiento, la cantidad de muestras recopiladas para cada contador y el porcentaje utilizado.

GET

/datacenter/storage/aggregates/analytics

Recupera métricas de rendimiento de alto nivel para todos los agregados en un centro de datos. Puede filtrar sus resultados según los criterios requeridos. Se devuelve información, como claves agregadas y de clúster, y valores, como IOPS agregados, rendimiento y el período de recopilación (en horas).

GET

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

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

Recupera datos de rendimiento (muestra y resumen) para un LUN o un recurso compartido de archivos (volumen) especificado por el parámetro de entrada de la clave del LUN o del volumen. Se devuelve información como el resumen del mínimo, máximo y promedio de IOPS de lectura, escritura y total, latencia y rendimiento, y la cantidad de muestras recopiladas para cada contador.

GET

/datacenter/storage/luns/analytics

/datacenter/storage/volumes/analytics

Recupera métricas de rendimiento de alto nivel para todos los LUN o volúmenes en un centro de datos. Puede filtrar sus resultados según los criterios requeridos. Se devuelve información, como las claves de clúster y de máquina virtual de almacenamiento, y valores, como IOPS agregados, rendimiento y el período de recopilación (en horas).

GET

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

Recupera datos de rendimiento (muestra y resumen) de una máquina virtual de almacenamiento especificada por el parámetro de entrada de la clave de la máquina virtual de almacenamiento. Resumen de las IOPS basadas en cada protocolo compatible, como nvmf, fcp, iscsi, y nfs Se devuelven el rendimiento, la latencia y la cantidad de muestras recopiladas.

GET

/datacenter/svm/svms/analytics

Recupera métricas de rendimiento de alto nivel para todas las máquinas virtuales de almacenamiento en un centro de datos. Puede filtrar sus resultados según los criterios requeridos. Se devuelve información como el UUID de la máquina virtual de almacenamiento, las IOPS agregadas, la latencia, el rendimiento y el período de recopilación (en horas).

GET

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

Recupera las métricas de rendimiento de un puerto Ethernet específico especificado por el parámetro de entrada de la clave del puerto. Cuando se proporciona un intervalo (rango de tiempo) del rango admitido, la API devuelve los contadores acumulados, como los valores de rendimiento mínimo, máximo y promedio durante el período de tiempo.

GET

/datacenter/network/ethernet/ports/analytics

Recupera las métricas de rendimiento de alto nivel para todos los puertos Ethernet en su entorno de centro de datos. Se devuelve información como la clave del clúster y del nodo y el UUID, el rendimiento, el período de recopilación y el porcentaje de utilización de los puertos. Puede filtrar el resultado por los parámetros disponibles, como la clave del puerto, el porcentaje de utilización, el nombre del clúster y del nodo y el UUID, etc.

GET

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

Recupera las métricas de rendimiento para una interfaz FC de red específica especificada por el parámetro de entrada de la clave de interfaz. Cuando se proporciona un intervalo (rango de tiempo) del rango admitido, la API devuelve los contadores acumulados, como los valores de rendimiento mínimo, máximo y promedio durante el período de tiempo.

GET

/datacenter/network/fc/interfaces/analytics

Recupera las métricas de rendimiento de alto nivel para todos los puertos Ethernet en su entorno de centro de datos. Se devuelve información como la clave y el UUID de la interfaz FC y del clúster, el rendimiento, las IOPS, la latencia y la máquina virtual de almacenamiento. Puede filtrar el resultado por los parámetros disponibles, como el nombre y UUID de la interfaz del clúster y FC, la máquina virtual de almacenamiento, el rendimiento, etc.

GET

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

Recupera las métricas de rendimiento de un puerto FC específico especificado por el parámetro de entrada de la clave del puerto. Cuando se proporciona un intervalo (rango de tiempo) del rango admitido, la API devuelve los contadores acumulados, como los valores de rendimiento mínimo, máximo y promedio durante el período de tiempo.

GET

/datacenter/network/fc/ports/analytics

Recupera las métricas de rendimiento de alto nivel para todos los puertos FC en su entorno de centro de datos. Se devuelve información como la clave del clúster y del nodo y el UUID, el rendimiento, el período de recopilación y el porcentaje de utilización de los puertos. Puede filtrar el resultado por los parámetros disponibles, como la clave del puerto, el porcentaje de utilización, el nombre del clúster y del nodo y el UUID, etc.

GET

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

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) del rango admitido, la API devuelve información, como la cantidad de muestras, los contadores acumulados, el rendimiento y la cantidad de paquetes recibidos y transmitidos.

GET

/datacenter/network/ip/interfaces/analytics

Recupera las métricas de rendimiento de alto nivel para todas las interfaces IP de red en su entorno de centro de datos. Se devuelve información como la clave de interfaz IP y del clúster y el UUID, el rendimiento, las IOPS y la latencia. Puede filtrar el resultado por los parámetros disponibles, como el nombre del clúster y la interfaz IP y UUID, IOPS, latencia, rendimiento, etc.