すべてのプロダクト
Search

このプロダクト

    IoT Platform:定義済みメトリックテーブル

    ドキュメントセンター

    IoT Platform:定義済みメトリックテーブル

    最終更新日:Jun 17, 2026

    定義済みメトリックテーブルは、IoT Data Service Platform がデバイスステータスを記述するために使用するデフォルトメトリクスの集まりです。これらのメトリクスのデータ収集は、デフォルトで無効になっています。定義済みメトリックテーブルを有効化してメトリクスデータを収集し、データ API を生成して集約結果を取得できます。

    前提条件

    プロダクトデータがバックアップされていること。詳細については、「デバイスデータソースのデータをバックアップする」をご参照ください。

    課金

    定義済みメトリックテーブルを有効化してデータを収集すると、コンピューティングユニット (CU) が消費されます。詳細については、「データサービス課金説明」をご参照ください。

    定義済みメトリックテーブルの表示

    1. IoT Platform コンソール で、[概要] をクリックします。[概要] タブで、管理するインスタンスを見つけ、インスタンス [ID] またはインスタンス名をクリックします。

    2. 左側のナビゲーションペインで、[データサービス] > [データメトリクス] を選択します。

    3. [定義済みメトリック] タブで、すべての定義済みメトリックテーブルを表示できます。

      定義済みメトリックテーブルのリストには、[メトリック名]、[説明]、[CU 消費量]、[スケジューリングタイプ]、[メトリクスタイプ]、[アクション] の列が含まれます。[アクション] 列では、[表示] をクリックしてメトリックの詳細を表示したり、[メトリックの有効化] をクリックしてメトリックを有効化したりできます。ページ上部の検索ボックスを使用すると、メトリック名で検索できます。

    4. (任意) 事前定義メトリックテーブルの[アクション]列で、[表示]をクリックします。

      [メトリックテーブルの詳細] ページには、メトリック名 (例: connectionSuccessRate)、表示名 (例: ネットワーク接続成功率 (毎分))、フィールド数、タイプ (デバイス) など、メトリックテーブルとそのメトリックに関する基本情報が表示されます。 テーブルスキーマセクションには、各フィールドの名前、エイリアス (中国語名)、およびデータ型が一覧表示されます。 たとえば、metricValue フィールドのエイリアスは「ネットワーク接続成功率」で、データ型は double です。

    データ収集の有効化と無効化

    データ収集の有効化

    1. [定義済みメトリック] タブの [操作] 列で、対象の定義済みメトリックテーブルの [メトリックを有効化] をクリックします。

    2. 表示されるダイアログボックスで、[確認] をクリックします。

      重要

      インスタンスの CU が不足している場合、インスタンス仕様をアップグレードするように求めるダイアログボックスが表示されます。画面の指示に従って CU をアップグレードしてください。仕様の詳細については、「Enterprise Edition インスタンスの購入」をご参照ください。

      アップグレードが完了したら、上記の手順に従ってメトリックのデータ収集を有効化してください。

      ダイアログボックスには、利用可能な CU と、メトリックの有効化に必要な CU が表示されます。月々の CU 消費量はデバイス数によって異なります。オフラインメトリクスは T+1 集約モデルを使用するため、集約結果はメトリックを有効化した翌日から利用可能になります。

    データ収集の無効化

    1. [定義済みメトリック] タブの [アクション] 列で、対象の定義済みメトリックテーブルの [メトリックの無効化] をクリックします。

    2. 表示されるダイアログボックスで、[確認] をクリックします。

      メトリックを無効化すると、データ収集は停止します。データ収集はいつでも再度有効化できます。

    データ API の生成

    定義済みメトリックテーブルのデータ収集を有効化すると、システムが集約されたメトリクスデータを取得するために使用できるデータ API を自動的に生成します。

    1. [事前定義メトリック] タブで、目的の事前定義メトリックテーブルの [アクション] 列にある [データプレビュー] をクリックすると、直近 20 件のレコードを表示できます。 たとえば、日次デバイスオンライン期間統計 テーブルの場合、プレビューには 統計日、最大オンライン期間、最小オンライン期間、平均オンライン期間、最大オンライン期間のデバイス、および 最小オンライン期間のデバイス などのフィールドが含まれます。

    2. [定義済みメトリック] タブに戻ります。同じ定義済みメトリックテーブルの [アクション] 列で、[データ API の詳細] をクリックして、その基本情報と使用方法の詳細を表示します。

      API の詳細と使用方法については、「API の管理と使用」をご参照ください。基本情報には、[API 名]、[API パス]、[ステータス]、[作成日時]、[API タイプ]、[呼び出し数]、[タイムアウトエラー条件]、[最終呼び出し日時] が含まれます。[API モニタリング] エリアでは、[API 運用保守] タブと [API テスト] タブを切り替えることができます。