Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

API와 함께 Mist SLE 및 인사이트 사용

RESTful API를 사용하여 네트워크 성능에 대한 인사이트를 얻을 수 있습니다.

주니퍼 Mist 포털을 사용하여 네트워크 운영을 모니터링하면 문제가 되기 전에 현재 상황을 파악할 수 있습니다. 무선, 유선, WAN 등 다양한 관점에서 네트워크를 볼 수 있습니다. 또한 주니퍼 Mist™가 제공하는 도구를 사용하여 잠재적인 문제를 해결하고 해결할 수 있습니다.

Monitor > Service Levels의 기본 Mist 대시보드는 예측 분석 및 상관 관계 엔진(PACE)의 결과를 SLE(Service Level Expectation) 메트릭의 형태로 표시합니다. SLE는 머신러닝과 주니퍼 Mist Mist 클라우드의 Mist PACE를 활용합니다. SLE는 이러한 리소스를 사용하여 액세스 포인트(AP)의 스트리밍 텔레메트리를 거의 실시간으로 최종 사용자의 네트워크 경험을 나타내는 시각화로 전환합니다. SLE에 대한 자세한 내용은 주니퍼 Mist AI 네이티브 운영 가이드를 참조하십시오.

Mist GUI에서 볼 수 있는 모든 것과 마찬가지로 SLE 및 인사이트 정보도 API에서 사용할 수 있습니다.

SLE

특정 SLE에 대한 정보를 수집하여 과거 보고 목적으로 사용하거나 다른 자동화를 트리거하는 것이 유용할 수 있습니다. 다른 API 호출과 마찬가지로 먼저 데이터를 수집할 엔드포인트를 결정합니다. 다음은 엔드포인트에 대한 API GET 요청의 예입니다.getOrgsSitesSle

참고: {org_id}을(를) 조직 ID로 바꿉니다.

자세한 내용은 SLE 개요 단원을 참조하십시오.

인사이트

인사이트는 전체 사이트, 액세스 포인트 또는 무선 클라이언트의 네트워크 경험에 대한 개요를 제공합니다. 사이트를 확인할 때 시작하기에 좋은 곳입니다.

다음 인사이트 엔드포인트 중 하나에 GET 요청을 수행하여 인사이트 정보를 찾을 수 있습니다.

  • GetSiteInsightMetrics
  • GetSiteInsightMetricsForDevice
  • GetSiteInsightMetricsForClient

자세한 내용은 인사이트 개요를 참조하세요.

메트릭 및 분류자

주니퍼 Mist SLE 및 Insights 엔드포인트는 메트릭과 분류기를 지원합니다. 메트릭은 서비스 수준이 구성된 임계값을 충족하는지 여부를 추적합니다. 메트릭이 임계값을 충족하지 않는 경우, 이 실패는 실패가 발생한 위치를 추가로 파악하기 위해 분류기 중 하나에 기인할 수 있습니다.

SLE 및 Insights 엔드포인트에는 종종 인수가 필요합니다 metric . 이는 원시 통계 또는 구성 외에도 Mist가 내부 데이터 분석 결과 계산된 값을 노출하기 때문입니다. Mist는 새로운 데이터 분석 기능이 추가될 때마다 고유한 API 함수를 생성하는 대신 소수의 함수만 노출하지만 인수를 사용하여 metric 검색할 파생 데이터 값을 지정합니다.

주의:

다음 API 엔드포인트는 2026년 릴리스에서 더 이상 사용되지 않습니다.

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

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

이러한 엔드포인트는 다음과 같은 새 엔드포인트로 대체됩니다.

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

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

인사이트 메트릭 목록을 얻으려면 다음 GET 호출을 실행할 수 있습니다.

응답은 다음과 같습니다.

사용 가능한 인사이트 지표의 예를 보는 또 다른 방법은 Mist 포털에 로그인하고 동일한 브라우저의 새 탭에서 다음 링크를 여는 것입니다.

