엣지 통계 조회

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

엣지의 사용량 통계 정보를 조회합니다.

요청

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

요청 헤더

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

요청 경로 파라미터

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

요청 쿼리 파라미터

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

요청 예시

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

curl --location --request GET 'https://edge.apigw.ntruss.com/api/v1/statistics/4210/11207?dateFrom=2025-07-17T07%3A00%3A00Z&dateTo=2025-07-17T08%3A00%3A00Z' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 바디

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

responseSegments

responseSegments에 대한 설명은 다음과 같습니다.

trafficSegments

trafficSegments에 대한 설명은 다음과 같습니다.

statistics

statistics에 대한 설명은 다음과 같습니다.

응답 상태 코드

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

응답 예시

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

{
    "code": "0000",
    "message": "Success",
    "result": {
        "dateFrom": "2025-07-17T07:00:00Z",
        "dateTo": "2025-07-17T07:23:38.714693345Z",
        "interval": 300,
        "hitsTotal": {
            "offload": {
                "value": 3.142857142857143,
                "min": 0,
                "max": 44,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "edgeHits": {
                "value": 13,
                "min": 0,
                "max": 13,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "originShieldHits": {
                "value": 0,
                "min": 0,
                "max": 0,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:10:00Z"
            },
            "originHits": {
                "value": 2,
                "min": 0,
                "max": 2,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "errorHits": {
                "value": 34,
                "min": 0,
                "max": 14,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            }
        },
        "bytesTotal": {
            "offload": {
                "value": 7.142857142857143,
                "min": 0,
                "max": 100,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:05:00Z"
            },
            "edgeBytes": {
                "value": 48163,
                "min": 0,
                "max": 45631,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "originShieldBytes": {
                "value": 0,
                "min": 0,
                "max": 0,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:10:00Z"
            },
            "originBytes": {
                "value": 18522,
                "min": 0,
                "max": 18522,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "edgeBps": {
                "value": 91.73905,
                "min": 0,
                "max": 1216.8267,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "originShieldBps": {
                "value": 0,
                "min": 0,
                "max": 0,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:10:00Z"
            },
            "originBps": {
                "value": 35.28,
                "min": 0,
                "max": 493.92,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "errorHits": {
                "value": 34,
                "min": 0,
                "max": 14,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            }
        },
        "responseSegments": [
            {
                "responseCode": "2xx",
                "edgeHits": 13,
                "originHits": 2
            },
            {
                "responseCode": "3xx",
                "edgeHits": 0,
                "originHits": 0
            },
            {
                "responseCode": "4xx",
                "edgeHits": 20,
                "originHits": 14
            },
            {
                "responseCode": "5xx",
                "edgeHits": 0,
                "originHits": 0
            }
        ],
        "trafficSegments": [
            {
                "edgeId": 11207,
                "edgeName": "edge001",
                "offloadHits": 3.142857142857143,
                "edgeHits": 13,
                "originHits": 2,
                "offloadBytes": 7.142857142857143,
                "edgeBytes": 48163,
                "originShieldBytes": 0,
                "originBytes": 18522
            }
        ],
        "statistics": [
            {
                "time": "2025-07-17T07:00:00Z",
                "offloadHits": 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,
                "edgeBytes": 0,
                "originShieldBytes": 0,
                "originBytes": 0,
                "edgeBps": 0,
                "originShieldBps": 0,
                "originBps": 0
            },
            ...
        ]
    }
}