---
title: "Cloud Insight 개요"
slug: "management-cloudinsight"
tags: ["Cloud Insight"]
updated: 2026-10-22T10:47:25Z
published: 2026-10-22T10:47:25Z
canonical: "api-gov.ncloud-docs.com/management-cloudinsight"
---

> ## 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.

# Cloud Insight 개요

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

Cloud Insight는 네이버 클라우드 플랫폼이 제공하는 서비스들의 성능 지표를 통합 관리하고, 장애 발생 시 담당자에게 장애 정보를 신속히 전달할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Cloud Insight 서비스에서는 Schema, Plugin, Event Rule, Planned Maintenance 등의 기능에 대한 API를 RESTful 형태로 제공합니다.

## Cloud Insight 지표

Cloud Insight API를 통해 네이버 클라우드 플랫폼 서비스(상품)의 성능/운영 지표(Metric)를 통합 관리하고 다양한 모니터링에 활용할 수 있습니다. 성능/운영 지표를 제공하는 네이버 클라우드 플랫폼 서비스(상품) 정보와 성능/운영 지표에 대한 자세한 설명은 다음을 참조해 주십시오.

- Metric, Dimension, Aggregation, Schema 등 개념에 대한 설명: [Cloud Insight 개념](https://guide-gov.ncloud-docs.com/docs/cloudinsight-info)
- 네이버 클라우드 플랫폼 서비스별(상품별) 성능/운영 지표 정보 확인: [Cloud Insight 지표](/docs/management-cloudinsight-productinfo)

## Cloud Insight 공통 설정

Cloud Insight API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

### 요청

공통 요청 형식을 설명합니다.

#### API URL

요청 API URL은 다음과 같습니다.

| 버전 | API URL | 플랫폼 |
| --- | --- | --- |
| v1.0 | https://cw.apigw.gov-ntruss.com | Classic, VPC |
| v2.0 | https://cloudinsight.apigw.gov-ntrss.com/api/v2 | Classic, VPC |

#### 요청 헤더

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

| 필드 | 필수 여부 | 설명 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초) - API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주 - Unix Timestamp 형식 |
| `x-ncp-iam-access-key` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key - Access Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi-ncpapi#API%EC%9D%B8%EC%A6%9D%ED%82%A4) 참조 - 서브 계정의 Access Key 발급 및 확인: [서브 계정 생성](https://guide-gov.ncloud-docs.com/docs/subaccount-use#%EC%84%9C%EB%B8%8C%EA%B3%84%EC%A0%95%EC%83%9D%EC%84%B1) 참조 |
| `x-ncp-apigw-signature-v2` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 - Secret Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi-ncpapi#API%EC%9D%B8%EC%A6%9D%ED%82%A4) 참조 - 서명 생성: [시그니처 생성](/docs/common-ncpapi-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1) 참조 |
| `Content-type` | Optional | 요청 데이터의 형식 - application/json |
| `x-ncp-dmn_cd` | Optional | 네이버 클라우드 플랫폼 도메인 정보 - [Plugin 관련 API](/docs/management-cloudinsight#Plugin)에서 사용 - `GOV` (기본값) |

### 응답

공통 응답 형식을 설명합니다.

#### 응답 상태 코드

Cloud Insight API는 네이버 클라우드 플랫폼의 공통 응답 상태 코드를 사용합니다. 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud API 응답 상태 코드](/docs/api-call-lgc-errorhandling)를 참조해 주십시오.

## Cloud Insight API 1.0

Cloud Insight 서비스에서 제공하는 API 1.0에 대한 설명은 다음과 같습니다.

### Dashboard

Dashboard 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [GetDashboardList](/docs/management-cloudinsight-getdashboardlist) | 대시보드 목록 조회 |
| [GetDashboardWidgetImage](/docs/management-cloudinsight-getdashboardwidgetimage) | 대시보드 위젯 이미지 파일 다운로드 |
| [GetDashboardWidgetList](/docs/management-cloudinsight-getdashboardwidgetlist) | 대시보드 위젯 목록 조회 |

### Event

