Peer Pod 사용량 조회

Prev Next

VPC 환경에서 이용 가능합니다.

블록체인 네트워크 내 Peer Pod 리소스(CPU, Memory, Storage)의 사용량을 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /networks/{networkId}/peers/{peerId}/usage

요청 헤더

Blockchain Service API에서 공통으로 사용하는 헤더에 대한 정보는 Blockchain Service 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
networkId Long Required 네트워크 아이디
peerId Long Required Peer 아이디

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
startTime Integer Required 사용량 조회 시작 시각(Unix Timestamp)
  • <예시> 2024년 07월 30일 09시 00분 00초인 경우 startTime=1722297600000
endTime Integer Required 사용량 조회 종료 시각(Unix Timestamp)
  • <예시> 2024년 07월 30일 15시 00분 00초인 경우 endTime=1722319200000
isCouchDb Boolean Optional CouchDB 여부
  • true | false
    • true: CoucbDB일 경우
    • false: CouchDB가 아닐 경우(LevelDB)

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://blockchainservice.apigw.ntruss.com/api/v1/networks/{networkId}/peers/{peerId}/usage?startTime=1722297600000&endTime=1722319200000&isCouchDb=false' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
networkId Long - 네트워크 아이디
nodeId String - Peer 노드 아이디
nodeType String - Peer 노드 타입
containerNo Long - Ncloud Kubernetes Service 컨테이너 번호
  • CA는 해당사항 없음
cpuUsage Map - 이벤트 발생 시간당 CPU 사용량 (단위: vCPU)
  • <예시> "cpuUsage": {"1722306600000": 0.0077477186}
memUsage Map - 이벤트 발생 시간당 Memory 사용량 (단위: MiB)
  • <예시> "memUsage": {"1722306600000": 47}
diskUsage Map - 이벤트 발생 시간당 Storage 사용량(단위: %)
  • <예시> "diskUsage": {"1722306600000": 0}

응답 상태 코드

Blockchain Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Blockchain Service 공통 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "networkId": 1630,
    "nodeId": "25738634",
    "nodeType": "peer",
    "containerNo": 0,
    "cpuUsage": {
        "1722306600000": 0.0077477186,
        "1722308400000": 0.0076888553,
        "1722313800000": 0.007819935,
        "1722304800000": 0.0071446504,
        "1722315600000": 0.008204839,
        "1722299400000": 0.0074888305,
        "1722317400000": 0.007889176,
        "1722301200000": 0.0073726247,
        "1722312000000": 0.0076033045,
        "1722303000000": 0.0076380465,
        "1722310200000": 0.007312449
    },
    "memUsage": {
        "1722306600000": 47,
        "1722308400000": 47,
        "1722313800000": 48,
        "1722304800000": 47,
        "1722315600000": 48,
        "1722299400000": 47,
        "1722317400000": 48,
        "1722301200000": 47,
        "1722312000000": 47,
        "1722303000000": 47,
        "1722310200000": 47
    },
    "diskUsage": {
        "1722306600000": 0,
        "1722308400000": 0,
        "1722313800000": 0,
        "1722304800000": 0,
        "1722315600000": 0,
        "1722299400000": 0,
        "1722317400000": 0,
        "1722301200000": 0,
        "1722312000000": 0,
        "1722303000000": 0,
        "1722310200000": 0
    }
}