Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Nutzung von Mist Systems SLEs und Insights mit APIs

Verwenden Sie die RESTful API, um Einblicke in die Netzwerkleistung zu erhalten.

Wenn Sie das Juniper Mist Systems Portal verwenden, um den Betrieb Ihres Netzwerks zu überwachen, erhalten Sie Einblicke in das Geschehen, bevor es zu einem Problem wird. Sie können das Netzwerk aus mehreren Blickwinkeln betrachten: drahtlos, kabelgebunden, WAN und andere. Darüber hinaus können Sie die Tools von Juniper Mist Systems™ zur Fehlerbehebung und Korrektur potenzieller Probleme verwenden.

Das primäre Mist Systems-Dashboard unter > Servicelevels überwachen präsentiert die Ergebnisse der Predictive Analytics and Correlation Engine (PACE) in Form von Metriken für die Servicelevel-Erwartungen (SLE). SLEs nutzen maschinelles Lernen und das Mist Systems PACE in der Juniper Mist Systems Cloud. Mithilfe dieser Ressourcen verwandeln SLEs die Streaming-Telemetrie von den Access Points (APs) in Visualisierungen, die die Netzwerkerfahrung der Endbenutzer nahezu in Echtzeit darstellen. Weitere Informationen zu SLEs finden Sie im Juniper Mist AI-Native Operations Guide.

Wie bei allem, was in der GUI von Mist Systems zu sehen ist, sind SLEs und Insights-Informationen auch über die API verfügbar.

SLEs

Es kann für Sie nützlich sein, Informationen zu bestimmten SLEs zu sammeln, um sie für historische Berichtszwecke zu verwenden oder andere Automatisierungen anzustoßen. Wie bei anderen API-Aufrufen legen Sie zunächst fest, von welchem Endgerät Sie Daten sammeln möchten. Im Folgenden finden Sie ein Beispiel für die API-GET-Anforderung für das getOrgsSitesSle Endgerät:

Hinweis: Ersetzen Sie {org_id} durch Ihre Organisations-ID.

Weitere Informationen finden Sie unter Übersicht über SLEs.

Einblicke

Die Einblicke bieten einen Überblick über die Netzwerkerfahrung über den gesamten Standort, die Access Points oder den drahtlosen Client hinweg. Es ist ein großartiger Ausgangspunkt, wenn Sie eine Website überprüfen.

Sie finden Insight-Informationen, indem Sie eine GET-Anforderung an einen der folgenden Insights-Endpunkte senden:

  • GetSiteInsightMetrics
  • GetSiteInsightMetricsForDevice
  • GetSiteInsightMetricsForClient

Weitere Informationen finden Sie unter Übersicht über Einblicke.

Metriken und Klassifikatoren

Juniper Mist Systems SLEs und Insights-Endgeräte unterstützen Metriken und Klassifikatoren. Metriken verfolgen, ob das Servicelevel den konfigurierten Schwellenwert erreicht. Wenn eine Metrik den Schwellenwert nicht erreicht, kann dieser Fehler einem der Klassifizierer zugeordnet werden, um besser zu verstehen, wo der Fehler aufgetreten ist.

Die SLE- und Insights-Endpunkte erfordern häufig das metric Argument. Dies liegt daran, dass Mist Systems zusätzlich zu den Rohstatistiken oder der Konfiguration berechnete Werte aus der internen Datenanalyse zur Verfügung stellt. Anstatt jedes Mal, wenn eine neue Datenanalysefunktion hinzugefügt wird, eine eigene API-Funktion zu erstellen, stellt Mist Systems nur eine Handvoll Funktionen zur Verfügung, verwendet das metric Argument jedoch, um anzugeben, welche abgeleiteten Datenwerte abgerufen werden sollen.

Achtung:

Die folgenden API-Endpunkte werden in einer kommenden Version 2026 veraltet sein:

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

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

Diese werden durch die folgenden neuen Endpunkte ersetzt:

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

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

Um eine Liste der Erkenntnismetriken zu erhalten, können Sie den folgenden GET-Aufruf ausführen:

Die Antwort würde wie folgt aussehen:

Eine weitere Möglichkeit, Beispiele für verfügbare Insight-Metriken anzuzeigen, besteht darin, sich beim Mist Systems Portal anzumelden und diesen Link in einem neuen Tab im selben Browser zu öffnen:

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