Event 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [SearchEvent](/docs/management-cloudinsight-searchevent) | Event 검색 및 조회 |
| [SearchEventById](/docs/management-cloudinsight-searcheventbyid) | Event 아이디 및 Rule 아이디로 Event 상세 조회 |
| [SearchEventCountConsole](/docs/management-cloudinsight-searcheventcountconsole) | Event 발생 횟수 조회 |

### Event Rule

Event Rule 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [CopyRuleGroup](/docs/management-cloudinsight-copyrulegroup) | Event Rule 복사 |
| [CreateMetricsGrp](/docs/management-cloudinsight-createmetricsgrp) | Rule Template(감시 항목 그룹) 생성 |
| [CreateMonitorGrp](/docs/management-cloudinsight-createmonitorgrp) | 감시 대상 그룹 생성 |
| [CreateRuleDirectly](/docs/management-cloudinsight-createruledirectly) | 감시 대상과 감시 항목을 직접 지정하여 Event Rule 생성 |
| [CreateRuleGroup](/docs/management-cloudinsight-createrulegroup) | Event Rule 생성 |
| [DeleteMetricGroupForce](/docs/management-cloudinsight-deletemetricgroupforce) | 특정 Rule Template(감시 항목 그룹)과 관련된 전체 Event Rule 삭제 |
| [DeleteMetricsGrp](/docs/management-cloudinsight-deletemetricsgrp) | Rule Template(감시 항목 그룹) 삭제 |
| [DeleteMetricsGrpByProdKeyAndId](/docs/management-cloudinsight-deletemetricsgrpbyprodkeyandid) | Rule Template 아이디로 Rule Template(감시 항목 그룹) 삭제 |
| [DeleteMonitorGroupForce](/docs/management-cloudinsight-deletemonitorgroupforce) | 특정 감시 대상 그룹과 관련된 전체 Event Rule 삭제 |
| [DeleteMonitorGrp](/docs/management-cloudinsight-deletemonitorgrp) | 감시 대상 그룹 삭제 |
| [DeleteRuleGroup](/docs/management-cloudinsight-deleterulegroup) | Event Rule 삭제 |
| [DeleteRuleGroupByProdKeyAndId](/docs/management-cloudinsight-deleterulegroupbyprodkeyandid) | Event Rule 아이디로 Event Rule 삭제 |
| [GetAllMonitorGrp](/docs/management-cloudinsight-getallmonitorgrp) | 감시 대상 그룹 목록 조회 |
| [GetMetricsGroup](/docs/management-cloudinsight-getmetricsgroup) | 특정 Rule Template(감시 항목 그룹)의 상세 정보 조회 |
| [GetMetricsGroupList](/docs/management-cloudinsight-getmetricsgrouplist) | Rule Template(감시 항목 그룹) 목록 조회 |
| [GetMonitorGrp](/docs/management-cloudinsight-getmonitorgrp) | 특정 감시 대상 그룹의 상세 정보 조회 |
| [GetNotificationRecipientList](/docs/management-cloudinsight-getnotificationrecipientlist) | 통보 대상 조회 |
| [GetRuleGroup](/docs/management-cloudinsight-getrulegroup) | 특정 Event Rule의 상세 정보 조회 |
| [GetRuleGroupByMetricGroupIds](/docs/management-cloudinsight-getrulegroupbymetricgroupids) | Rule Template(감시 항목 그룹)과 관련된 Event Rule 조회 |
| [GetRuleGroupByMonitorGroupIds](/docs/management-cloudinsight-getrulegroupbymonitorgroupids) | 감시 대상 그룹과 관련된 Event Rule 조회 |
| [GetRuleGroupList](/docs/management-cloudinsight-getrulegrouplist) | Event Rule 목록 조회 |
| [RemoveResourceFromRules](/docs/management-cloudinsight-removeresourcefromrules) | Event Rule의 감시 대상 그룹에서 특정 감시 대상 삭제 |
| [SearchMetricList](/docs/management-cloudinsight-searchmetriclist) | 감시 대상 그룹에서 조회 가능한 감시 항목 조회 |
| [UpdateMetricsGroup](/docs/management-cloudinsight-updatemetricsgroup) | Rule Template(감시 항목 그룹) 수정 |
| [UpdateMonitorGrp](/docs/management-cloudinsight-updatemonitorgrp) | 감시 대상 그룹 수정 |
| [UpdateRuleGroup](/docs/management-cloudinsight-updaterulegroup) | Event Rule 수정 |

