---
title: "Cloud Insight overview"
slug: "management-cloudinsight"
updated: 2026-09-17T10:05:41Z
published: 2026-09-17T10:05:41Z
canonical: "api.ncloud-docs.com/management-cloudinsight"
---

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

# Cloud Insight overview

Available in Classic and VPC

Cloud Insight is a NAVER Cloud Platform service that integrates and manages the performance indicators of services provided by NAVER Cloud Platform. When a failure occurs, it promptly alerts the person in charge with relevant information. The Cloud Insight service provides APIs for features such as schema, plugin, event rule, and planned maintenance in a RESTful form.

## Cloud Insight metrics

Cloud Insight APIs allow you to centrally manage performance and operational metrics for NAVER Cloud Platform services (products) and use them for various monitoring purposes. For information on the services (products) of the NAVER Cloud Platform that provide performance/operational metrics and a detailed description of the performance/operational metrics, see the following:

- Description of concepts such as metric, dimension, aggregation, and schema: [Cloud Insight concepts](https://guide.ncloud-docs.com/docs/en/cloudinsight-info)
- Check performance/operational metrics by service (product) on NAVER Cloud Platform: [Cloud Insight metrics](/docs/en/management-cloudinsight-productinfo)

## Common Cloud Insight settings

The following describes commonly used request and response formats in Cloud Insight APIs.

### Request

The following describes the common request format.

#### API URL

The request API URL is as follows:

```
https://cw.apigw.ntruss.com
```

#### Request headers

The following describes the headers.

| Field | Required | Description |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format. |
| `x-ncp-iam-access-key` | Required | Access key issued on NAVER Cloud Platform - Issue and check access key: See [Create authentication key](/docs/en/common-ncpapi). - Issue and check access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/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 | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256) - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi). - Create signature: See [Create signature](/docs/en/common-ncpapi). |
| `Content-type` | Optional | Request data format - application/json |
| `x-ncp-region_code` | Optional | NAVER Cloud Platform Region code - `KR` \| `SGN` \| `JPN` \| `USWN` \| `DEN` - `KR`: Korea Region - `SGN`: Singapore Region - `JPN`: Japan Region - `USWN`: US West Region - `DEN`: Germany Region |
| `x-ncp-dmn_cd` | Optional | NAVER Cloud Platform domain information - Used in [Plugin-related APIs](/docs/en/management-cloudinsight#Plugin) - `PUB` (default) |

### Response

The following describes the common response format.

#### Response status codes

Cloud Insight APIs use NAVER Cloud Platform's common response status codes. For response status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

## Cloud Insight API

The following describes the APIs provided by the Cloud Insight service.

### Dashboard

The following describes the dashboard-related APIs.

| API | Description |
| --- | --- |
| [GetDashboardList](/docs/en/management-cloudinsight-getdashboardlist) | Get dashboard list. |
| [GetDashboardWidgetImage](/docs/en/management-cloudinsight-getdashboardwidgetimage) | Download dashboard widget image file. |
| [GetDashboardWidgetList](/docs/en/management-cloudinsight-getdashboardwidgetlist) | Get dashboard widget list. |

### Event

The following describes the event-related APIs.

| API | Description |
| --- | --- |
| [SearchEvent](/docs/en/management-cloudinsight-searchevent) | Search and get event. |
| [SearchEventById](/docs/en/management-cloudinsight-searcheventbyid) | Get event details with event ID and rule ID. |
| [SearchEventCountConsole](/docs/en/management-cloudinsight-searcheventcountconsole) | Get the number of occurrences of an event. |

### Event Rule

The following describes the event rule-related APIs.

| API | Description |
| --- | --- |
| [CopyRuleGroup](/docs/en/management-cloudinsight-copyrulegroup) | Copy event rule. |
| [CreateMetricsGrp](/docs/en/management-cloudinsight-createmetricsgrp) | Create rule template (monitoring item group). |
| [CreateMonitorGrp](/docs/en/management-cloudinsight-createmonitorgrp) | Create monitoring target group. |
| [CreateRuleDirectly](/docs/en/management-cloudinsight-createruledirectly) | Create an event rule by specifying the target and items to be monitored. |
| [CreateRuleGroup](/docs/en/management-cloudinsight-createrulegroup) | Create event rule. |
| [DeleteMetricGroupForce](/docs/en/management-cloudinsight-deletemetricgroupforce) | Delete all event rules related to a specific rule template (monitoring item group). |
| [DeleteMetricsGrp](/docs/en/management-cloudinsight-deletemetricsgrp) | Delete rule template (monitoring item group). |
| [DeleteMetricsGrpByProdKeyAndId](/docs/en/management-cloudinsight-deletemetricsgrpbyprodkeyandid) | Delete rule template (monitoring item group) with the rule template ID. |
| [DeleteMonitorGroupForce](/docs/en/management-cloudinsight-deletemonitorgroupforce) | Delete all event rules related to a specific monitoring target group. |
| [DeleteMonitorGrp](/docs/en/management-cloudinsight-deletemonitorgrp) | Delete monitoring target group. |
| [DeleteRuleGroup](/docs/en/management-cloudinsight-deleterulegroup) | Delete event rule. |
| [DeleteRuleGroupByProdKeyAndId](/docs/en/management-cloudinsight-deleterulegroupbyprodkeyandid) | Delete event rule with event rule ID. |
| [GetAllMonitorGrp](/docs/en/management-cloudinsight-getallmonitorgrp) | Get the list of monitoring target groups. |
| [GetMetricsGroup](/docs/en/management-cloudinsight-getmetricsgroup) | Get details of a specific rule template (monitoring item group). |
| [GetMetricsGroupList](/docs/en/management-cloudinsight-getmetricsgrouplist) | Get rule template (monitoring item group) list. |
| [GetMonitorGrp](/docs/en/management-cloudinsight-getmonitorgrp) | Get details of a specific monitoring target group. |
| [GetNotificationRecipientList](/docs/en/management-cloudinsight-getnotificationrecipientlist) | Get notification recipients. |
| [GetRuleGroup](/docs/en/management-cloudinsight-getrulegroup) | Get details of a specific event rule. |
| [GetRuleGroupByMetricGroupIds](/docs/en/management-cloudinsight-getrulegroupbymetricgroupids) | Get event rules related to the rule template (monitoring item group). |
| [GetRuleGroupByMonitorGroupIds](/docs/en/management-cloudinsight-getrulegroupbymonitorgroupids) | Get event rules related to the monitoring target group. |
| [GetRuleGroupList](/docs/en/management-cloudinsight-getrulegrouplist) | Get event rule list. |
| [RemoveResourceFromRules](/docs/en/management-cloudinsight-removeresourcefromrules) | Delete a specific monitoring target from the event rule's monitoring target group. |
| [SearchMetricList](/docs/en/management-cloudinsight-searchmetriclist) | Get monitoring items available to the monitoring target group. |
| [UpdateMetricsGroup](/docs/en/management-cloudinsight-updatemetricsgroup) | Edit rule template (monitoring item group). |
| [UpdateMonitorGrp](/docs/en/management-cloudinsight-updatemonitorgrp) | Edit monitoring target group. |
| [UpdateRuleGroup](/docs/en/management-cloudinsight-updaterulegroup) | Edit event rule. |

### Schema

The following describes the schema-related APIs.

| API | Description |
| --- | --- |
| [CreateCustomSchema](/docs/en/management-cloudinsight-createcustomschema) | Create user-defined schema. |
| [DeleteProductSchema](/docs/en/management-cloudinsight-deletechema) | Delete user-defined schema. |
| [GetExtendedStatus](/docs/en/management-cloudinsight-getextendedstatus) | Set/get extended metrics of an instance. |
| [GetProductSchema](/docs/en/management-cloudinsight-getschema) | Get user-defined schema. |
| [GetSystemSchemaKeyList](/docs/en/management-cloudinsight-getsystemschemakeylist) | Get the product key (cw_key) of the schema. |
| [RegisterProductSchema](/docs/en/management-cloudinsight-registerschema) | Register user-defined schema. |
| [UpdateExtendedDisable](/docs/en/management-cloudinsight-updateextendenddisable) | Disable the collection of extended metrics for the instance. |
| [UpdateExtendedEnable](/docs/en/management-cloudinsight-updateextendendenable) | Enable the collection of extended metrics for the instance. |
| [UpdateProductSchema](/docs/en/management-cloudinsight-updateschema) | Edit user-defined schema. |

### Custom Resource

The following describes the APIs related to custom resource.

| API | Description |
| --- | --- |
| [CreateCustomResource](/docs/en/management-cloudinsight-createcustomresource) | Create user-defined resource. |
| [DeleteCustomResource](/docs/en/management-cloudinsight-deletecustomresource) | Delete user-defined resource. |
| [GetAllCustomResource](/docs/en/management-cloudinsight-getallcustomresource) | Get user-defined resource list. |
| [GetCustomResource](/docs/en/management-cloudinsight-getcustomresource) | Get a specific user-defined resource details. |
| [UpdateCustomResource](/docs/en/management-cloudinsight-updatecustomresource) | Edit user-defined resource. |

### Planned Maintenance

The following describes the APIs related to planned maintenance.

| API | Description |
| --- | --- |
| [CreatePlannedMaintenance](/docs/en/management-cloudinsight-createpm) | Create maintenance schedule. |
| [DeletePlannedMaintenance](/docs/en/management-cloudinsight-deletepm) | Delete maintenance schedule. |
| [GetPlannedMaintenanceDetailById](/docs/en/management-cloudinsight-getpmdetailbyid) | Get details of a specific maintenance schedule. |
| [GetPlannedMaintenanceList](/docs/en/management-cloudinsight-getpmlist) | Get maintenance schedule list. |
| [UpdatePlannedMaintenance](/docs/en/management-cloudinsight-updatepm) | Edit maintenance schedule. |

### Plugin

The following describes the plugin-related APIs.

| API | Description |
| --- | --- |
| [AddFilePlugin](/docs/en/management-cloudinsight-addfileplugin) | Add file plugin. |
| [AddPortPlugin](/docs/en/management-cloudinsight-addportplugin) | Add port plugin. |
| [AddProcessPlugin](/docs/en/management-cloudinsight-addprocessplugin) | Add process plugin. |
| [GetAllFilePlugin](/docs/en/management-cloudinsight-getallfileplugin) | Get file plugin list. |
| [GetAllPortPlugin](/docs/en/management-cloudinsight-getallportplugin) | Get port plugin list. |
| [GetAllProcessPlugin](/docs/en/management-cloudinsight-getallprocessplugin) | Get process plugin list. |
| [GetFilePlugin](/docs/en/management-cloudinsight-getfileplugin) | Get file plugin for a specific instance. |
| [GetPortPlugin](/docs/en/management-cloudinsight-getportplugin) | Get port plugin for a specific instance. |
| [GetProcessPlugin](/docs/en/management-cloudinsight-getprocessplugin) | Get process plugin for a specific instance. |
| [RemoveFilePlugin](/docs/en/management-cloudinsight-removefileplugin) | Delete file plugin. |
| [RemovePortPlugin](/docs/en/management-cloudinsight-removeportplugin) | Delete port plugin. |
| [RemoveProcessPlugin](/docs/en/management-cloudinsight-removeprocessplugin) | Delete process plugin. |
| [UpdateFilePlugin](/docs/en/management-cloudinsight-updatefileplugin) | Change file plugin settings. |
| [UpdatePortPlugin](/docs/en/management-cloudinsight-updateportplugin) | Change port plugin settings. |
| [UpdateProcessPlugin](/docs/en/management-cloudinsight-updateprocessplugin) | Change process plugin settings. |

### Server

The following describes the server-related APIs.

| API | Description |
| --- | --- |
| [GetServersTop](/docs/en/management-cloudinsight-getserverstop) | Get the top five servers with the highest CPU, memory, and file system usage rates |

### Data

The following describes the data-related APIs.

| API | Description |
| --- | --- |
| [SendData](/docs/en/management-cloudinsight-senddata) | Send JSON data to Cloud Insight. |
| [QueryData](/docs/en/management-cloudinsight-querydata) | Get time-series data stored in Cloud Insight. |
| [QueryDataMultiple](/docs/en/management-cloudinsight-querydatamultiple) | Get multiple time-series data stored in Cloud Insight. |
| [QueryWidgetDataPreview](/docs/en/management-cloudinsight-querywidgetdatapreview) | Get widget preview data by specifying a metric. |

### Integration

The following describes the integration-related APIs.

| API | Description |
| --- | --- |
| [CreateIntegration](/docs/en/management-cloudinsight-createintegration) | Create integration. |
| [DeleteIntegration](/docs/en/management-cloudinsight-deleteintegration) | Delete integration. |
| [GetIntegration](/docs/en/management-cloudinsight-getintegration) | Get integration. |
| [GetIntegrationList](/docs/en/management-cloudinsight-getintegrationlist) | Get integration list. |
| [UpdateIntegration](/docs/en/management-cloudinsight-updateintegration) | Update integration. |

## Cloud Insight related resources

NAVER Cloud Platform provides a variety of related resources to help users better understand Cloud Insight APIs.

- Cloud Insight API guides
  - [Create signature](/docs/en/common-ncpapi): How to create a signature to add to the request header
  - [API Gateway user guide](https://guide.ncloud-docs.com/docs/en/apigw-apigw-1): How to issue the API key to be added to the request header
  - [Sub Account User Guides](https://guide.ncloud-docs.com/docs/en/subaccount-overview): How to issue the access key to be added to the request header
  - [Common Ncloud response status codes](/docs/en/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Information on common response status codes of NAVER Cloud Platform used by the Cloud Insight service
- How to use the Cloud Insight service
  - [Cloud Insight user guide](https://guide.ncloud-docs.com/docs/en/cloudinsight-cloudinsightoverview): How to use Cloud Insight in the NAVER Cloud Platform console
  - [Ncloud user environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): Explore VPC and Classic environments and supported services.
  - [Pricing and features](https://www.ncloud.com/product/management/cloudInsight): View pricing details and key capabilities.
  - [Latest service news](https://www.ncloud.com/intro/news): The latest news on the Cloud Insight service
  - [FAQs](https://www.ncloud.com/support/faq/all): Get answers to common Cloud Insight questions.
  - [Contact Support](https://www.ncloud.com/support/question/general): Get help if you can't find what you need in the API guide.