Documentación de la API de SLE
Muchos puntos finales utilizados en el panel de niveles de servicio de WiFi de Juniper Mist™ se pueden encontrar en los documentos de la API: https://api.mist.com/api/v1/docs/Site#insights (requiere un inicio de sesión válido) o https://api.ac2.mist.com/api/v1/docs/Site#insights.
A continuación se indican los puntos de enlace que pueden no encontrarse en los documentos de la API.
Métricas/clasificadores
Las SLE de Juniper Mist admiten métricas y clasificadores. Las métricas rastrean si el nivel de servicio cumple con el valor de umbral configurado. Si una métrica no alcanza el umbral, esta falla puede atribuirse a uno de los clasificadores para comprender mejor dónde ocurrió la falla.
Las métricas admitidas actualmente y sus clasificadores son los siguientes:
Tiempo de actividad de AP: disponibilidad de ap
- Reinicio de AP: ap-reboot
- AP inalcanzable: ap-unreachable
- Sitio caído: sitio caído
Capacidad: capacidad
- Carga de AP: Carga de AP
- Interferencia sin WiFi: sin interferencia wifi
- Interferencia WiFi: wifi-interferencia
Cobertura: cobertura
- Enlace descendente de asimetría: enlace descendente asimétrico
- Enlace ascendente de asimetría: enlace ascendente asimetría
- Señal débil: señal débil
Itinerancia: itinerancia
- Error al desplazarse rápidamente: No-Fast-Roaming
- Roams lentos 11r: Subóptimo-11r-roaming
- Roams lentos de OKC: Subóptimo-okc-roaming
- Roams estándar lentos: Roaming lento
Conexiones exitosas: error al conectarse
- Asociación: asociación
- Autorización: autorización
- DHCP: DHCP
Rendimiento: rendimiento
- Capacidad: capacidad
- Cobertura: cobertura
- Capacidad del dispositivo: capacidad del dispositivo
- Problemas de red: problemas de red
Tiempo para conectarse: tiempo para conectarse
- Asociación: asociación
- Autorización: autorización
- DHCP: DHCP
- Servicios de Internet: Servicios IP\u000C
Puntos de conexión de API
La interfaz de usuario usa varios puntos de conexión de API para mostrar los datos de SLE. La mayoría de estos puntos de conexión son compatibles con los ámbitos Sitio, AP o Cliente.
Los criterios de valoración clave son los siguientes:
Lista de métricas: Obtenga la lista de métricas para el ámbito dado
- Punto de conexión: /api/v1/sites/:site_id/sle/scope/:scope_id/metrics
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metrics
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metrics
- Cliente: /api/v1/sites/:site_id/sle/client/:client_mac/metrics
Umbral métrico: Procesar el umbral de SLE
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/threshold
-
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/threshold
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metric/:metric/threshold
- Cliente: /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/threshold
Histograma métrico: Obtener el histograma de la métrica SLE
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/histogram
-
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/histogram
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metric/:metric/histogram
- Cliente: /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/histogram
- Parámetros:
- Inicio (es decir, 1540591200)
- Fin (es decir: 1540594800)
Resumen de métricas: Obtenga el resumen de la métrica SLE
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/summary
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/summary
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metric/:metric/summary
- Cliente: /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/summary
- Parámetros:
- Empezar
- fin\u000C
Resumen del impacto métrico: Obtener recuentos de resumen de impacto opcionalmente filtrados por clasificador y tipo de error
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/impact-summary
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/impact-summary
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metric/:metric/impact-summary
- Parámetros:
- Empezar
- Final
- campos=wlan,device_type,device_os,banda
- classifier=:classifier (opcional)
Resumen del clasificador: Obtener detalles del clasificador de SLE
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/classifier/:classifier/summary
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/classifier/:classifier/summary
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metric/:metric/classifier/:classifier/summary
- Parámetros:
- Empezar
- Final
Lista de ap afectados por la métrica: Obtener AP afectados opcionalmente filtrados por clasificador y tipo de error
- EP (Sitio): /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/impacted-aps
- Parámetros:
- Empezar
- Final
- classifier=:classifier (opcional)
Lista de usuarios afectados por la métrica: Obtener usuarios afectados opcionalmente filtrados por clasificador y tipo de error
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/impacted-users
- Sitio: /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/impacted-users
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metric/:metric/impacted-users
- Parámetros:
-
- Empezar
- Final
- classifier=:classifier (opcional)
Cálculo de porcentajes de SLE
La tasa de éxito de la métrica SLE se calcula como un porcentaje de la frecuencia con la que se alcanzó el umbral durante el período de tiempo seleccionado. Los clasificadores también se calculan como porcentajes, pero estos valores indican su impacto hacia el error principal.
Por ejemplo, la siguiente captura de pantalla muestra que Time to Connect tuvo éxito el 96% del tiempo; Todos los clientes que se conectaron correctamente de 3:00 a 4:00 pm completaron el proceso de conexión dentro del umbral de 4 segundos.
La tasa de éxito (%) de esta métrica se deriva del punto de enlace de la API "Resumen de métricas":
/api/v1/sites/:site_id/sle/site/:site_id/metric/time-to-connect/summary?start=1540591200&end=1540594800
{
“start”: 1540591200,
“end”: 1540594800,
“sle”: {
“x_label”: “seconds”,
“y_label”: “seconds”,
“interval”: 600,
“name”: “time-to-connect”,
“samples”: {
“degraded”: [
0.0,
0.0,
3.0,
0.0,
3.0,
0.0
],
“total”: [
19.0,
14.0,
34.0,
8.0,
20.0,
43.0
]
}
}
}
La tasa de errores de la métrica se calcula dividiendo los errores (sle.samples.degraded) por el total (sle.samples.total). Esto se traduce en el porcentaje de tasa de éxito. Con la carga de respuesta de API anterior, el cálculo sería el siguiente:
ceil(1-[(0.0+0.0+3.0+0.0+3.0+0.0)/(19.0+14.0+34.0+8.0+20.0+43.0)])*100= ceil(1-[6/138])*100= ceil(1-0.04347826086)*100= ceil(0.95652173914)*100= 0.96*100= =96%
Esta captura de pantalla muestra clasificadores que contribuyeron a los errores de métrica:
El impacto del clasificador (%) se deriva del mismo punto de enlace de la API de "Resumen de métricas":
/api/v1/sites/:site_id/sle/site/:site_id/metric/time-to-connect/summary?start=1540591200&end=1540594800
{
“start”: 1540591200,
“end”: 1540594800,
“classifiers”: [
{
“name”: “DHCP”,
“samples”: {
“degraded”: [
0,
0,
0,
0,
1.0,
0
]
}
},
{
“name”: “authorization”,
“samples”: {
“degraded”: [
0,
0,
0,
0,
0,
0
]
}
},
{
“name”: “association”,
“samples”: {
“degraded”: [
0,
0,
3.0,
0,
1.0,
0
]
}
},
{
“name”: “IP-Services”,
“samples”: {
“degraded”: [
0,
0,
0,
0,
1.0,
0
]
}
}
]
}
El impacto del clasificador se calcula dividiendo los errores del clasificador (clasificadores[n].samples.degraded) por la suma de todos los errores (clasificadores[].samples.degraded). Esto se traduce en un porcentaje. Con la carga de respuesta de API anterior, el cálculo para DHCP sería el siguiente:
ceil([0+0+0+0+1.0+0]/[(0+0+0+0+1.0+0)+(0+0+0+0+0+0)+(0+0+3.0+0+1.0+0)+(0+0+0+0+1.0+0)])*100= ceil(1/[1.0+0+4.0+1.0])*100= ceil(1/6)*100= ceil(0.16666666666)*100= 0.17*100= =17%
Supervisión de SLE
Los datos de SLE se actualizan cada 10 minutos. Sin embargo, las SLE son propensas a fluctuaciones cuando se monitorea con esta granularidad. Por lo tanto, se recomienda consultar intervalos de 1 hora utilizando la hora explícita de inicio / finalización y sondear solo una vez por hora.