---
title: "엣지 통계 조회"
slug: "edge-statistics-summary"
updated: 2026-09-17T09:16:20Z
published: 2026-09-17T09:16:20Z
canonical: "api.ncloud-docs.com/edge-statistics-summary"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 엣지 통계 조회

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

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

## 요청

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

| 메서드 | URI |
| --- | --- |
| GET | /api/v1/statistics/{profileId}/{edgeId} |

### 요청 헤더

Global Edge API에서 공통으로 사용하는 헤더에 대한 정보는 [Global Edge 요청 헤더](/docs/edge-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 경로 파라미터

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `profileId` | Long | Required | 프로필 아이디 - [프로필 목록 조회](/docs/profile-listing) 참조 |
| `edgeId` | Long | Required | 엣지 아이디 - [엣지 목록 조회](/docs/edge-listing) 참조 |

### 요청 쿼리 파라미터

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `dateFrom` | String | Required | 조회 시작 일시 - ISO 8601 형식(UTC 기준) - 730일 전까지 입력 가능 |
| `dateTo` | String | Required | 조회 종료 일시 - ISO 8601 형식(UTC 기준) - 현재 시간까지 입력 가능 |

### 요청 예시

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

```
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}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `code` | String | - | 응답 코드 |
| `message` | String | - | 응답 메시지 |
| `result` | Object | - | 응답 결과 |
| `result.dateFrom` | String | - | 조회 시작 일시 - ISO 8601 형식(UTC 기준) |
| `result.dateTo` | String | - | 조회 종료 일시 - ISO 8601 형식(UTC 기준) |
| `result.interval` | Long | - | 집계 주기(초) |
| `result.hitsTotal` | Object | - | 응답 수 기준 통계 |
| `result.hitsTotal.offload` | Object | - | 오프로드 통계 |
| `result.hitsTotal.offload.value` | Double | - | 오프로드 평균 |
| `result.hitsTotal.offload.min` | Double | - | 오프로드 최솟값 |
| `result.hitsTotal.offload.max` | Double | - | 오프로드 최댓값 |
| `result.hitsTotal.offload.minDate` | String | - | 오프로드 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.offload.maxDate` | String | - | 오프로드 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.edgeHits` | Object | - | 엣지 응답 수 통계 |
| `result.hitsTotal.edgeHits.value` | Long | - | 엣지 응답 수 합계 |
| `result.hitsTotal.edgeHits.min` | Long | - | 엣지 응답 수 최솟값 |
| `result.hitsTotal.edgeHits.max` | Long | - | 엣지 응답 수 최댓값 |
| `result.hitsTotal.edgeHits.minDate` | String | - | 엣지 응답 수 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.edgeHits.maxDate` | String | - | 엣지 응답 수 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.originShieldHits` | Object | - | 오리진 쉴드 응답 수 통계 |
| `result.hitsTotal.originShieldHits.value` | Long | - | 오리진 쉴드 응답 수 합계 |
| `result.hitsTotal.originShieldHits.min` | Long | - | 오리진 쉴드 응답 수 최솟값 |
| `result.hitsTotal.originShieldHits.max` | Long | - | 오리진 쉴드 응답 수 최댓값 |
| `result.hitsTotal.originShieldHits.minDate` | String | - | 오리진 쉴드 응답 수 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.originShieldHits.maxDate` | String | - | 오리진 쉴드 응답 수 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.originHits` | Object | - | 오리진 응답 수 통계 |
| `result.hitsTotal.originHits.value` | Long | - | 오리진 응답 수 합계 |
| `result.hitsTotal.originHits.min` | Long | - | 오리진 응답 수 최솟값 |
| `result.hitsTotal.originHits.max` | Long | - | 오리진 응답 수 최댓값 |
| `result.hitsTotal.originHits.minDate` | String | - | 오리진 응답 수 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.originHits.maxDate` | String | - | 오리진 응답 수 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.errorHits` | Object | - | 오류 응답 수 통계 |
| `result.hitsTotal.errorHits.value` | Long | - | 오류 응답 수 합계 |
| `result.hitsTotal.errorHits.min` | Long | - | 오류 응답 수 최솟값 |
| `result.hitsTotal.errorHits.max` | Long | - | 오류 응답 수 최댓값 |
| `result.hitsTotal.errorHits.minDate` | String | - | 오류 응답 수 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.hitsTotal.errorHits.maxDate` | String | - | 오류 응답 수 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal` | Object | - | 트래픽 기준 전체 통계 |
| `result.bytesTotal.offload` | Object | - | 오프로드 트래픽 통계 |
| `result.bytesTotal.offload.value` | Double | - | 오프로드 트래픽 평균 |
| `result.bytesTotal.offload.min` | Double | - | 오프로드 트래픽 최솟값 |
| `result.bytesTotal.offload.max` | Double | - | 오프로드 트래픽 최댓값 |
| `result.bytesTotal.offload.minDate` | String | - | 오프로드 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.offload.maxDate` | String | - | 오프로드 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.edgeBytes` | Object | - | 엣지 트래픽 통계(Bytes) |
| `result.bytesTotal.edgeBytes.value` | Long | - | 엣지 트래픽 합계 |
| `result.bytesTotal.edgeBytes.min` | Long | - | 엣지 트래픽 최솟값 |
| `result.bytesTotal.edgeBytes.max` | Long | - | 엣지 트래픽 최댓값 |
| `result.bytesTotal.edgeBytes.minDate` | String | - | 엣지 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.edgeBytes.maxDate` | String | - | 엣지 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originShieldBytes` | Object | - | 오리진 쉴드 트래픽 통계(Bytes) |
| `result.bytesTotal.originShieldBytes.value` | Long | - | 오리진 쉴드 트래픽 합계 |
| `result.bytesTotal.originShieldBytes.min` | Long | - | 오리진 쉴드 트래픽 최솟값 |
| `result.bytesTotal.originShieldBytes.max` | Long | - | 오리진 쉴드 트래픽 최댓값 |
| `result.bytesTotal.originShieldBytes.minDate` | String | - | 오리진 쉴드 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originShieldBytes.maxDate` | String | - | 오리진 쉴드 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originBytes` | Object | - | 오리진 트래픽 통계(Bytes) |
| `result.bytesTotal.originBytes.value` | Long | - | 오리진 트래픽 합계 |
| `result.bytesTotal.originBytes.min` | Long | - | 오리진 트래픽 최솟값 |
| `result.bytesTotal.originBytes.max` | Long | - | 오리진 트래픽 최댓값 |
| `result.bytesTotal.originBytes.minDate` | String | - | 오리진 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originBytes.maxDate` | String | - | 오리진 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.edgeBps` | Object | - | 엣지 트래픽 통계(bps) |
| `result.bytesTotal.edgeBps.value` | Double | - | 엣지 트래픽 평균 |
| `result.bytesTotal.edgeBps.min` | Double | - | 엣지 트래픽 최솟값 |
| `result.bytesTotal.edgeBps.max` | Double | - | 엣지 트래픽 최댓값 |
| `result.bytesTotal.edgeBps.minDate` | String | - | 엣지 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.edgeBps.maxDate` | String | - | 엣지 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originShieldBps` | Object | - | 오리진 쉴드 트래픽 통계(bps) |
| `result.bytesTotal.originShieldBps.value` | Double | - | 오리진 쉴드 트래픽 평균 |
| `result.bytesTotal.originShieldBps.min` | Double | - | 오리진 쉴드 트래픽 최솟값 |
| `result.bytesTotal.originShieldBps.max` | Double | - | 오리진 쉴드 트래픽 최댓값 |
| `result.bytesTotal.originShieldBps.minDate` | String | - | 오리진 쉴드 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originShieldBps.maxDate` | String | - | 오리진 쉴드 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originBps` | Object | - | 오리진 트래픽 통계(bps) |
| `result.bytesTotal.originBps.value` | Double | - | 오리진 트래픽 평균 |
| `result.bytesTotal.originBps.min` | Double | - | 오리진 트래픽 최솟값 |
| `result.bytesTotal.originBps.max` | Double | - | 오리진 트래픽 최댓값 |
| `result.bytesTotal.originBps.minDate` | String | - | 오리진 트래픽 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.originBps.maxDate` | String | - | 오리진 트래픽 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.errorHits` | Object | - | 오류 응답 수 통계 |
| `result.bytesTotal.errorHits.value` | Long | - | 오류 응답 수 합계 |
| `result.bytesTotal.errorHits.min` | Long | - | 오류 응답 수 최솟값 |
| `result.bytesTotal.errorHits.max` | Long | - | 오류 응답 수 최댓값 |
| `result.bytesTotal.errorHits.minDate` | String | - | 오류 응답 수 최솟값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.bytesTotal.errorHits.maxDate` | String | - | 오류 응답 수 최댓값 기록 일시 - ISO 8601 형식(UTC 기준) |
| `result.responseSegments` | Array | - | HTTP 응답 코드별 통계: [responseSegments](/docs/edge-statistics-summary#responseSegments) |
| `result.trafficSegments` | Array | - | 엣지별 통계: [trafficSegments](/docs/edge-statistics-summary#trafficSegments) |
| `result.statistics` | Array | - | 시간별 통계: [statistics](/docs/edge-statistics-summary#statistics) |

#### `responseSegments`

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `responseCode` | String | - | HTTP 응답 코드 |
| `edgeHits` | Long | - | 엣지 응답 수 합계 |
| `originHits` | Long | - | 오리진 응답 수 합계 |

#### `trafficSegments`

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `edgeId` | Long | - | 엣지 아이디 |
| `edgeName` | String | - | 엣지 이름 |
| `offloadHits` | Double | - | 엣지 응답 수 오프로드 평균 |
| `edgeHits` | Long | - | 엣지 응답 수 합계 |
| `originHits` | Long | - | 오리진 응답 수 합계 |
| `offloadBytes` | Double | - | 엣지 트래픽 오프로드 평균 |
| `edgeBytes` | Long | - | 엣지 트래픽 합계(Bytes) |
| `originShieldBytes` | Long | - | 오리진 쉴드 트래픽 합계(Bytes) |
| `originBytes` | Long | - | 오리진 트래픽 합계(Bytes) |

#### `statistics`

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `time` | String | - | 집계 시간 - ISO 8601 형식(UTC 기준) |
| `offloadHits` | Double | - | 해당 시간의 오프로드 평균 |
| `edgeHits` | Long | - | 해당 시간의 엣지 응답 수 합계 |
| `originShieldHits` | Long | - | 해당 시간의 오리진 쉴드 응답 수 합계 |
| `originHits` | Long | - | 해당 시간의 오리진 응답 수 합계 |
| `edgeSuccessCount` | Long | - | 해당 시간의 엣지 2xx 응답 수 합계 |
| `edgeRedirectionCount` | Long | - | 해당 시간의 엣지 3xx 응답 수 합계 |
| `edgeClientErrorCount` | Long | - | 해당 시간의 엣지 4xx 응답 수 합계 |
| `edgeServerErrorCount` | Long | - | 해당 시간의 엣지 5xx 응답 수 합계 |
| `originSuccessCount` | Long | - | 해당 시간의 오리진 2xx 응답 수 합계 |
| `originRedirectionCount` | Long | - | 해당 시간의 오리진 3xx 응답 수 합계 |
| `originClientErrorCount` | Long | - | 해당 시간의 오리진 4xx 응답 수 합계 |
| `originServerErrorCount` | Long | - | 해당 시간의 오리진 5xx 응답 수 합계 |
| `offloadBytes` | Double | - | 해당 시간의 트래픽 오프로드 평균 |
| `edgeBytes` | Long | - | 해당 시간의 엣지 트래픽 합계 |
| `originShieldBytes` | Long | - | 해당 시간의 오리진 쉴드 트래픽 합계 |
| `originBytes` | Long | - | 해당 시간의 오리진 트래픽 합계 |
| `edgeBps` | Double | - | 해당 시간의 엣지 트래픽(bps) |
| `originShieldBps` | Double | - | 해당 시간의 오리진 쉴드 트래픽(bps) |
| `originBps` | Double | - | 해당 시간의 오리진 트래픽(bps) |

### 응답 상태 코드

Global Edge API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Global Edge 응답 상태 코드](/docs/edge-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

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

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