すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:メトリクス

最終更新日:Jun 21, 2026

このトピックでは、メトリクス、メトリクスドメイン、およびメトリクスタイプを定義します。

メトリクス

メトリクスは、指標とも呼ばれ、変化や発展を測定するための標準です。例としては、温度、人口、GDP、収益、ユーザー数、利益率、保持率、カバー率などがあります。

メトリクスドメイン

メトリクスドメインは、メトリクスに関連付けられたオブジェクトであり、メトリクスの分類と管理に使用されます。IoT Data Service では、プロダクトとデバイスの 2 つのメトリクスドメインを提供しています。

メトリクスタイプ

  • 元の定義

    元の定義メトリクスは、IoT Platform のプロダクトの Thing モデルから派生します。

    IoT Platform コンソールで、[デバイス管理] [ > ][プロダクト] の順に移動し、プロダクトを選択して [プロダクト詳細] ページを開き、[機能定義] をクリックして定義された Thing モデルを表示します。

  • ローメトリクス

    ローメトリクスは、デバイスが IoT Platform に報告するプロパティ、またはカスタム Topic から解析されたプロパティから生成されます。

    IoT Platform コンソールで、[デバイス管理] > [デバイス] の順に移動して [デバイス詳細] ページを開きます。[TSL データ] をクリックしてプロパティを表示します。例えば、[デバイス詳細] ページで、[TSL データ] > [実行ステータス] の順に選択すると、デバイスが報告したプロパティ (電気パラメーター測定器からのメトリクス:負荷電力 (28 kW)、動作電流 (15 A)、電圧 (20 V) など) を表示できます。

  • 派生定義

    派生定義は、元の定義に基づいており、プロダクトのサブエンティティに適用されます。

    元の定義と同様に、派生定義はプロパティ定義であり、特定のデータ値を持ちません。

    集約データは、各デバイスの派生メトリクスの値になります。

    プロダクトの派生定義と、そのプロダクト配下の各デバイスの派生メトリクスは、同じ メトリクスコード を共有します。

  • 派生メトリクス

    派生メトリクスは、ローメトリクス、元の定義、または派生定義から、合計や平均などの集約方法を使用して計算されます。

    派生メトリクスでは、時間修飾子が集約時間範囲 (時間制約) を定義し、ビジネス修飾子がその他の制約を定義します。

    したがって、派生メトリクスは、時間修飾子 (必須) + ビジネス修飾子 (オプション) + アトミックメトリクス (必須) の 3 つの要素で構成されます。

    メトリクスの追加方法については、「メトリクスの追加」をご参照ください。

メトリクスタイプの適用範囲

次の表は、各メトリクスドメインでサポートされるメトリクスタイプを示しています。

タイプ

プロダクト

デバイス

元の定義

サポート

非サポート

ローメトリクス

非サポート

サポート

派生定義

サポート

非サポート

派生メトリクス

サポート

サポート

プロダクトに派生定義を設定することで、その配下のデバイスに派生メトリクスを作成できます。

例えば、プロダクト PK1 に 過去 24 時間の平均温度 という名前の派生定義があるとします。このプロダクトには、DNn (n=1 〜 100) という名前の 100 台のデバイスがあります。各デバイスに対して個別に 過去 24 時間の平均温度 派生メトリクスを作成すると、設定を 100 回繰り返す必要があります。しかし、プロダクト PK1 に対して 1 つの派生定義を作成すると、100 台すべてのデバイスに対して 過去 24 時間の平均温度 派生メトリクスが自動的に作成されます。