このページの目次
SLE APIドキュメント
Juniper Mist™ WiFiサービスレベルダッシュボードで使用される多くのエンドポイントは、APIドキュメントで確認できます: https://api.mist.com/api/v1/docs/Site#insights (有効なログインが必要) または https://api.ac2.mist.com/api/v1/docs/Site#insights。
API ドキュメントにないエンドポイントについては、以下を参照してください。
メトリック/分類子
Juniper Mist SLEは、メトリックと分類子をサポートしています。メトリックは、サービス レベルが構成されたしきい値を満たしているかどうかを追跡します。メトリックがしきい値を満たしていない場合、この失敗は、障害が発生した場所をさらに理解するために、分類子の 1 つに起因する可能性があります。
現在サポートされているメトリックとその分類子は次のとおりです。
AP稼働時間: APの可用性
- APの再起動:APの再起動
- AP到達不能: AP到達不能
- サイトダウン:サイトダウン
容量:容量
- AP負荷: AP負荷
- 非WiFi干渉:非wifi干渉
- 無線LAN干渉:無線LAN干渉
カバレッジ:カバレッジ
- 非対称ダウンリンク:非対称ダウンリンク
- 非対称アップリンク: 非対称アップリンク
- 弱い信号:弱い信号
ローミング:ローミング
- 高速ローミングに失敗しました: 高速ローミングなし
- 遅い11rローミング: 準最適-11r-ローミング
- 低速 OKC ローミング: 準最適-okc-roam
- 低速標準ローミング: スローローミング
接続成功: 接続失敗
- 協会:協会
- 承認: 承認
- Dhcp: Dhcp
スループット: スループット
- 容量:容量
- カバレッジ:カバレッジ
- デバイス機能: デバイス機能
- ネットワークの問題:ネットワークの問題
接続時間:接続時間
- 協会:協会
- 承認: 承認
- Dhcp: Dhcp
- インターネットサービス: IP サービス\u000C
APIエンドポイント
UIは、多数のAPIエンドポイントを使用してSLEデータを表示します。これらのエンドポイントのほとんどは、サイト、AP、またはクライアントのスコープでサポートされています。
主要なエンドポイントは次のとおりです。
メトリック リスト: 特定のスコープのメトリックの一覧を取得する
- エンドポイント : /api/v1/sites/:site_id/sle/scope/:scope_id/metrics
- サイト : /api/v1/sites/:site_id/sle/site/:site_id/metrics
- AP : /api/v1/sites/:site_id/sle/ap/:ap_id/metrics
- クライアント : /api/v1/sites/:site_id/sle/client/:client_mac/metrics
メトリックしきい値: SLEしきい値を処理する
- EP : /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/threshold
-
- サイト : /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
- クライアント : /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/threshold
メトリックヒストグラム: SLEメトリックのヒストグラムを取得する
- EP : /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/histogram
-
- サイト : /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
- クライアント : /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/histogram
- パラメーター:
- 開始 (例: 1540591200)
- 終了 (例: 1540594800)
メトリックの概要: SLEメトリックの概要を取得する
- EP : /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/summary
- サイト : /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
- クライアント : /api/v1/sites/:site_id/sle/client/:client_mac/metric/:metric/summary
- パラメーター:
- 開始
- 終了\u000C
メトリックの影響の概要: 必要に応じて、分類子と障害の種類でフィルター処理された影響の概要数を取得します
- EP : /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/impact-summary
- サイト : /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
- パラメーター:
- 開始
- 終わり
- フィールド=WLAN、device_type、device_os、バンド
- 分類子=:分類子 (オプション)
分類子の概要: SLE 分類子の詳細を取得する
- EP : /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/classifier/:classifier/summary
- サイト : /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
- パラメーター:
- 開始
- 終わり
メトリック影響を受けるAPリスト: 分類子と障害タイプでフィルタリングされた影響を受けるAPをオプションで取得
- EP (Site): /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/impacted-aps
- パラメーター:
- 開始
- 終わり
- 分類子=:分類子 (オプション)
メトリック影響を受けるユーザーリスト: 必要に応じて、分類子とエラーの種類でフィルター処理された影響を受けるユーザーを取得します
- EP : /api/v1/sites/:site_id/sle/:scope/:scope_id/metric/:metric/impacted-users
- サイト : /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
- パラメーター:
-
- 開始
- 終わり
- 分類子=:分類子 (オプション)
SLE パーセンテージの計算
SLEメトリックの成功率は、選択した期間中にしきい値に達した頻度の割合として計算されます。分類子もパーセンテージとして計算されますが、これらの値は親の失敗に対する影響を示します。
たとえば、次のスクリーンショットは、接続までの時間が96%の確率で成功したことを示しています。午後 3:00 から 4:00 の間に正常に接続したすべてのクライアントは、4 秒のしきい値内で接続プロセスを完了しました。

このメトリクスの成功率(%)は、「メトリックの概要」APIエンドポイントから派生します。
/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 ] } } }
メトリックの故障率は、故障 (sle.samples.degraded) を合計 (sle.samples.total) で割って計算されます。これは、成功率のパーセンテージに変換されます。上記の API 応答ペイロードを使用すると、計算は次のようになります。
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%
このスクリーンショットは、メトリックの失敗に寄与した分類子を示しています。

分類子の影響 (%) は、同じ "メトリックの概要" API エンドポイントから派生します。
/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 ] } } ] }
分類器の影響は、分類子の障害 (分類子[n].サンプル.劣化) をすべての障害の合計 (分類子[].サンプル.劣化) で割ることによって計算されます。これはパーセンテージに変換されます。上記の API 応答ペイロードを使用すると、DHCP の計算は次のようになります。
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%
SLEの監視
SLEデータは10分ごとに更新されます。ただし、SLEは、この粒度で監視すると変動する傾向があります。したがって、明示的な開始/終了時刻を使用して 1 時間間隔を照会し、1 時間に 1 回だけポーリングすることをお勧めします。