Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Usar los SLE e información de Mist con las API

Utilice la API RESTful para obtener información sobre el rendimiento de la red.

Cuando utiliza el portal de Juniper Mist para supervisar el funcionamiento de su red, obtiene información de lo que está sucediendo antes de que se convierta en un problema. Puede ver la red desde múltiples puntos de vista: inalámbrico, por cable, WAN y otros. Además, puede utilizar las herramientas que proporciona Juniper Mist™ para solucionar y corregir posibles problemas.

El panel de Mist principal de Supervisar > niveles de servicio presenta los resultados del motor de correlación y análisis predictivo (PACE), en forma de métricas de previsión de nivel de servicio (SLE). SLE aprovecha el aprendizaje automático y Mist PACE en la nube de Juniper Mist. Con estos recursos, las SLE convierten la telemetría de transmisión desde los puntos de acceso (AP) en visualizaciones que representan la experiencia de red de los usuarios finales en tiempo casi real. Para obtener más información acerca de las SLE, consulte la Guía de operaciones nativas de IA de Juniper Mist AI.

Al igual que con todo lo visto en la GUI de Mist, la información de SLE e Insights también está disponible en la API.

SLE

Puede ser útil que recopile información sobre SLE específicas para usarla con fines de informes históricos o para activar otras automatizaciones. Al igual que otras llamadas a la API, empiece por determinar de qué punto de conexión desea recopilar datos. A continuación se muestra un ejemplo de la solicitud GET de API para el getOrgsSitesSle punto de conexión:

Nota: Reemplazar {org_id} por el ID de su organización.

Para obtener más información, consulte Descripción general de SLE.

Información valiosa

Insights brindan una descripción general de la experiencia de red en todo el sitio, puntos de acceso o cliente inalámbrico. Es un excelente lugar para comenzar a revisar un sitio.

Puede encontrar información de Insight realizando una solicitud GET a uno de los siguientes puntos de conexión de Insights:

  • GetSiteInsightMetrics
  • GetSiteInsightMetricsForDevice
  • GetSiteInsightMetricsForClient

Para obtener más información, consulte Descripción general de Insights.

Métricas y clasificadores

Los puntos finales de SLE e información 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 cumple con el umbral, este error se puede atribuir a uno de los clasificadores para comprender mejor dónde se produjo el error.

Los puntos de conexión de SLE e Insights a menudo requieren el metric argumento. Esto se debe a que, además de las estadísticas sin procesar o la configuración, Mist expone valores calculados resultantes del análisis de datos internos. En lugar de crear una función de API única cada vez que se agrega una nueva función de análisis de datos, Mist expone solo un puñado de funciones, pero usa el metric argumento para especificar qué valores de datos derivados recuperar.

Atención:

Los siguientes puntos de conexión de API quedarán obsoletos en una próxima versión de 2026:

  • :site_id/sle/:scope/:scope_id/metric/:metric/summary

  • :site_id/sle/:scope/:scope_id/metric/:metric/classifier/:classifier/summary

Estos serán reemplazados por los siguientes puntos de conexión nuevos:

  • :site_id/sle/:scope/:scope_id/metric/:metric/summary-trend

  • :site_id/sle/:scope/:scope_id/metric/:metric/classifier/:classifier/summary-trend

Para obtener una lista de métricas de estadísticas, puede emitir la siguiente llamada GET:

La respuesta se vería así:

Otra forma de ver ejemplos de métricas de Insight disponibles es iniciar sesión en el portal de Mist y abrir este enlace en una pestaña nueva desde el mismo navegador:

https://api.mist.com/api/v1/const/insight_metrics

Con el ejemplo GET /api/v1/const/insight_metricsanterior de una llamada GET, agregaría la métrica deseada al final de la llamada. Consulte las llamadas GET de ejemplo a continuación para ver algunas de las métricas que se admiten actualmente y sus clasificadores.

Tiempo de actividad de AP: disponibilidad de AP

Llamada GET:
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Reinicio de AP: reinicio de ap
  • AP inalcanzable: ap-inalcanzable
  • Sitio caído: sitio caído

Capacidad: capacidad

Llamada GET:
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Carga de AP: Carga de AP
  • Non WiFi Interference: non-wifi-interference
  • Interferencia WiFi: wifi-interferencia

Cobertura: cobertura

Llamada GET:
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Enlace descendente asimétrico: enlace descendente asimétrico
  • Enlace ascendente asimétrico: enlace ascendente asimétrico
  • Señal débil: señal débil

Roaming: roaming

Llamada GET:
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Error al hacer el roaming rápido: Sin roaming rápido
  • Roaming lento de 11r: Suboptimal-11r-roam
  • Roaming lento de OKC: Suboptimal-okc-roam
  • Roaming estándar lento: Exploración lenta

Conexiones exitosas: conexión exitosa

Llamada GET:
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Asociación: asociación
  • Autorización: autorización
  • DHCP: DHCP

Transferencia de datos: transferencia de datos

Llamada GET:
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Capacidad: capacidad
  • Cobertura: cobertura
  • Capacidad del dispositivo: capacidad del dispositivo
  • Problemas de red: problemas de red

Tiempo de conexión: tiempo de conexión

GET Call::
Nota: Sustituya {site_id} por el ID de su sitio.
Solicitud de muestra: Respuesta de ejemplo:
  • Asociación: asociación
  • Autorización: autorización
  • DHCP: DHCP
  • Servicios de Internet: Servicios IP\u000C

Calcular 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 seleccionado. Los clasificadores también se calculan como porcentajes, pero estos valores indican su impacto en el error principal.

Por ejemplo, la siguiente captura de pantalla muestra que el tiempo de conexión tuvo éxito el 96% de las veces; Todos los clientes que se conectaron correctamente de 3:00 a 4:00 p.m. completaron el proceso de conexión dentro del umbral de cuatro segundos.

Success Rate on the Time to Connect Root Cause Analysis Page

La tasa de éxito de esta métrica (%) se deriva del punto de conexión de la API "Resumen de métricas".

Nota: Reemplace site_id con el ID real del sitio.

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 la tasa de éxito. Con la carga de respuesta de la API anterior, el cálculo sería el siguiente:

En esta captura de pantalla, se muestran los clasificadores que contribuyeron a los errores de las métricas (DHCP, autorización, asociación y servicios de Internet):

Example: Classifier Percentages

El impacto del clasificador (%) se deriva del mismo punto de conexión de la API de "Resumen de métricas".

Nota: Reemplace site_id con el ID real del sitio.

El impacto del clasificador se calcula dividiendo los errores del clasificador (clasificadores[n].muestras.degradado) por la suma de todos los errores (clasificadores[].muestras.degradado). Esto luego se traduce en un porcentaje. Con la carga de respuesta de la API anterior, el cálculo de DHCP sería el siguiente:

Monitoreo de SLE

Los datos de SLE se actualizan cada diez 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 y finalización, y sondear solo una vez por hora.