REST Monitoring API로 연결 레벨 통계 보기

시스템 관리자는 REST Monitoring API를 사용하여 연결 레벨 모니터링 통계를 볼 수 있습니다.

이 태스크 정보

시스템 관리자는 REST Monitoring API 또는 IBM® IoT MessageSight Web UI를 사용하여 연결 레벨 통계를 볼 수 있습니다. IBM IoT MessageSight Web UI를 사용하여 연결 레벨 통계를 보는 방법에 대한 자세한 정보는 GUI를 사용하여 연결 레벨 통계 보기를 참조하십시오.

프로시저

REST Monitoring API를 사용하여 연결 레벨 모니터링 통계를 작성할 수 있습니다. 연결 모니터링 데이터는 주기적으로 수집되고 캐시됩니다. 연결 모니터링 데이터를 위한 캐시는 60초마다 업데이트됩니다. 따라서 생성된 통계는 최대 60초가 지난 통계일 수 있으며 IBM IoT MessageSight 서버 시작 시 이 명령을 실행할 경우 즉시 제공되지 않을 수도 있습니다. 연결 레벨 모니터링 통계를 작성하려면 다음 단계를 완료하십시오.

  1. IBM IoT MessageSight REST API GET 메소드를 다음 IBM IoT MessageSight 구성 URI와 함께 사용하십시오.

    http://<admin-endpoint-IP:Port>/ima/v1/monitor/<Object Type>

  2. JSON 페이로드(payload)에서 리턴할 통계를 요청하는 조회 매개변수를 제공하십시오. 다음 예는 cURL을 사용하여 연결 레벨 관련 통계를 작성합니다.
    curl -X GET http://127.0.0.1:9089/ima/v1/monitor/Connection?Endpoint=Endpoint%26StatType=StatType

    여기서 변수는 다음과 같습니다.

    • Endpoint
      엔드 포인트의 이름을 지정합니다.
    • StatType
      결과의 순서를 정하는 데 사용할 데이터 유형을 지정합니다.
      이 값은 다음 값 중 하나입니다.
      NewestConnection
      최신 연결입니다.
      OldestConnection
      가장 오래된 연결입니다.
      HighestThroughputMsgs
      메시지의 최고 처리량입니다.
      LowestThroughputMsgs
      메시지의 최저 처리량입니다.
      HighestThroughputKB
      데이터의 최고 처리량(KB/초)입니다.
      LowestThroughputKB
      데이터의 최저 처리량(KB/초)입니다.
      기본값은 NewestConnection입니다.
    참고: 연결 데이터는 최대 60초가 지난 것일 수 있습니다.

결과

다음 필드가 리턴됩니다.
  • Name
    문자열
    연결 이름입니다. 일반적으로 클라이언트 ID가 사용됩니다.
  • Protocol
    문자열
    프로토콜의 이름입니다.
  • ClientAddr
    문자열
    클라이언트 IP 주소입니다.
  • UserId
    문자열
    기본 사용자 ID입니다.
  • Endpoint
    문자열
    엔드 포인트의 이름입니다.
  • Port
    숫자
    IBM IoT MessageSight 서버 포트입니다.
  • ConnectTime
    숫자
    unix epoch 이후의 마이크로초 수를 지정합니다.
    연결이 작성된 시간입니다.
  • Duration
    숫자
    나노초(ns) 단위의 연결 지속 시간입니다.
  • ReadBytes
    숫자
    연결 시간 이후에 읽은 바이트 수입니다.
  • ReadMsg
    숫자
    연결 시간 이후에 읽은 메시지 수입니다.
  • WriteBytes
    숫자
    연결 시간 이후에 쓴 바이트 수입니다.
  • WriteMsg
    숫자
    연결 시간 이후에 쓴 메시지 수입니다.

다음 예에서는 cURL을 사용하여 메시지의 최고 처리량에 따라 순서화된 연결에 대한 통계를 작성하기 위해 GET 메소드가 사용되는 방법을 보여줍니다.

curl -X GET http://127.0.0.1:9089/ima/v1/monitor/Connection?Endpoint=DemoEndpoint%26StatType=HighestThroughputMsgs
 
 

다음 예에서는 메시지의 최고 처리량을 가지고 있는 엔드 포인트에 대한 통계를 작성하기 위해 사용된 GET 메소드에 대한 성공적인 응답 예를 보여줍니다.

{ "Version":"v1", "Connection": [ { "Name":"DemoClientId","Protocol":"mqtt","ClientAddr":"9.20.230.65","UserId":"",
"Endpoint":"DemoEndpoint","Port":16102,"ConnectTime":1446728129213566618,"Duration":160676522991,"ReadBytes":39,"ReadMsg":0,
"WriteBytes":14,"WriteMsg":0} } ] }



피드백

시간소인 아이콘 마지막 업데이트 날짜: 2017년 9월 27일 수요일
http://pic.dhe.ibm.com/infocenter/ism/v1r0m0/com.ibm.ism.doc/Monitoring/admin00012.html