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를 사용하여 네트워크 성능에 대한 인사이트를 얻을 수 있습니다.

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

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

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

SLE

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

메모: {org_id}을 조직 ID로 바꿉니다.

자세한 내용은 SLE 개요를 참조하세요.

통찰력

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

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

  • GetSiteInsightMetrics (영문)
  • GetSiteInsightMetricsForDevice
  • 클라이언트를 위한 사이트 인사이트 메트릭 GetSiteInsightMetrics

자세한 내용은 Insights 개요를 참조하십시오.

지표 및 분류자

Juniper Mist SLE 및 Insights 엔드포인트는 지표 및 분류자를 지원합니다. 메트릭은 서비스 수준이 구성된 임계값을 충족하는지 여부를 추적합니다. 메트릭이 임계값을 충족하지 않는 경우 이 오류는 오류가 발생한 위치를 더 자세히 이해하기 위해 분류자 중 하나에 기인할 수 있습니다.

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

인사이트 메트릭 목록을 가져오려면 다음 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
  • 사이트 다운: 사이트 다운

수용 인원: 수용 인원

GET 전화:
메모: {site_id}을 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • AP 로드: AP 로드
  • 비 WiFi 간섭: 비 Wi-Fi 간섭
  • WiFi 간섭: 와이파이 간섭

적용 범위: 적용 범위

GET 전화:
메모: {site_id}을 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 비대칭 다운링크: 비대칭-다운링크
  • 비대칭 업링크: asymmetry-uplink
  • 약한 신호: 약한 신호

로밍: 로밍

GET 전화:
메모: {site_id}을 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 빠른 로밍 실패: No-Fast-Roam
  • 느린 11r 로밍: Suboptimal-11r-roam
  • 느린 OKC 로밍: Suboptimal-okc-roam (최적이 아닌-okc-roam)
  • 느린 표준 로밍: 느린 로밍

성공적인 연결: 성공적인 연결

GET 전화:
메모: {site_id}을 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • Association: 협회
  • 권한 부여: 권한 부여
  • DHCP : DHCP (영문)

처리량: 처리량

GET 전화:
메모: {site_id}을 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • 수용 인원: 수용 인원
  • 적용 범위: 적용 범위
  • 장치 기능: device-capability
  • 네트워크 문제: 네트워크 문제

연결 시간: 연결 시간

전화 받기::
메모: {site_id}을 사이트 ID로 바꿉니다.
샘플 요청: 샘플 응답:
  • Association: 협회
  • 권한 부여: 권한 부여
  • 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시간 간격으로 쿼리하고 시간당 한 번만 폴링하는 것이 좋습니다.