Edge 통계 조회
    • PDF

    Edge 통계 조회

    • PDF

    기사 요약

    개요

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

    요청

    요청 URL

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

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    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
    

    응답 예시

    {
       "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
             }
          ]
       }
    }
    

    오류 코드

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

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

    What's Next
    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.