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

IoT Platform:メトリックとは

最終更新日:Apr 17, 2025

このトピックでは、メトリックの定義、ドメイン、種類など、メトリックの概要について説明します。

メトリック

メトリックとは、さまざまなエンティティの進捗状況や状態を定量化するために使用される測定基準であり、一般的にメジャーと呼ばれます。たとえば、温度、人口、GDP、収入、ユーザー数、利益率、維持率、カバー率などがあります。

メトリックドメイン

メトリックドメインとは、メトリックが割り当てられるカテゴリを指し、メトリックを整理して管理するために役立ちます。 IoT Platform DataService Studio では、メトリックはプロダクトとデバイスの 2 つのドメインに分類されます。

メトリックの種類

  • オリジナルの定義

    オリジナルの定義メトリックは、IoT Platform 上のプロダクトに関連付けられた TSL (Thing Specification Language)定義から生成されます。

    定義済みの TSL (Thing Specification Language)を表示するには、IoT コンソールの[デバイス管理] [>] [プロダクト] ページから[プロダクトの詳細] ページに移動し、[機能定義] を選択します。

  • オリジナルメトリック

    オリジナルメトリックは、IoT Platform 上のデバイスから報告されたプロパティ、またはカスタムトピックの解析から派生します。

    IoT コンソールの[デバイス管理 > デバイス] セクションから[デバイスの詳細] ページに移動し、[TSL (thing Specification Language)データ] を選択して、デバイスのプロパティを確認します。

  • 派生定義

    派生定義は、オリジナルの定義メトリックの拡張であり、オリジナルメトリックに基づいてサブエンティティに適用されます。

    これらのメトリックは、特定のデータ値を持たないプロパティ定義として機能し、プロダクトレベルではなくデバイスレベルで計算され、派生メトリックデータを集約します。

    派生定義メトリックは、プロダクト内のデバイスについてのみ計算され、各デバイスの派生メトリックからメトリックデータを集約します。

    プロダクトの派生定義メトリックと、関連付けられた各デバイスの派生メトリックは、共通のメトリックコードを共有します

  • 派生メトリック

    派生メトリックは、オリジナルメトリック、オリジナルの定義、および派生定義に基づいて、合計や平均などの集約計算の結果として得られます。

    派生メトリックの時間範囲は時間修飾子として定義され、その他の条件はビジネス修飾子としてカプセル化されます。

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

    メトリックの追加の詳細については、「メトリックを作成する」をご参照ください。

メトリックの種類の使用範囲

次の表は、それぞれのドメイン内でサポートされているメトリックの種類を示しています。

メトリックの種類

プロダクト

デバイス

オリジナルの定義

サポート対象

該当なし

オリジナルメトリック

該当なし

サポート対象

派生定義

サポート対象

該当なし

派生メトリック

サポート対象

サポート対象

1 つのプロダクトエンティティに、派生定義と派生メトリックの両方の種類を含めることができます。

たとえば、プロダクト PK1 の派生定義過去 1 日間の平均温度について考えてみます。 PK1 が 100 台のデバイス DN nn=1~100)で構成されている場合、各デバイスの過去 1 日間の平均温度に個別の派生メトリックを作成するには、100 個の構成が必要になります。代わりに、プロダクト PK1 に対して 1 つの派生定義を設定することで、派生メトリック過去 1 日間の平均温度を 100 台すべてのデバイスに自動的に適用できます。