Cloud Insightの概要
    • PDF

    Cloud Insightの概要

    • PDF

    記事の要約

    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の概念
    • NAVERクラウドプラットフォームのサービス(商品)別パフォーマンス/運用指標関連情報の確認: Cloud Insight指標

    Cloud Insightの共通設定

    Cloud Insight APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

    リクエスト

    共通リクエスト形式を説明します。

    API URL

    リクエスト API URLは次の通りです。

    https://cw.apigw.ntruss.com
    

    リクエストヘッダ

    ヘッダの説明は次の通りです。

    フィールド必須の有無説明
    x-ncp-apigw-timestampRequired1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
    • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
    • Unix Timestamp形式
    x-ncp-iam-access-keyRequiredNAVERクラウドプラットフォームから発行された Access Key
    x-ncp-apigw-signature-v2RequiredNAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名
    Content-typeOptionalリクエストデータの形式
    • application/json
    x-ncp-region_codeOptionalNAVERクラウドプラットフォームのリージョンコード
    • KR | SGN | JPN | USWN | DEN
      • KR: 韓国リージョン
      • SGN: シンガポールリージョン
      • JPN: 日本リージョン
      • USWN: 米国西部リージョン
      • DEN: ドイツリージョン
    x-ncp-dmn_cdOptionalNAVERクラウドプラットフォームのドメイン情報

    レスポンス

    共通レスポンス形式を説明します。

    レスポンスステータスコード

    Cloud Insight APIは NAVERクラウドプラットフォームの共通レスポンスステータスコードを使用します。NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    Cloud Insight API

    Cloud Insightサービスで提供する APIの説明は次の通りです。

    Dashboard

    Dashboard関連 APIの説明は次の通りです。

    API説明
    GetDashboardListダッシュボードリストを照会
    GetDashboardWidgetImageダッシュボードウィジェットの画像ファイルをダウンロード
    GetDashboardWidgetListダッシュボードウィジェットリストを照会

    Event

    Event関連 APIの説明は次の通りです。

    API説明
    SearchEventEventの検索と照会
    SearchEventByIdEvent IDと Rule IDで Eventを詳細照会
    SearchEventCountConsoleEvent発生回数を照会

    Event Rule

    Event Rule関連 APIの説明は次の通りです。

    API説明
    CopyRuleGroupEvent Ruleをコピー
    CreateMetricsGrpRule Template(監視項目グループ)を作成
    CreateMonitorGrp監視対象グループを作成
    CreateRuleDirectly監視対象と監視項目を直接指定して Event Ruleを作成
    CreateRuleGroupEvent Ruleを作成
    DeleteMetricGroupForce特定の Rule Template(監視項目グループ)に関連するすべての Event Ruleを削除
    DeleteMetricsGrpRule Template(監視項目グループ)を削除
    DeleteMetricsGrpByProdKeyAndIdRule Template IDで Rule Template(監視項目グループ)を削除
    DeleteMonitorGroupForce特定の監視対象グループに関連するすべての Event Ruleを削除
    DeleteMonitorGrp監視対象グループを削除
    DeleteRuleGroupEvent Ruleを削除
    DeleteRuleGroupByProdKeyAndIdEvent Rule IDで Event Ruleを削除
    GetAllMonitorGrp監視対象グループリストを照会
    GetMetricsGroup特定の Rule Template(監視項目グループ)の詳細情報を照会
    GetMetricsGroupListRule Template(監視項目グループ)リストを照会
    GetMonitorGrp特定の監視対象グループの詳細情報を照会
    GetNotificationRecipientList通知対象を照会
    GetRuleGroup特定の Event Ruleの詳細情報を照会
    GetRuleGroupByMetricGroupIdsRule Template(監視項目グループ)に関連した Event Ruleを照会
    GetRuleGroupByMonitorGroupIds監視対象グループに関連した Event Ruleを照会
    GetRuleGroupListEvent Ruleリストを照会
    RemoveResourceFromRulesEvent Ruleの監視対象グループから特定の監視対象を削除
    SearchMetricList監視対象グループで照会可能な監視項目を照会
    UpdateMetricsGroupRule Template(監視項目グループ)を更新
    UpdateMonitorGrp監視対象グループを更新
    UpdateRuleGroupEvent Ruleを更新

    Schema

    Schema関連 APIの説明は次の通りです。

    API説明
    CreateCustomSchemaユーザー定義スキーマを作成
    DeleteProductSchemaユーザー定義スキーマを削除
    GetExtendedStatusインスタンスの Extended Metric設定を照会
    GetProductSchemaユーザー定義スキーマを照会
    GetSystemSchemaKeyListスキーマの商品キー(cw_key)を照会
    RegisterProductSchemaユーザー定義スキーマを登録
    UpdateExtendedDisableインスタンスの Extended Metric収集設定を解除
    UpdateExtendedEnableインスタンスの Extended Metric収集を設定
    UpdateProductSchemaユーザー定義スキーマを更新

    Custom Resource

    Custom Resource関連 APIの説明は次の通りです。

    API説明
    CreateCustomResourceユーザー定義リソースを作成
    DeleteCustomResourceユーザー定義リソースを削除
    GetAllCustomResourceユーザー定義リソースリストを照会
    GetCustomResource特定のユーザー定義リソースの詳細情報を照会
    UpdateCustomResourceユーザー定義リソースを更新

    Planned Maintenance

    Planned Maintenance関連 APIの説明は次の通りです。

    API説明
    CreatePlannedMaintenanceメンテナンススケジュールを作成
    DeletePlannedMaintenanceメンテナンススケジュールを削除
    GetPlannedMaintenanceDetailById特定のメンテナンススケジュールを詳細照会
    GetPlannedMaintenanceListメンテナンススケジュールリストを照会
    UpdatePlannedMaintenanceメンテナンススケジュールを更新

    Plugin

    Plugin関連 APIの説明は次の通りです。

    API説明
    AddFilePluginFile Pluginを追加
    AddPortPluginPort Pluginを追加
    AddProcessPluginProcess Pluginを追加
    GetAllFilePluginFile Pluginリストを照会
    GetAllPortPluginPort Pluginリストを照会
    GetAllProcessPluginProcess Pluginリストを照会
    GetFilePlugin特定のインスタンスに対する File Pluginを照会
    GetPortPlugin特定のインスタンスに対する Port Pluginを照会
    GetProcessPlugin特定のインスタンスに対する Process Pluginを照会
    RemoveFilePluginFile Pluginを削除
    RemovePortPluginPort Pluginを削除
    RemoveProcessPluginProcess Pluginを削除
    UpdateFilePluginFile Plugin設定を変更
    UpdatePortPluginPort Plugin設定を変更
    UpdateProcessPluginProcess Plugin設定を変更

    Server

    Server関連 APIの説明は次の通りです。

    API説明
    GetServersTopCPU、メモリ、ファイルシステムの使用率が高い上位5つのサーバを照会

    Data

    Data関連 APIの説明は次の通りです。

    API説明
    SendDataCloud Insightに JSONデータを送信
    QueryDataCloud Insightに保存されている time-seriesデータを照会
    QueryDataMultipleCloud Insightに保存されている time-seriesデータをマルチ照会
    QueryWidgetDataPreviewMetricを指定してウィジェットプレビューデータを照会

    Integration

    Integration関連 APIの説明は次の通りです。

    API説明
    CreateIntegrationIntegrationを作成
    DeleteIntegrationIntegrationを削除
    GetIntegrationIntegrationを照会
    GetIntegrationListIntegrationリストを照会
    UpdateIntegrationIntegrationを更新

    Cloud Insight関連リソース

    Cloud Insight APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。


    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.