### Schema

Schema 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [CreateCustomSchema](/docs/management-cloudinsight-createcustomschema) | 사용자 정의 스키마 생성 |
| [DeleteProductSchema](/docs/management-cloudinsight-deletechema) | 사용자 정의 스키마 삭제 |
| [GetExtendedStatus](/docs/management-cloudinsight-getextendedstatus) | 인스턴스의 Extended Metric 설정 조회 |
| [GetProductSchema](/docs/management-cloudinsight-getschema) | 사용자 정의 스키마 조회 |
| [GetSystemSchemaKeyList](/docs/management-cloudinsight-getsystemschemakeylist) | 스키마의 상품 키(cw_key) 조회 |
| [UpdateExtendedDisable](/docs/management-cloudinsight-updateextendenddisable) | 인스턴스의 Extended Metric 수집 설정 해제 |
| [UpdateExtendedEnable](/docs/management-cloudinsight-updateextendendenable) | 인스턴스의 Extended Metric 수집 설정 |
| [UpdateProductSchema](/docs/management-cloudinsight-updateschema) | 사용자 정의 스키마 수정 |

### Custom Resource

Custom Resource 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [CreateCustomResource](/docs/management-cloudinsight-createcustomresource) | 사용자 정의 리소스 생성 |
| [DeleteCustomResource](/docs/management-cloudinsight-deletecustomresource) | 사용자 정의 리소스 삭제 |
| [GetAllCustomResource](/docs/management-cloudinsight-getallcustomresource) | 사용자 정의 리소스 목록 조회 |
| [GetCustomResource](/docs/management-cloudinsight-getcustomresource) | 특정 사용자 정의 리소스의 상세 정보 조회 |
| [UpdateCustomResource](/docs/management-cloudinsight-updatecustomresource) | 사용자 정의 리소스 수정 |

### Planned Maintenance

Planned Maintenance 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [CreatePlannedMaintenance](/docs/management-cloudinsight-createpm) | 유지 보수 일정 생성 |
| [DeletePlannedMaintenance](/docs/management-cloudinsight-deletepm) | 유지 보수 일정 삭제 |
| [GetPlannedMaintenanceDetailById](/docs/management-cloudinsight-getpmlistdetailbyid) | 특정 유지 보수 일정의 상세 조회 |
| [GetPlannedMaintenanceList](/docs/management-cloudinsight-getpmlist) | 유지 보수 일정 목록 조회 |
| [UpdatePlannedMaintenance](/docs/management-cloudinsight-updatepm) | 유지 보수 일정 수정 |

### Plugin

Plugin 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [AddFilePlugin](/docs/management-cloudinsight-addfileplugin) | File Plugin 추가 |
| [AddPortPlugin](/docs/management-cloudinsight-addportplugin) | Port Plugin 추가 |
| [AddProcessPlugin](/docs/management-cloudinsight-addprocessplugin) | Process Plugin 추가 |
| [GetAllFilePlugin](/docs/management-cloudinsight-getallfileplugin) | File Plugin 목록 조회 |
| [GetAllPortPlugin](/docs/management-cloudinsight-getallportplugin) | Port Plugin 목록 조회 |
| [GetAllProcessPlugin](/docs/management-cloudinsight-getallprocessplugin) | Process Plugin 목록 조회 |
| [GetFilePlugin](/docs/management-cloudinsight-getfileplugin) | 특정 인스턴스에 대한 File Plugin 조회 |
| [GetPortPlugin](/docs/management-cloudinsight-getportplugin) | 특정 인스턴스에 대한 Port Plugin 조회 |
| [GetProcessPlugin](/docs/management-cloudinsight-getprocessplugin) | 특정 인스턴스에 대한 Process Plugin 조회 |
| [RemoveFilePlugin](/docs/management-cloudinsight-removefileplugin) | File Plugin 삭제 |
| [RemovePortPlugin](/docs/management-cloudinsight-removeportplugin) | Port Plugin 삭제 |
| [RemoveProcessPlugin](/docs/management-cloudinsight-removeprocessplugin) | Process Plugin 삭제 |
| [UpdateFilePlugin](/docs/management-cloudinsight-updatefileplugin) | File Plugin 설정 변경 |
| [UpdatePortPlugin](/docs/management-cloudinsight-updateportplugin) | Port Plugin 설정 변경 |
| [UpdateProcessPlugin](/docs/management-cloudinsight-updateprocessplugin) | Process Plugin 설정 변경 |

