Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Exploitez Mist SLE et informations grâce aux API

Utilisez l’API RESTful pour obtenir des informations sur les performances du réseau.

Lorsque vous utilisez le portail Juniper Mist pour surveiller le fonctionnement de votre réseau, vous obtenez des informations sur ce qui se passe avant que cela ne devienne un problème. Vous pouvez voir le réseau sous plusieurs angles : sans fil, filaire, WAN, etc. En outre, vous pouvez utiliser les outils fournis par Juniper Mist™ pour dépanner et corriger les problèmes potentiels.

Le tableau de bord principal Mist de la section Surveiller les niveaux de service > présente les résultats du moteur PACE (Predictive Analytics and Correlation Engine) sous la forme de mesures d’attente de niveau de service (SLE). Les SLE exploitent le machine learning et le Mist PACE dans le cloud Juniper Mist. À l'aide de ces ressources, les SLE transforment les données de télémétrie transmises en continu par les points d'accès (AP) en visualisations représentant l'expérience réseau des utilisateurs finaux en temps quasi réel. Pour plus d’informations sur les SLE, consultez le Guide des opérations IA natives Juniper Mist.

Comme pour tout ce que l’on peut voir dans l’interface graphique de Mist, les SLE et les informations Insights sont également disponibles à partir de l’API.

SLE (SLE)

Il peut être utile pour vous de collecter des informations sur des SLE spécifiques afin de les utiliser à des fins de reporting historique ou pour déclencher d’autres automatisations. Comme pour les autres appels d’API, vous commencez par déterminer le point de terminaison à partir duquel vous souhaitez collecter des données. Voici un exemple de requête API GET pour le getOrgsSitesSle point de terminaison :

Note: Remplacez {org_id} par l’ID de votre organisation.

Pour plus d’informations, reportez-vous à la section Présentation des SLE.

Idées

Les insights donnent une vue d’ensemble de l’expérience réseau sur l’ensemble du site, des points d’accès ou du client sans fil. C’est un excellent point de départ pour vérifier sur un site.

Vous pouvez trouver des informations Insight en envoyant une requête GET à l’un des points de terminaison Insights suivants :

  • GetSiteInsightMetrics
  • GetSiteInsightMetricsForDevice
  • GetSiteInsightMetricsForClient

Pour plus d’informations, consultez Vue d’ensemble d’Insights.

Mesures et classificateurs

Juniper Mist points de terminaison SLEs et Insights prennent en charge les métriques et les classificateurs. Les métriques permettent de déterminer si le niveau de service atteint la valeur seuil configurée. Si une métrique n’atteint pas le seuil, cette défaillance peut être attribuée à l’un des classificateurs afin de mieux comprendre où la défaillance s’est produite.

Les points de terminaison SLE et Insights nécessitent souvent cet metric argument. En effet, en plus des statistiques brutes ou de la configuration, Mist expose les valeurs calculées résultant de l’analyse interne des données. Plutôt que de créer une fonction API unique chaque fois qu’une nouvelle fonctionnalité d’analyse de données est ajoutée, Mist n’expose qu’une poignée de fonctions, mais utilise l’argument metric pour spécifier les valeurs de données dérivées à récupérer.

Pour obtenir la liste des métriques d’insight, vous pouvez émettre l’appel GET suivant :

La réponse ressemblerait à ceci :

Une autre façon d’afficher des exemples de mesures Insight disponibles consiste à vous connecter au portail Mist et à ouvrir ce lien dans un nouvel onglet à partir du même navigateur :

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

En utilisant l’exemple GET /api/v1/const/insight_metricsd’appel GET précédent, vous devez ajouter la métrique souhaitée à la fin de l’appel. Consultez l’exemple d’appels GET ci-dessous pour connaître certaines des métriques actuellement prises en charge et leurs classificateurs.

Disponibilité des points d’accès : disponibilité des points d’accès

Appel GET :
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Redémarrage de l’AP : ap-reboot
  • AP inaccessible : ap-unreachable
  • Site Down : site down

Capacité : capacité

GET Call :
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Charge AP : Charge AP
  • Interférence non Wi-Fi : non-interférence wifi
  • Interférence Wi-Fi : interférence wifi

Couverture : couverture

GET Call :
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Asymétrie liaison descendante : asymétrie-liaison descendante
  • Asymétrie liaison montante : asymétrie-liaison montante
  • Signal faible : signal faible

Itinérance : itinérance

GET Call :
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Échec de l’itinérance rapide : Pas d’itinérance rapide
  • Itinérances lentes 11r : Itinérance sous-optimale 11r
  • Itinérances lentes OKC : Suboptimal-okc-roam
  • Itinérances standard lentes : Itinérance lente

Connexions réussies : connexion réussie

GET Call :
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Association : association
  • Autorisation : autorisation
  • DHCP : Le protocole DHCP

Débit : débit

GET Call :
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Capacité : capacité
  • Couverture : couverture
  • Capacité de l’appareil : capacité de l’appareil
  • Problèmes de réseau : problèmes de réseau

Time to Connect : time-to-connect

GET Call ::
Note: Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Association : association
  • Autorisation : autorisation
  • DHCP : Le protocole DHCP
  • Services Internet : Services IP\u000C

Calcul des pourcentages de SLE

Le taux de réussite de la mesure SLE est calculé en pourcentage de la fréquence à laquelle le seuil a été atteint au cours de la période sélectionnée. Les classificateurs sont également calculés sous forme de pourcentages, mais ces valeurs indiquent leur impact sur la défaillance parente.

Par exemple, la capture d’écran ci-dessous montre que le délai de connexion a réussi dans 96 % des cas. Tous les clients qui se sont connectés avec succès entre 15h00 et 16h00 ont terminé le processus de connexion dans le seuil de quatre secondes.

Success Rate on the Time to Connect Root Cause Analysis Page

Le taux de réussite (%) de cette métrique est dérivé du point de terminaison de l’API « Résumé de la métrique ».

Note: Remplacez site_id par l’ID de site réel.

Le taux de défaillance métrique est calculé en divisant le nombre de défaillances (sle.samples.degraded) par le total (sle.samples.total). Cela se traduit ensuite par le pourcentage de taux de réussite. À l’aide de la charge utile de réponse de l’API ci-dessus, le calcul se présente comme suit :

Cette capture d’écran montre les classificateurs qui ont contribué aux échecs de métriques (DHCP, autorisation, association et services Internet) :

Example: Classifier Percentages

L’impact (%) du classifieur provient du même point de terminaison d’API « Résumé des métriques ».

Note: Remplacez site_id par l’ID de site réel.

L’impact du classifieur est calculé en divisant le nombre de défaillances du classifieur (classifiers[n].samples.degraded) par la somme de toutes les défaillances (classifiers[].samples.degraded). Celle-ci est ensuite traduite en pourcentage. À l’aide de la charge utile de réponse d’API ci-dessus, le calcul pour DHCP se présente comme suit :

SLE de surveillance

Les données SLE sont mises à jour toutes les dix minutes. Cependant, les SLE sont sujets à des fluctuations lors de la surveillance à cette granularité. Par conséquent, il est recommandé d’interroger des intervalles de 1 heure en utilisant l’heure de début et de fin explicite, et en n’interrogeant qu’une fois par heure.