MENU
      Edge 통계 조회

        Edge 통계 조회


        기사 요약

        개요

        Edge의 사용량 통계를 조회합니다.

        요청

        요청 URL

        GET
        https://edge.apigw.ntruss.com/api/v1/statistics/{profileId}/{edgeId}
        Plain text

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        profileIdYesLongProfile 번호
        edgeIdYesLongEdge 번호
        dateFromYesStringISO 날짜 포맷
        yyyy-MM-dd'T'HH:mm:ss
        Min: 730일 전
        조회 시작일
        (UTC)
        dateToYesStringISO 날짜 포맷
        yyyy-MM-dd'T'HH:mm:ss
        Max: 현재 시간
        조회 종료일
        (UTC)

        응답

        모든 응답은 HTTP Status Code로 성공 또는 실패를 반환합니다.

        HTTP 상태 코드코드 메시지설명
        200Success조회 성공
        401Unauthorized인증 실패
        500Internal Server Error서버 오류

        StatisticsSummary

        항목타입설명
        dateFromZonedDateTime통계 조회 시작 시간 (UTC)
        dateToZonedDateTime통계 조회 종료 시간 (UTC)
        intervalLong통계 데이터 간격(초)
        hitsTotalHitsTotal전체 Request 관련 통계 요약
        hitsTotal.offload.valueDouble전체 오프로드 평균
        hitsTotal.offload.minDouble전체 통계 중 오프로드 최저값
        hitsTotal.offload.maxDouble전체 통계 중 오프로드 최대값
        hitsTotal.edgeHits.valueLong전체 Edge Hit 합계
        hitsTotal.edgeHits.minLong전체 통계 중 Edge Hit 최저값
        hitsTotal.edgeHits.maxLong전체 통계 중 Edge Hit 최대값
        hitsTotal.originShieldHits.valueLong전체 Origin Shield Hit 합계
        hitsTotal.originShieldHits.minLong전체 통계 중 Origin Shield Hit 최저값
        hitsTotal.originShieldHits.maxLong전체 통계 중 Origin Shield Hit 최대값
        hitsTotal.originHits.valueLong전체 Origin Hit 합계
        hitsTotal.originHits.minLong전체 통계 중 Origin Hit 최저값
        hitsTotal.originHits.maxLong전체 통계 중 Origin Hit 최대값
        hitsTotal.errorHits.valueLong전체 Error Hit 합계
        hitsTotal.errorHits.minLong전체 통계 중 Error Hit 최저값
        hitsTotal.errorHits.maxLong전체 통계 중 Error Hit 최대값
        bytesTotal.offload.valueDouble전체 오프로드 트래픽 평균
        bytesTotal.offload.minDouble전체 통계 중 오프로드 트래픽 최저값
        bytesTotal.offload.maxDouble전체 통계 중 오프로드 트래픽 최대값
        bytesTotal.edgeBytes.valueLong전체 Edge 트래픽(Byte) 합계
        bytesTotal.edgeBytes.minLong전체 통계 중 Edge 트래픽(Byte) 최저값
        bytesTotal.edgeBytes.maxLong전체 통계 중 Edge 트래픽(Byte) 최대값
        bytesTotalBytesTotal전체 트래픽(Byte) 관련 통계 요약
        bytesTotal.originShieldBytes.valueLong전체 Origin Shield 트래픽(Byte) 합계
        bytesTotal.originShieldBytes.minLong전체 통계 중 Origin Shield 트래픽(Byte) 최저값
        bytesTotal.originShieldBytes.maxLong전체 통계 중 Origin Shield 트래픽(Byte) 최대값
        bytesTotal.originBytes.valueLong전체 Origin 트래픽(Byte) 합계
        bytesTotal.originBytes.minLong전체 통계 중 Origin 트래픽(Byte) 최저값
        bytesTotal.originBytes.maxLong전체 통계 중 Origin 트래픽(Byte) 최대값
        bytesTotal.errorHits.valueLong전체 Error Hit 합계
        bytesTotal.errorHits.minLong전체 통계 중 Error Hit 최저값
        bytesTotal.errorHits.maxLong전체 통계 중 Error Hit 최대값
        responseSegmentsList<ResponseSegment>HTTP 응답 코드별 통계 데이터
        responseSegments[].responseCodeString
        2xx / 3xx / 4xx / 5xx
        HTTP 응답 코드
        responseSegments[].edgeHitsLongEdge 응답 코드 발생 합계
        responseSegments[].originHitsLongOrigin 응답 코드 발생 합계
        trafficSegmentsList<TrafficSegments>Edge 별 통계 데이터
        trafficSegments[].edgeIdLongEdge 번호
        trafficSegments[].edgeNameStringEdge 이름
        trafficSegments[].offloadHitsDoubleEdge Hit 오프로드 평균
        trafficSegments[].edgeHitsLong인스턴스의 Edge Hit 발생 합계
        trafficSegments[].originHitsLong인스턴스의 Origin Hit 발생 합계
        trafficSegments[].offloadBytesDoubleEdge 트래픽(Byte) 오프로드 평균
        trafficSegments[].edgeBytesLong인스턴스의 Edge 트래픽(Byte) 발생 합계
        trafficSegments[].originShieldBytesLong인스턴스의 Origin Shield 트래픽(Byte) 발생 합계
        trafficSegments[].originBytesLong인스턴스의 Origin 트래픽(Byte) 발생 합계
        statisticsList<ChartValue>Timestamp 기준으로 종합된 통계
        statistics[].timeZonedDateTime통계 수집 시간대(UTC)
        statistics[].offloadHitsDouble해당 시간대의 오프로드 평균
        statistics[].edgeHitsLong해당 시간대의 Edge Hit 발생 합계
        statistics[].originShieldHitsLong해당 시간대의 Origin Shield Hit 발생 합계
        statistics[].originHitsLong해당 시간대의 Origin Hit 발생 합계
        statistics[].edgeSuccessCountLong해당 시간대의 Edge 2xx 응답 발생 합계
        statistics[].edgeRedirectionCountLong해당 시간대의 Edge 3xx 응답 발생 합계
        statistics[].edgeClientErrorCountLong해당 시간대의 Edge 4xx 응답 발생 합계
        statistics[].edgeServerErrorCountLong해당 시간대의 Edge 5xx 응답 발생 합계
        statistics[].originSuccessCountLong해당 시간대의 Origin 2xx 응답 발생 합계
        statistics[].originRedirectionCountLong해당 시간대의 Origin 3xx 응답 발생 합계
        statistics[].originClientErrorCountLong해당 시간대의 Origin 4xx 응답 발생 합계
        statistics[].originServerErrorCountLong해당 시간대의 Origin 5xx 응답 발생 합계
        statistics[].offloadBytesDouble해당 시간대의 트래픽(Bytes) 오프로드 평균
        statistics[].edgeBpsDouble해당 시간대의 Edge 트래픽(Bytes) 발생 합계
        statistics[].originShieldBpsDouble해당 시간대의 Origin Shield 트래픽(Bytes) 발생 합계
        statistics[].originBpsDouble해당 시간대의 Origin 트래픽(Bytes) 발생 합계

        예시

        요청 예시

        https://edge.apigw.ntruss.com/api/v1/statistics/123/456?dateFrom=2022-11-14T09:25:12.340Z&dateTo=2022-11-16T09:25:12.340Z
        Plain text

        응답 예시

        {
           "code":"0000",
           "message":"Success",
           "result":{
              "dateFrom":"2022-11-14T00:00:00Z",
              "dateTo":"2022-11-16T09:25:16.137098912Z",
              "interval":3600,
              "hitsTotal":{
                 "offload":{
                    "value":0.0,
                    "min":0.0,
                    "max":0.0
                 },
                 "edgeHits":{
                    "value":0,
                    "min":0,
                    "max":0
                 },
                 "originShieldHits":{
                    "value":0,
                    "min":0,
                    "max":0
                 },
                 "originHits":{
                    "value":0,
                    "min":0,
                    "max":0
                 },
                 "errorHits":{
                    "value":0,
                    "min":0,
                    "max":0
                 }
              },
              "bytesTotal":{
                 "offload":{
                    "value":0.0,
                    "min":0.0,
                    "max":0.0
                 },
                 "edgeBytes":{
                    "value":0,
                    "min":0,
                    "max":0
                 },
                 "originShieldBytes":{
                    "value":0,
                    "min":0,
                    "max":0
                 },
                 "originBytes":{
                    "value":0,
                    "min":0,
                    "max":0
                 },
                 "errorHits":{
                    "value":0,
                    "min":0,
                    "max":0
                 }
              },
              "responseSegments":[
                 {
                    "responseCode":"2xx",
                    "edgeHits":0,
                    "originHits":0
                 },
                 {
                    "responseCode":"3xx",
                    "edgeHits":0,
                    "originHits":0
                 },
                 {
                    "responseCode":"4xx",
                    "edgeHits":0,
                    "originHits":0
                 },
                 {
                    "responseCode":"5xx",
                    "edgeHits":0,
                    "originHits":0
                 }
              ],
              "trafficSegments":[
                 {
                    "edgeId":469,
                    "edgeName":"choi-edge-001",
                    "offloadHits":0.0,
                    "edgeHits":0,
                    "originHits":0,
                    "offloadBytes":0.0,
                    "edgeBytes":0,
                    "originShieldBytes":0,
                    "originBytes":0
                 }
              ],
              "statistics":[
                 {
                    "time":"2022-11-14T00:00:00Z",
                    "offloadHits":0.0,
                    "edgeHits":0,
                    "originShieldHits":0,
                    "originHits":0,
                    "edgeSuccessCount":0,
                    "edgeRedirectionCount":0,
                    "edgeClientErrorCount":0,
                    "edgeServerErrorCount":0,
                    "originSuccessCount":0,
                    "originRedirectionCount":0,
                    "originClientErrorCount":0,
                    "originServerErrorCount":0,
                    "offloadBytes":0.0,
                    "edgeBps":0.0,
                    "originShieldBps":0.0,
                    "originBps":0.0
                 },
                 ...(중략)...
                 {
                    "time":"2022-11-16T08:00:00Z",
                    "offloadHits":0.0,
                    "edgeHits":0,
                    "originShieldHits":0,
                    "originHits":0,
                    "edgeSuccessCount":0,
                    "edgeRedirectionCount":0,
                    "edgeClientErrorCount":0,
                    "edgeServerErrorCount":0,
                    "originSuccessCount":0,
                    "originRedirectionCount":0,
                    "originClientErrorCount":0,
                    "originServerErrorCount":0,
                    "offloadBytes":0.0,
                    "edgeBps":0.0,
                    "originShieldBps":0.0,
                    "originBps":0.0
                 }
              ]
           }
        }
        JSON

        오류 코드

        Error 코드설명
        0032허용되지 않은 요청
        0400요청 데이터 형식 불일치
        0401종료일은 시작일보다 빠를 수 없음
        0402통계 일자 범위 초과
        9999서버 오류 발생

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.