### Server

Server 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [GetServersTop](/docs/management-cloudinsight-getserverstop) | CPU, 메모리, 파일 시스템 사용률이 높은 상위 5개 서버 조회 |

### Data

Data 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [SendData](/docs/management-cloudinsight-senddata) | Cloud Insight로 JSON 데이터 전송 |
| [QueryData](/docs/management-cloudinsight-querydata) | Cloud Insight에 저장된 time-series 데이터 조회 |
| [QueryDataMultiple](/docs/management-cloudinsight-querydatamultiple) | Cloud Insight에 저장된 time-series 데이터 다중 조회 |
| [QueryWidgetDataPreview](/docs/management-cloudinsight-querywidgetdatapreview) | Metric을 지정하여 위젯 미리 보기 데이터 조회 |

### Integration

Integration 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [CreateIntegration](/docs/management-cloudinsight-createintegration) | Integration 생성 |
| [DeleteIntegration](/docs/management-cloudinsight-deleteintegration) | Integration 삭제 |
| [GetIntegration](/docs/management-cloudinsight-getintegration) | Integration 조회 |
| [GetIntegrationList](/docs/management-cloudinsight-getintegrationlist) | Integration 목록 조회 |
| [UpdateIntegration](/docs/management-cloudinsight-updateintegration) | Integration 업데이트 |

## Cloud Insight API 2.0

Cloud Insight 서비스에서 제공하는 API 2.0에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [GetAggregatedMetrics](/docs/management-cloudinsight-getaggregatedmetrics) | Cloud Insight에 저장된 time-series 데이터 집계 조건별 다중 조회 |

## Cloud Insight 연관 리소스

Cloud Insight API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

- Cloud Insight API 사용 방법
  - [서명(시그니처) 생성](/docs/common-ncpapi-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): 요청 헤더에 추가할 서명 생성 방법
  - [API Gateway 사용 가이드](https://guide-gov.ncloud-docs.com/docs/api-gateway-overview): 요청 헤더에 추가할 API Key 발급
  - [Sub Account 사용 가이드](https://guide-gov.ncloud-docs.com/docs/subaccount-overview): 요청 헤더에 추가할 Access Key 발급 방법
  - [Ncloud 공통 응답 상태 코드](/docs/api-call-lgc-errorhandling): Cloud Insight 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Cloud Insight 서비스 사용 방법
  - [Cloud Insight 사용 가이드](https://guide-gov.ncloud-docs.com/docs/cloudinsight-cloudinsightoverview): 네이버 클라우드 플랫폼 콘솔에서 Cloud Insight 사용하는 방법
  - [Ncloud 사용 환경 가이드](https://guide-gov.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 대한 가이드
  - [요금 소개, 특징, 상세 기능](https://www.gov-ncloud.com/product/management/cloudInsight): Cloud Insight의 요금 체계, 특징, 상세 기능 요약
  - [서비스 최신 소식](https://www.gov-ncloud.com/intro/news?categoryCode2=MGMT&categoryCode3=SV_0129&categoryCode=MGMT&serviceCode=SV_0129): Cloud Insight 서비스 관련 최신 소식
  - [자주 하는 질문](https://www.gov-ncloud.com/support/faq/prod?categoryCode2=MGMT&categoryCode3=SV_0129&page=1): Cloud Insight 서비스 사용자들이 자주 하는 질문
  - [문의하기](https://www.gov-ncloud.com/support/question/general): API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의