--- title: "Cloud Insightの概要" slug: "management-cloudinsight" tags: ["overview", "Cloud Insight"] updated: 2026-09-17T09:57:56Z published: 2026-09-17T09:57:56Z 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の概要 Classic/VPC環境で利用できます。 Cloud Insightは、NAVERクラウドプラットフォームが提供するサービスのパフォーマンス指標を統合管理し、障害発生時に担当者に障害情報を迅速に伝える NAVERクラウドプラットフォームのサービスです。Cloud Insightサービスは、Schema、Plugin、Event Rule、Planned Maintenanceなどの機能関連の APIを RESTful形式で提供します。 ## Cloud Insight指標 Cloud Insight APIを利用すると NAVERクラウドプラットフォームサービス(商品)のパフォーマンス/運用指標(Metric)を統合管理してさまざまなモニタリングに活用することができます。パフォーマンス/運用指標を提供する NAVERクラウドプラットフォームのサービス(商品)情報とパフォーマンス/運用指標に関する詳細は、次をご参照ください。 - Metric、Dimension、Aggregation、Schemaなどの概念の説明: [Cloud Insightの概念](https://guide.ncloud-docs.com/docs/ja/cloudinsight-info) - NAVERクラウドプラットフォームのサービス(商品)別パフォーマンス/運用指標関連情報の確認: [Cloud Insight指標](/docs/ja/management-cloudinsight-productinfo) ## Cloud Insightの共通設定 Cloud Insight APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。 ### リクエスト 共通リクエスト形式を説明します。 #### API URL リクエスト API URLは次の通りです。 ``` https://cw.apigw.ntruss.com ``` #### リクエストヘッダ ヘッダの説明は次の通りです。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 | | `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/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 | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 | | `Content-type` | Optional | リクエストデータの形式 - application/json | | `x-ncp-region_code` | Optional | NAVERクラウドプラットフォームのリージョンコード - `KR` \| `SGN` \| `JPN` \| `USWN` \| `DEN` - `KR`: 韓国リージョン - `SGN`: シンガポールリージョン - `JPN`: 日本リージョン - `USWN`: 米国西部リージョン - `DEN`: ドイツリージョン | | `x-ncp-dmn_cd` | Optional | NAVERクラウドプラットフォームのドメイン情報 - [Plugin関連の API](/docs/ja/management-cloudinsight#Plugin)で使用 - `PUB` (デフォルト) | ### レスポンス 共通レスポンス形式を説明します。 #### レスポンスステータスコード Cloud Insight APIは NAVERクラウドプラットフォームの共通レスポンスステータスコードを使用します。NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ## Cloud Insight API Cloud Insightサービスで提供する APIの説明は次の通りです。 ### Dashboard Dashboard関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [GetDashboardList](/docs/ja/management-cloudinsight-getdashboardlist) | ダッシュボードリストを照会 | | [GetDashboardWidgetImage](/docs/ja/management-cloudinsight-getdashboardwidgetimage) | ダッシュボードウィジェットの画像ファイルをダウンロード | | [GetDashboardWidgetList](/docs/ja/management-cloudinsight-getdashboardwidgetlist) | ダッシュボードウィジェットリストを照会 | ### Event Event関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [SearchEvent](/docs/ja/management-cloudinsight-searchevent) | Eventの検索と照会 | | [SearchEventById](/docs/ja/management-cloudinsight-searcheventbyid) | Event IDと Rule IDで Eventを詳細照会 | | [SearchEventCountConsole](/docs/ja/management-cloudinsight-searcheventcountconsole) | Event発生回数を照会 | ### Event Rule Event Rule関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [CopyRuleGroup](/docs/ja/management-cloudinsight-copyrulegroup) | Event Ruleをコピー | | [CreateMetricsGrp](/docs/ja/management-cloudinsight-createmetricsgrp) | Rule Template(監視項目グループ)を作成 | | [CreateMonitorGrp](/docs/ja/management-cloudinsight-createmonitorgrp) | 監視対象グループを作成 | | [CreateRuleDirectly](/docs/ja/management-cloudinsight-createruledirectly) | 監視対象と監視項目を直接指定して Event Ruleを作成 | | [CreateRuleGroup](/docs/ja/management-cloudinsight-createrulegroup) | Event Ruleを作成 | | [DeleteMetricGroupForce](/docs/ja/management-cloudinsight-deletemetricgroupforce) | 特定の Rule Template(監視項目グループ)に関連するすべての Event Ruleを削除 | | [DeleteMetricsGrp](/docs/ja/management-cloudinsight-deletemetricsgrp) | Rule Template(監視項目グループ)を削除 | | [DeleteMetricsGrpByProdKeyAndId](/docs/ja/management-cloudinsight-deletemetricsgrpbyprodkeyandid) | Rule Template IDで Rule Template(監視項目グループ)を削除 | | [DeleteMonitorGroupForce](/docs/ja/management-cloudinsight-deletemonitorgroupforce) | 特定の監視対象グループに関連するすべての Event Ruleを削除 | | [DeleteMonitorGrp](/docs/ja/management-cloudinsight-deletemonitorgrp) | 監視対象グループを削除 | | [DeleteRuleGroup](/docs/ja/management-cloudinsight-deleterulegroup) | Event Ruleを削除 | | [DeleteRuleGroupByProdKeyAndId](/docs/ja/management-cloudinsight-deleterulegroupbyprodkeyandid) | Event Rule IDで Event Ruleを削除 | | [GetAllMonitorGrp](/docs/ja/management-cloudinsight-getallmonitorgrp) | 監視対象グループリストを照会 | | [GetMetricsGroup](/docs/ja/management-cloudinsight-getmetricsgroup) | 特定の Rule Template(監視項目グループ)の詳細情報を照会 | | [GetMetricsGroupList](/docs/ja/management-cloudinsight-getmetricsgrouplist) | Rule Template(監視項目グループ)リストを照会 | | [GetMonitorGrp](/docs/ja/management-cloudinsight-getmonitorgrp) | 特定の監視対象グループの詳細情報を照会 | | [GetNotificationRecipientList](/docs/ja/management-cloudinsight-getnotificationrecipientlist) | 通知対象を照会 | | [GetRuleGroup](/docs/ja/management-cloudinsight-getrulegroup) | 特定の Event Ruleの詳細情報を照会 | | [GetRuleGroupByMetricGroupIds](/docs/ja/management-cloudinsight-getrulegroupbymetricgroupids) | Rule Template(監視項目グループ)に関連した Event Ruleを照会 | | [GetRuleGroupByMonitorGroupIds](/docs/ja/management-cloudinsight-getrulegroupbymonitorgroupids) | 監視対象グループに関連した Event Ruleを照会 | | [GetRuleGroupList](/docs/ja/management-cloudinsight-getrulegrouplist) | Event Ruleリストを照会 | | [RemoveResourceFromRules](/docs/ja/management-cloudinsight-removeresourcefromrules) | Event Ruleの監視対象グループから特定の監視対象を削除 | | [SearchMetricList](/docs/ja/management-cloudinsight-searchmetriclist) | 監視対象グループで照会可能な監視項目を照会 | | [UpdateMetricsGroup](/docs/ja/management-cloudinsight-updatemetricsgroup) | Rule Template(監視項目グループ)を更新 | | [UpdateMonitorGrp](/docs/ja/management-cloudinsight-updatemonitorgrp) | 監視対象グループを更新 | | [UpdateRuleGroup](/docs/ja/management-cloudinsight-updaterulegroup) | Event Ruleを更新 | ### Schema Schema関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [CreateCustomSchema](/docs/ja/management-cloudinsight-createcustomschema) | ユーザー定義スキーマを作成 | | [DeleteProductSchema](/docs/ja/management-cloudinsight-deletechema) | ユーザー定義スキーマを削除 | | [GetExtendedStatus](/docs/ja/management-cloudinsight-getextendedstatus) | インスタンスの Extended Metric設定を照会 | | [GetProductSchema](/docs/ja/management-cloudinsight-getschema) | ユーザー定義スキーマを照会 | | [GetSystemSchemaKeyList](/docs/ja/management-cloudinsight-getsystemschemakeylist) | スキーマの商品キー(cw_key)を照会 | | [RegisterProductSchema](/docs/ja/management-cloudinsight-registerschema) | ユーザー定義スキーマを登録 | | [UpdateExtendedDisable](/docs/ja/management-cloudinsight-updateextendenddisable) | インスタンスの Extended Metric収集設定を解除 | | [UpdateExtendedEnable](/docs/ja/management-cloudinsight-updateextendendenable) | インスタンスの Extended Metric収集を設定 | | [UpdateProductSchema](/docs/ja/management-cloudinsight-updateschema) | ユーザー定義スキーマを更新 | ### Custom Resource Custom Resource関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [CreateCustomResource](/docs/ja/management-cloudinsight-createcustomresource) | ユーザー定義リソースを作成 | | [DeleteCustomResource](/docs/ja/management-cloudinsight-deletecustomresource) | ユーザー定義リソースを削除 | | [GetAllCustomResource](/docs/ja/management-cloudinsight-getallcustomresource) | ユーザー定義リソースリストを照会 | | [GetCustomResource](/docs/ja/management-cloudinsight-getcustomresource) | 特定のユーザー定義リソースの詳細情報を照会 | | [UpdateCustomResource](/docs/ja/management-cloudinsight-updatecustomresource) | ユーザー定義リソースを更新 | ### Planned Maintenance Planned Maintenance関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [CreatePlannedMaintenance](/docs/ja/management-cloudinsight-createpm) | メンテナンススケジュールを作成 | | [DeletePlannedMaintenance](/docs/ja/management-cloudinsight-deletepm) | メンテナンススケジュールを削除 | | [GetPlannedMaintenanceDetailById](/docs/ja/management-cloudinsight-getpmdetailbyid) | 特定のメンテナンススケジュールを詳細照会 | | [GetPlannedMaintenanceList](/docs/ja/management-cloudinsight-getpmlist) | メンテナンススケジュールリストを照会 | | [UpdatePlannedMaintenance](/docs/ja/management-cloudinsight-updatepm) | メンテナンススケジュールを更新 | ### Plugin Plugin関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [AddFilePlugin](/docs/ja/management-cloudinsight-addfileplugin) | File Pluginを追加 | | [AddPortPlugin](/docs/ja/management-cloudinsight-addportplugin) | Port Pluginを追加 | | [AddProcessPlugin](/docs/ja/management-cloudinsight-addprocessplugin) | Process Pluginを追加 | | [GetAllFilePlugin](/docs/ja/management-cloudinsight-getallfileplugin) | File Pluginリストを照会 | | [GetAllPortPlugin](/docs/ja/management-cloudinsight-getallportplugin) | Port Pluginリストを照会 | | [GetAllProcessPlugin](/docs/ja/management-cloudinsight-getallprocessplugin) | Process Pluginリストを照会 | | [GetFilePlugin](/docs/ja/management-cloudinsight-getfileplugin) | 特定のインスタンスに対する File Pluginを照会 | | [GetPortPlugin](/docs/ja/management-cloudinsight-getportplugin) | 特定のインスタンスに対する Port Pluginを照会 | | [GetProcessPlugin](/docs/ja/management-cloudinsight-getprocessplugin) | 特定のインスタンスに対する Process Pluginを照会 | | [RemoveFilePlugin](/docs/ja/management-cloudinsight-removefileplugin) | File Pluginを削除 | | [RemovePortPlugin](/docs/ja/management-cloudinsight-removeportplugin) | Port Pluginを削除 | | [RemoveProcessPlugin](/docs/ja/management-cloudinsight-removeprocessplugin) | Process Pluginを削除 | | [UpdateFilePlugin](/docs/ja/management-cloudinsight-updatefileplugin) | File Plugin設定を変更 | | [UpdatePortPlugin](/docs/ja/management-cloudinsight-updateportplugin) | Port Plugin設定を変更 | | [UpdateProcessPlugin](/docs/ja/management-cloudinsight-updateprocessplugin) | Process Plugin設定を変更 | ### Server Server関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [GetServersTop](/docs/ja/management-cloudinsight-getserverstop) | CPU、メモリ、ファイルシステムの使用率が高い上位5つのサーバを照会 | ### Data Data関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [SendData](/docs/ja/management-cloudinsight-senddata) | Cloud Insightに JSONデータを送信 | | [QueryData](/docs/ja/management-cloudinsight-querydata) | Cloud Insightに保存されている time-seriesデータを照会 | | [QueryDataMultiple](/docs/ja/management-cloudinsight-querydatamultiple) | Cloud Insightに保存されている time-seriesデータをマルチ照会 | | [QueryWidgetDataPreview](/docs/ja/management-cloudinsight-querywidgetdatapreview) | Metricを指定してウィジェットプレビューデータを照会 | ### Integration Integration関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [CreateIntegration](/docs/ja/management-cloudinsight-createintegration) | Integrationを作成 | | [DeleteIntegration](/docs/ja/management-cloudinsight-deleteintegration) | Integrationを削除 | | [GetIntegration](/docs/ja/management-cloudinsight-getintegration) | Integrationを照会 | | [GetIntegrationList](/docs/ja/management-cloudinsight-getintegrationlist) | Integrationリストを照会 | | [UpdateIntegration](/docs/ja/management-cloudinsight-updateintegration) | Integrationを更新 | ## Cloud Insight関連リソース Cloud Insight APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - Cloud Insight APIの使用方法 - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi): リクエストヘッダに追加する署名の作成方法 - [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに追加する API Keyを発行 - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法 - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Cloud Insightサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報 - Cloud Insightサービスの使用方法 - [Cloud Insightご利用ガイド](https://guide.ncloud-docs.com/docs/ja/cloudinsight-cloudinsightoverview): NAVERクラウドプラットフォームコンソールで Cloud Insightを使用する方法 - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポート有無に関するガイド - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/management/cloudInsight): Cloud Insightの料金体系、特徴、詳細機能のサマリー - [サービスのお知らせ](https://www.ncloud.com/intro/news): Cloud Insightサービスに関するお知らせ - [よくある質問](https://www.ncloud.com/support/faq/all): Cloud Insightサービスに関するよくある質問 - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