このトピックでは、メトリクス、メトリクスドメイン、およびメトリクスタイプを定義します。
メトリクス
メトリクスは、指標とも呼ばれ、変化や発展を測定するための標準です。例としては、温度、人口、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 時間の平均温度 派生メトリクスが自動的に作成されます。