Anhand des vorherigen GET-Aufrufbeispiels GET /api/v1/const/insight_metricswürden Sie Ihre gewünschte Metrik am Ende des Anrufs hinzufügen. In den folgenden Beispiel-GET-Aufrufen finden Sie einige der derzeit unterstützten Metriken und deren Klassifizierer.

AP-Betriebszeit: AP-Verfügbarkeit

GET-Anruf:
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • AP-Neustart: ap-reboot
  • AP nicht erreichbar: AP nicht erreichbar
  • Site down: Site-down

Kapazität: Kapazität

GET Call:
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • AP-Last: AP-Last
  • Keine WLAN-Interferenz: Nicht-WLAN-Interferenz
  • WLAN-Interferenz: WLAN-Interferenz

Abdeckung: Abdeckung

GET Call:
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • Asymmetrie-Downlink: Asymmetrie-Downlink
  • Asymmetrie-Uplink: Asymmetrie-Uplink
  • Schwaches Signal: schwaches Signal

Roaming: Roaming

GET Call:
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • Fehler beim schnellen Roaming: No-Fast-Roam
  • Langsame 11r-Roams: Suboptimales-11r-Roaming
  • Langsame OKC-Roamings: Suboptimales-okc-roaming
  • Langsames Standard-Roaming: Langsames Roam

Erfolgreiche Verbindungen: Erfolgreiche Verbindung

GET Call:
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • Verband: Verband
  • Autorisierung: Autorisierung
  • DHCP: DHCP

Durchsatz: Durchsatz

GET Call:
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • Kapazität: Kapazität
  • Abdeckung: Abdeckung
  • Gerätefähigkeit: Gerätefähigkeit
  • Netzwerkprobleme: Netzwerkprobleme

Time to Connect: Zeit bis zur Herstellung einer Verbindung

GET Call::
Hinweis: Ersetzen Sie {site_id} durch Ihre Website-ID.
Musteranfrage: Beispiel für eine Antwort:
  • Verband: Verband
  • Autorisierung: Autorisierung
  • DHCP: DHCP
  • Internet-Services: IP-Dienste\u000C

Berechnung von SLE-Prozentsätzen

Die Erfolgsrate der SLE-Metrik wird als Prozentsatz berechnet, wie oft der Schwellenwert während des ausgewählten Zeitraums erreicht wurde. Klassifizierer werden ebenfalls als Prozentsätze berechnet, aber diese Werte geben ihre Auswirkungen auf den übergeordneten Fehler an.

Der folgende Screenshot zeigt beispielsweise, dass die Zeit bis zur Herstellung einer Verbindung in 96 % der Fälle erfolgreich war. Alle Clients, die zwischen 15:00 und 16:00 Uhr eine erfolgreiche Verbindung hergestellt haben, haben den Verbindungsvorgang innerhalb des Schwellenwerts von vier Sekunden abgeschlossen.

Success Rate on the Time to Connect Root Cause Analysis Page

Die Erfolgsrate dieser Metrik (%) wird vom API-Endgerät "Metric Summary" abgeleitet.

Hinweis: Ersetzen Sie site_id durch die tatsächliche Standort-ID.

Die metrische Fehlerrate wird berechnet, indem die Fehler (sle.samples.degraded) durch die Summe (sle.samples.total) dividiert werden. Dies wird dann in den Prozentsatz der Erfolgsquote umgerechnet. Unter Verwendung der obigen API-Antwortnutzlast würde die Berechnung wie folgt aussehen:

Dieser Screenshot zeigt Klassifizierer, die zu den Metrikfehlern beigetragen haben (DHCP, Autorisierung, Zuordnung und Internetdienste):

Example: Classifier Percentages

Die Auswirkung des Klassifizierers (%) wird vom selben API-Endgerät "Metric Summary" abgeleitet.

Hinweis: Ersetzen Sie site_id durch die tatsächliche Standort-ID.

Die Auswirkung des Klassifizierers wird berechnet, indem die Fehler des Klassifizierers (classifiers[n].samples.degraded) durch die Summe aller Fehler (classifiers[].samples.degraded) dividiert werden. Dies wird dann in einen Prozentsatz umgerechnet. Unter Verwendung der obigen API-Antwortnutzlast würde die Berechnung für DHCP wie folgt aussehen:

Überwachung von SLEs

Die SLE-Daten werden alle zehn Minuten aktualisiert. Die SLEs sind jedoch anfällig für Schwankungen, wenn sie mit dieser Granularität überwachen. Daher wird empfohlen, Intervalle von 1 Stunde mit der expliziten Start- und Endzeit abzufragen und nur einmal pro Stunde abzufragen.