이 페이지의 내용
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는 지표 및 분류자를 지원합니다. 메트릭은 서비스 수준이 구성된 임계값을 충족하는지 여부를 추적합니다. 메트릭이 임계값을 충족하지 않는 경우 이 실패는 오류가 발생한 위치를 더 잘 이해하기 위해 분류자 중 하나에 기인할 수 있습니다.
현재 지원되는 지표 및 분류자는 다음과 같습니다.
AP 가동 시간: ap-availability
- AP 재부팅: ap-reboot
- AP 도달 불가: AP 도달 불가
- 사이트 다운: 사이트 다운
수용 인원: 수용량
- AP 로드: AP 로드
- 비 와이파이 간섭 : 비 와이파이 간섭
- WiFi 간섭: Wi-Fi 간섭
적용 범위: 적용 범위
- 비대칭 다운링크: 비대칭-다운링크
- 비대칭 업링크: asymmetry-uplink
- 약한 신호: 약한 신호
로밍: 로밍
- 빠른 로밍 실패: 빠른 로밍 금지
- 느린 11r 로밍: 차선책-11r-로밍
- 느린 OKC 로밍: 차선책-okc-로밍
- 느린 표준 로밍: 슬로우 로밍
연결 성공: 연결 실패
- 협회: 협회
- 권한 부여: 권한 부여
- 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
메트릭 영향 요약: 분류자 및 실패 유형별로 선택적으로 필터링된 영향 요약 수 가져오기Get impact summary counts optional sorted by classifier and failure type
- 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, 밴드
- classifier=:classifier (선택 사항)
분류자 요약: 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(사이트): /api/v1/sites/:site_id/sle/site/:site_id/metric/:metric/impacted-aps
- 매개 변수:
- 시작하다
- 끝
- classifier=:classifier (선택 사항)
영향을 받는 지표 사용자 목록: 영향을 받는 사용자를 분류자 및 오류 유형별로 선택적으로 필터링
- 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
- 매개 변수:
-
- 시작하다
- 끝
- classifier=:classifier (선택 사항)
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
]
}
}
]
}
분류자 영향은 분류자의 오류(classifiers[n].samples.degraded)를 모든 오류의 합계(classifiers[].samples.degraded)로 나누어 계산합니다. 그런 다음 백분율로 변환됩니다. 위의 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시간 간격으로 쿼리하고 시간당 한 번만 폴링하는 것이 좋습니다.