---
title: "Custom Schema"
slug: "cloudinsight-use-customschema"
tags: ["Cloud Insight"]
updated: 2026-09-17T09:09:28Z
published: 2026-09-17T09:09:28Z
canonical: "guide-fin.ncloud-docs.com/cloudinsight-use-customschema"
---

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

# Custom Schema

Custom Schema에서 Custom Schema를 생성하고 관리하는 방법을 설명합니다.

Custom Schema를 생성하여 Cloud Insight API를 통해 Custom Schema로 데이터를 전송할 수 있습니다. 수집된 데이터는 Cloud Insight에서 활용할 수 있으며, API를 통해 조회할 수도 있습니다. 데이터 전송 및 조회 API는 [Cloud Insight API 가이드](https://api-fin.ncloud-docs.com/docs/management-cloudinsight)를 참고해 주십시오.

**Custom Schema** 메뉴에 접속하려면 네이버 클라우드 플랫폼 포털에 접속한 후 **[콘솔]** > **Menu** > **All Services** > **Management & Governance** > **Cloud Insight (Monitoring)** > **Configuration** > **Custom Schema**를 차례대로 클릭해 주십시오.

## Custom Schema 화면

Custom Schema 화면은 다음과 같이 구성되어 있습니다.

![cloudinsight-use-customschema_screen_new_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/cloudinsight-use-customschema_screen_new_ko.png?sv=2026-02-06&spr=https&st=2026-10-29T04%3A32%3A16Z&se=2026-10-29T05%3A32%3A16Z&sr=c&sp=r&sig=ognWEpGBTATiAEH6T6o2xsut69r6aRAsVTVH9I0Jajc%3D)

| 영역 | 설명 |
| --- | --- |
| ① 메뉴명 | 현재 확인 중인 메뉴명 |
| ② 기본 기능 | **Custom Schema** 메뉴 최초 진입 시 제공되는 기능 - **[Custom Schema 생성]**: 클릭하여 Custom Schema 생성([Custom Schema 생성](/docs/cloudinsight-use-customschema#CustomSchema%EC%83%9D%EC%84%B1) 참고) - **[상품 더 알아보기]**: 클릭하여 Cloud Insight 소개 페이지로 이동 - **[새로고침]**: 클릭하여 Custom Schema 목록 새로 고침 |
| ③ 생성 후 기능 | Custom Schema 생성 후 활성화되는 기능 - **[수정]**: 클릭하여 Custom Schema 수정([Custom Schema 수정](/docs/cloudinsight-use-customschema#CustomSchema%EC%88%98%EC%A0%95) 참고) - **[삭제]**: 클릭하여 Custom Schema 삭제([Custom Schema 삭제](/docs/cloudinsight-use-customschema#CustomSchema%EC%82%AD%EC%A0%9C) 참고) |
| ④ 검색창 | **Product Type** 또는 **Metric**명으로 검색 가능 |
| ⑤ Custom Schema 목록 | 생성한 Custom Schema 표시 - **CW_KEY**: Schema를 구분하기 위한 key로 데이터 전송 및 조회에 사용 - **[데이터 전송 예시]**: 클릭하여 설정한 Schema와 전송할 Sample Data 형식 확인 |

## Custom Schema 생성

Custom Schema를 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Insight (Monitoring)** 메뉴를 차례대로 클릭해 주십시오.
2. **Configuration > Custom Schema** 메뉴를 차례대로 클릭해 주십시오.
3. **[Custom Schema 생성]** 버튼을 클릭해 주십시오.
4. **Product Type**에 생성할 Schema명을 입력해 주십시오.
5. **[수집 대상 설정]** 탭에서 데이터를 수집할 대상 정보를 설정해 주십시오.
  - 데이터를 수집할 대상 정보인 **ID Dimension**을 입력해 주십시오.
    - ID Dimension으로 수집된 데이터를 기준으로 Target 목록을 생성합니다.
  - ID Dimension의 **Data Type**을 선택해 주십시오.
    - **STRING**, **INTEGER**, **LONG** 중 선택할 수 있습니다.
6. **[Metric]** 탭을 클릭한 후 Schema의 Metric을 정의해 주십시오.
  - **[추가]** 버튼을 클릭한 후 Metric 정보를 입력해 주십시오.
    - **Metric**: Metric명
    - **Description**: Metric 설명
    - **Data Type**: 집계할 데이터 타입
    - **Aggregation Cycle**: 집계 주기
    - **Aggregation**: 집계 함수
    - **Unit**: 집계 데이터 단위
  - <예시> **Metric**: mem_used / **Description**: memory / **Data Type**: FLOAT / **Aggregation Cycle**: Min1, Min30, Day1 / **Aggregation**: AVG, COUNT / **Unit**: %  
mem_used라는 Metric은 FLOAT 타입으로 수집되며, 이 Schema로 데이터를 전송할 경우 데이터는 1분/30분/1일 단위로 AVG(평균)과 COUNT(수집 횟수)가 집계되어 Cloud Insight에 저장됩니다.
7. **[Dimension]** 탭을 클릭한 후 Schema의 Dimension을 설정해 주십시오.
  - **[추가]** 버튼을 클릭한 후 Dimension 정보를 입력해 주십시오.
    - **Dimension**: Dimension명
    - **Description**: Dimension 설명
    - **Data Type**: 전송할 데이터 타입
8. **[생성]** 버튼을 클릭해 주십시오.
  - **[데이터 전송 예시]** 버튼을 클릭하여 설정한 Schema와 전송할 Sample Data 형식을 확인할 수 있습니다.
  - **[JSON]** 버튼을 클릭하여 설정한 Schema를 JSON 형식으로 작성하거나 확인할 수 있습니다.

## Custom Schema 수정

Custom Schema를 수정하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Insight (Monitoring)** 메뉴를 차례대로 클릭해 주십시오.
2. **Configuration > Custom Schema** 메뉴를 차례대로 클릭해 주십시오.
3. 수정할 Custom Schema를 선택한 후 **[수정]** 버튼을 클릭해 주십시오.
4. Custom Schema 수정 화면에서 변경할 내용을 적용한 후 **[저장]** 버튼을 클릭해 주십시오.
  - **ID Dimension**, **Metric**, **Dimension**과 각 **Data Type**은 수정할 수 없습니다.
  - 각 항목에 관한 자세한 내용은 [Custom Schema 생성](/docs/cloudinsight-use-customschema#CustomSchema%EC%83%9D%EC%84%B1)을 참고해 주십시오.

## Custom Schema 삭제

Custom Schema를 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Management & Governance** > **Cloud Insight (Monitoring)** 메뉴를 차례대로 클릭해 주십시오.
2. **Configuration > Custom Schema** 메뉴를 차례대로 클릭해 주십시오.
3. 삭제할 Custom Schema를 선택한 후 **[삭제]** 버튼을 클릭해 주십시오.
4. 알림 팝업 창의 내용을 확인한 후 **[삭제]** 버튼을 클릭해 주십시오.