https://api.mist.com/api/v1/const/insight_metrics

이전 GET 호출 예제 GET /api/v1/const/insight_metrics를 사용하여 호출이 끝날 때 원하는 지표를 추가합니다. 현재 지원되는 메트릭 및 해당 분류자 중 일부는 아래 예제 GET 호출을 참조하십시오.

AP 업타임: ap-availability

GET 전화:
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • AP 재부팅: ap-reboot
  • AP 도달 불가: ap-unreachable
  • 사이트 다운: site-down

용량: 용량

GET Call:
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • AP 로드: AP 로드
  • 비 WiFi 간섭: 비 Wi-Fi 간섭
  • WiFi 간섭: Wi-Fi 간섭

적용 범위: 적용 범위

GET Call:
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 비대칭 다운링크: asymmetry-downlink
  • 비대칭 업링크: asymmetry-uplink
  • 약한 신호: 약한 신호

로밍: 로밍

GET Call:
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 고속 로밍 실패: 고속 로밍 없음
  • 느린 11r 로밍: Suboptimal-11r-roam
  • 린 OKC 로밍: Suboptimal-okc-roam
  • 느린 표준 로밍: 슬로우 로밍

성공적인 연결: successful-connect

GET Call:
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 협회: 협회
  • 권한 부여: 권한 부여
  • DHCP 참조: DHCP DHCP

처리량: 처리량

GET Call:
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 용량: 용량
  • 적용 범위: 적용 범위
  • 디바이스 기능: device-capability
  • 네트워크 문제: network-issues

연결 시간: 연결 시간

GET Call::
참고: {site_id}을(를) 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 협회: 협회
  • 권한 부여: 권한 부여
  • DHCP 참조: DHCP DHCP
  • 인터넷 서비스: IP 서비스\u000C

SLE 비율 계산

SLE 메트릭 성공률은 선택한 기간 동안 임계값이 충족된 빈도의 백분율로 계산됩니다. 분류기도 백분율로 계산되지만, 이러한 값은 상위 장애에 미치는 영향을 나타냅니다.

예를 들어 아래 스크린샷은 연결 시간이 96%의 시간 동안 성공했음을 보여줍니다. 오후 3:00-4:00 사이에 성공적으로 연결한 모든 클라이언트는 4초 임계값 이내에 연결 프로세스를 완료했습니다.

Success Rate on the Time to Connect Root Cause Analysis Page

이 메트릭의 성공률(%)은 "메트릭 요약" API 엔드포인트에서 파생됩니다.

참고: site_id를 실제 사이트 ID로 바꿉니다.

메트릭 실패율은 실패(sle.samples.degraded)를 합계(sle.samples.total)로 나누어 계산됩니다. 그런 다음 성공률 백분율로 변환됩니다. 위의 API 응답 페이로드를 사용하여 계산은 다음과 같습니다.

이 스크린샷은 메트릭 오류(DHCP, 권한 부여, 연결 및 인터넷 서비스)에 기여한 분류자를 보여줍니다.

Example: Classifier Percentages

분류자의 영향(%)은 동일한 "메트릭 요약" API 엔드포인트에서 파생됩니다.

참고: site_id를 실제 사이트 ID로 바꿉니다.

분류기 영향은 분류기의 실패(classifiers[n].samples.degraded)를 모든 실패의 합계(classifiers[].samples.degraded)로 나누어 계산됩니다. 이것은 백분율로 변환됩니다. 위의 API 응답 페이로드를 사용하여 DHCP에 대한 계산은 다음과 같습니다.

SLE 모니터링

SLE 데이터는 10분마다 업데이트됩니다. 그러나 SLE는 이 세분성에서 모니터링할 때 변동이 발생하기 쉽습니다. 따라서 명시적인 시작 및 종료 시간을 사용하여 1시간 간격으로 쿼리하고 시간당 한 번만 폴링하는 것이 좋습니다.