SLE-API-Dokumentation
Viele Endpunkte, die auf dem Dashboard der Juniper Mist™ WiFi Service Levels verwendet werden, finden Sie in der API-Dokumentation: https://api.mist.com/api/v1/docs/Site#insights (erfordert eine gültige Anmeldung) oder https://api.ac2.mist.com/api/v1/docs/Site#insights.
Die Endpunkte, die möglicherweise nicht in den API-Dokumenten zu finden sind, sind unten aufgeführt.
Metriken/Klassifikatoren
Juniper Mist SLEs unterstützen Metriken und Klassifizierer. Metriken verfolgen, ob der Service-Level 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 derzeit unterstützten Metriken und ihre Klassifizierer lauten wie folgt:
AP-Betriebszeit: AP-Verfügbarkeit
- AP-Neustart: ap-reboot
- AP nicht erreichbar: ap-unerreichbar
- Site Down: Site-Down
Kapazität: Kapazität
- AP-Last: AP-Last
- Nicht-WLAN-Störungen: Nicht-WLAN-Interferenzen
- WLAN-Interferenz: WLAN-Interferenz
Abdeckung: Abdeckung
- Asymmetrie-Downlink: Asymmetrie-Downlink
- Asymmetrie-Uplink: Asymmetrie-Uplink
- Schwaches Signal: schwaches Signal
Roaming: Roaming
- Fehler beim Fast Roaming: No-Fast-Roam
- Langsame 11r-Streifzüge: Suboptimal-11r-roam
- Langsame OKC-Roamings: Suboptimal-okc-roam
- Langsame Standard-Roamings: Langsames Roam
Erfolgreiche Verbindungen: Fehler beim Herstellen der Verbindung
- Verein: Verein
- Autorisierung: Autorisierung
- DHCP: DHCP
Durchsatz: Durchsatz
- Kapazität: Kapazität
- Abdeckung: Abdeckung
- Gerätefunktion: Gerätefunktion
- Netzwerkprobleme: Netzwerkprobleme
Time to Connect: Time-to-Connect
- Verein: Verein
- Autorisierung: Autorisierung
- DHCP: DHCP
- Internetdienste: IP-Services\u000C
API-Endpunkte
Die Benutzeroberfläche verwendet eine Reihe von API-Endpunkten, um die SLE-Daten anzuzeigen. Die meisten dieser Endpunkte werden für die Bereiche "Site", "AP" oder "Client" unterstützt.
Die wichtigsten Endpunkte lauten wie folgt:
Metrik-Liste: Rufen Sie die Liste der Metriken für den angegebenen Bereich ab
- Endpunkt: /api/v1/sites/:site_id/sle/scope/:scope_id/metrics
- Website: /api/v1/sites/:site_id/sle/site/:site_id/metrics
- AP: /api/v1/sites/:site_id/sle/ap/:ap_id/metrics
- Client: /api/v1/sites/:site_id/sle/client/:client_mac/metrics
Metrischer Schwellenwert: Verarbeiten des SLE-Schwellenwerts
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/threshold
-
- Site: /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
- Client: /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/threshold
Metrisches Histogramm: Abrufen des Histogramms für die SLE-Metrik
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/histogram
-
- Site: /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
- Client: /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/histogram
- Parameter:
- Start (d.h. 1540591200)
- Ende (d.h. 1540594800)
Zusammenfassung der Metriken: Abrufen der Zusammenfassung für die SLE-Metrik
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/summary
- Website: /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
- Client: /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/summary
- Parameter:
- Starten
- Ende\u000C
Zusammenfassung der Auswirkungen der Metrik: Abrufen der Anzahl der Auswirkungszusammenfassungen, die optional nach Klassifikator und Fehlertyp gefiltert werden können
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/impact-summary
- Website: /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
- Parameter:
- Starten
- Ende
- fields=wlan,device_type,device_os,band
- classifier=:classifier (optional)
Zusammenfassung des Klassifikators: Abrufen von Details zur SLE-Klassifizierung
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/classifier/:classifier/summary
- Website: /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
- Parameter:
- Starten
- Ende
Liste der von Metriken beeinflussten APs: Betroffene APs werden optional nach Klassifizierung und Fehlertyp gefiltert
- EP (Standort): /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/impacted-aps
- Parameter:
- Starten
- Ende
- classifier=:classifier (optional)
Liste der von Metriken betroffenen Benutzer: Betroffene Benutzer können optional nach Klassifizierung und Fehlertyp gefiltert werden.
- EP: /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/impacted-users
- Website: /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
- Parameter:
-
- Starten
- Ende
- classifier=:classifier (optional)
Berechnen von SLE-Prozentsätzen
Die Erfolgsquote der SLE-Metrik wird als Prozentsatz der Häufigkeit berechnet, mit der der Schwellenwert während des ausgewählten Zeitraums erreicht wurde. Klassifizierer werden ebenfalls als Prozentsätze berechnet, diese Werte geben jedoch ihre Auswirkungen auf den übergeordneten Fehler an.
Der folgende Screenshot zeigt beispielsweise, dass die Zeit bis zum Herstellen einer Verbindung in 96 % der Fälle erfolgreich war. Alle Clients, die zwischen 15:00 und 16:00 Uhr erfolgreich eine Verbindung hergestellt haben, haben den Verbindungsvorgang innerhalb des 4-Sekunden-Schwellenwerts abgeschlossen.
Die Erfolgsquote dieser Metrik (%) wird aus dem API-Endpunkt "Metric Summary" abgeleitet:
/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
]
}
}
}
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 übersetzt. Mit der obigen API-Antwortnutzlast würde die Berechnung wie folgt aussehen:
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%
Dieser Screenshot zeigt Klassifizierer, die zu den Metrikfehlern beigetragen haben:
Die Auswirkungen des Klassifikators (%) werden vom gleichen API-Endpunkt "Metric Summary" abgeleitet:
/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
]
}
}
]
}
Die Auswirkung des Klassifikators wird berechnet, indem die Fehler des Klassifikators (classifiers[n].samples.degraded) durch die Summe aller Fehler (classifiers[].samples.degraded) dividiert werden. Dies wird dann in einen Prozentsatz umgerechnet. Mit der obigen API-Antwortnutzlast würde die Berechnung für DHCP wie folgt aussehen:
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%
Überwachung von SLEs
SLE-Daten werden alle 10 Minuten aktualisiert. Die SLEs sind jedoch anfällig für Schwankungen, wenn sie mit dieser Granularität überwacht werden. Daher wird empfohlen, Abfragen für 1-Stunden-Intervalle mit der expliziten Start-/Endzeit durchzuführen und nur einmal pro Stunde abzurufen.