Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Utilisez les SLE et les informations de Mist avec les 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 de plusieurs points de vue : sans fil, filaire, WAN, etc. De plus, vous pouvez utiliser les outils fournis par Juniper Mist™ pour dépanner et corriger les problèmes potentiels.

Le tableau de bord principal du Mist sur Surveiller > les niveaux de service présente les résultats du moteur d’analyse prédictive et de corrélation (PACE), sous forme de mesures des niveaux de service garantis (SLE). Les SLE tirent parti du machine learning et de la technologie Mist PACE dans le cloud Juniper Mist. À l'aide de ces ressources, les SLE transforment la télémétrie en continu des 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 opérationnel Mist AI natif de l’Juniper.

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

SLE

Il peut vous être utile de recueillir des informations sur des SLE spécifiques à 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 GET d’API pour le getOrgsSitesSle point de terminaison :

Remarque : Remplacez {org_id} par votre ID d’organisation.

Pour plus d’informations, consultez Vue d’ensemble des SLE.

Informations

Les insights donnent un aperçu 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.

Métriques et classificateurs

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

Les points de terminaison SLE et Insights nécessitent souvent l’argument metric . En effet, outre les statistiques brutes ou la configuration, Mist expose les valeurs calculées résultant de l’analyse des données internes. 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 pour spécifier les metric valeurs de données dérivées à récupérer.

Attention :

Les points de terminaison d’API suivants seront obsolètes dans une prochaine version 2026 :

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

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

Ceux-ci seront remplacés par les nouveaux points de terminaison suivants :

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

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

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

La réponse ressemblerait à ceci :

Pour afficher des exemples de mesures Insight disponibles, connectez-vous au portail Mist et ouvrez ce lien dans un nouvel onglet à partir du même navigateur :

https://{api/api/v1/const/insight_metrics

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

Disponibilité de l’AP : disponibilité des AP

RECEVOIR l’appel :
Remarque : Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Redémarrage de l’AP : redémarrage de l’AP
  • AP inaccessible : AP-inaccessible
  • Site Down : site vers le bas

Capacité : capacité

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

Couverture : couverture

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

Itinérance : itinérance

Appel GET :
Remarque : 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 du 11r : Itinérance sous-optimale 11r
  • Itinérance lente d’OKC : Itinérance sous-optimale
  • Itinérance standard lente : Itinérance lente

Connexions réussies : connexion-réussie

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

Débit : débit

Appel GET :
Remarque : 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 : temps de connexion

Appel GET :
Remarque : Remplacez {site_id} par l’ID de votre site.
Demande d’échantillon : Exemple de réponse :
  • Association : association
  • Autorisation : autorisation
  • DHCP : 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 parent.

Par exemple, la capture d’écran ci-dessous montre que Time to Connect a réussi 96 % du temps ; 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 « Metric Summary ».

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

Le taux d’échec métrique est calculé en divisant les échecs (sle.samples.degraded) par le total (sle.samples.total). Cela se traduit ensuite par le pourcentage de taux de réussite. En utilisant la charge utile de réponse API ci-dessus, le calcul ressemblerait à ceci :

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

Example: Classifier Percentages

L’impact ( %) du classificateur est dérivé du même point de terminaison d’API « Résumé des mesures ».

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

L’impact sur le classificateur est calculé en divisant les échecs du classificateur (classificateurs[n].samples.degraded) par la somme de tous les échecs (classificateurs[].samples.degraded). Ceci est ensuite traduit en pourcentage. En utilisant la charge utile de réponse API ci-dessus, le calcul pour DHCP serait le suivant :

Surveillance des SLE

Les données SLE sont mises à jour toutes les dix minutes. Cependant, les SLE sont sujets aux fluctuations lorsqu’ils sont surveillés à 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 seule fois par heure.