--- title: "모니터링 데이터 조회" slug: "getglobalcdnmonitoringdata" tags: ["Global CDN"] updated: 2026-10-22T10:47:15Z published: 2026-10-22T10:47:15Z canonical: "api-gov.ncloud-docs.com/getglobalcdnmonitoringdata" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 모니터링 데이터 조회 Classic/VPC 환경에서 이용 가능합니다. 조회 기간 내 CDN 서비스 모니터링 데이터를 조회합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /cdn/v2/getGlobalCdnMonitoringData | 참고 가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다. ### 요청 헤더 Global CDN API에서 공통으로 사용하는 헤더에 대한 정보는 [Global CDN 요청 헤더](/docs/global-cdn-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `cdnInstanceNoList.N` | Array | Required | CDN 인스턴스 번호 목록 - [인스턴스 조회](/docs/networking-cdn-getglobalcdninstancelist) 참조 - <예시> `cdnInstanceNoList.1=2323&cdnInstanceNoList.2=1212` | | `startDate` | String | Required | 조회 시작 일시 - yyyyMMddHH 형식 - 조회 시작 일시부터 1시간 간격으로 집계 데이터 조회 | | `endDate` | String | Required | 조회 종료 일시 - yyyyMMddHH 형식 | | `responseFormatType` | String | Optional | 응답 데이터의 형식 - `xml` (기본값) \| `json` | ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.gov-ntruss.com/cdn/v2/getGlobalCdnMonitoringData ?cdnInstanceNoList.1=2851**** &startDate=2025071815&endDate=2025071817 &responseFormatType=json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `getGlobalCdnMonitoringDataResponse` | Object | - | 응답 결과 | | `getGlobalCdnMonitoringDataResponse.startDate` | String | - | 조회 시작 일시 | | `getGlobalCdnMonitoringDataResponse.endDate` | String | - | 조회 종료 일시 | | `getGlobalCdnMonitoringDataResponse.aggregation` | Number | - | 집계 주기(초) | | `getGlobalCdnMonitoringDataResponse.volumeDataRecordList` | Array | - | 전송량 데이터 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.requestDataRecordList` | Array | - | 요청 수 데이터 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.bandwidthDataRecordList` | Array | - | 트래픽 데이터 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.offloadDataRecordList` | Array | - | 히트율 데이터 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.twoxxEdgeHitsDataRecordList` | Array | - | 2xx 응답 수 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.threexxEdgeHitsDataRecordList` | Array | - | 3xx 응답 수 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.fourxxEdgeHitsDataRecordList` | Array | - | 4xx 응답 수 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.fivexxEdgeHitsDataRecordList` | Array | - | 5xx 응답 수 목록 - `[timestamp, value]` 형식 | | `getGlobalCdnMonitoringDataResponse.volumeDataUnit` | String | - | 전송량 단위: `bytes` (유효 값) | | `getGlobalCdnMonitoringDataResponse.requestDataUnit` | String | - | 요청 수 단위: `count` (유효 값) | | `getGlobalCdnMonitoringDataResponse.bandwidthDataUnit` | String | - | 트래픽 단위: `Mbps` (유효 값) | | `getGlobalCdnMonitoringDataResponse.offloadDataUnit` | String | - | 히트율 단위: `percent` (유효 값) | | `getGlobalCdnMonitoringDataResponse.xxxEdgeHitsDataUnit` | String | - | 응답 수 단위: `count` (유효 값) | | `getGlobalCdnMonitoringDataResponse.pointStart` | Number | - | 조회 시작 일시(밀리초) - Unix Timestamp 형식 | | `getGlobalCdnMonitoringDataResponse.pointInterval` | Number | - | 집계 주기(밀리초) | | `getGlobalCdnMonitoringDataResponse.maxBandwidth` | Number | - | 조회 기간 내 최대 트래픽 | | `getGlobalCdnMonitoringDataResponse.totalVolume` | Number | - | 조회 기간 내 총 전송량 | | `getGlobalCdnMonitoringDataResponse.totalRequest` | Number | - | 조회 기간 내 총 요청 수 | | `getGlobalCdnMonitoringDataResponse.maxOffload` | Number | - | 조회 기간 내 최대 히트율 | | `getGlobalCdnMonitoringDataResponse.totalTwoxxEdgeHits` | Number | - | 조회 기간 내 총 2xx 응답 수 | | `getGlobalCdnMonitoringDataResponse.totalThreexxEdgeHits` | Number | - | 조회 기간 내 총 3xx 응답 수 | | `getGlobalCdnMonitoringDataResponse.totalFourxxEdgeHits` | Number | - | 조회 기간 내 총 4xx 응답 수 | | `getGlobalCdnMonitoringDataResponse.totalFivexxEdgeHits` | Number | - | 조회 기간 내 총 5xx 응답 수 | | `getGlobalCdnMonitoringDataResponse.requestId` | String | - | 요청에 대한 아이디 - UUID 형식 | | `getGlobalCdnMonitoringDataResponse.returnCode` | String | - | 응답 코드 | | `getGlobalCdnMonitoringDataResponse.returnMessage` | String | - | 응답 메시지 | ### 응답 상태 코드 Global CDN API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Global CDN 응답 상태 코드](/docs/global-cdn-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` { "getGlobalCdnMonitoringDataResponse": { "startDate": "2025071815", "endDate": "2025071817", "aggregation": 3600, "volumeDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 1371687657 ] ], "requestDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 6 ] ], "bandwidthDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 2.9069850858052573 ] ], "offloadDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 33.33333333333333 ] ], "twoxxEdgeHitsDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 4 ] ], "threexxEdgeHitsDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 0 ] ], "fourxxEdgeHitsDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 2 ] ], "fivexxEdgeHitsDataRecordList": [ [ 1752818400000, 0 ], [ 1752822000000, 0 ] ], "volumeDataUnit": "bytes", "requestDataUnit": "count", "bandwidthDataUnit": "Mbps", "offloadDataUnit": "percent", "xxxEdgeHitsDataUnit": "count", "pointStart": 1752818400000, "pointInterval": 3600000, "maxBandwidth": 2.9069850858052573, "totalVolume": 1371687657, "totalRequest": 6, "maxOffload": 33.33333333333333, "totalTwoxxEdgeHits": 4, "totalThreexxEdgeHits": 0, "totalFourxxEdgeHits": 2, "totalFivexxEdgeHits": 0, "requestId": "963722f0-****-****-****-f11e9fc61b84", "returnCode": "0", "returnMessage": "success" } } ```