このトピックでは、時間修飾子、アトミック用語、および計算ロジックを使用して派生メトリックを構成する方法、およびこれらのメトリックをさらなる分析、レポート、その他のタスクに活用する方法の概要を説明します。
前提条件
元の定義メトリックをインポートし、アトミック用語を追加済みであることを確認します。 詳細については、「プリセットメトリックのインポート」および「アトミックワードの追加」をご参照ください。
手順
IoT Platform コンソールで、[概要] をクリックします。 [概要] タブで、管理するインスタンスを見つけ、インスタンス [ID] またはインスタンス名をクリックします。
左側のナビゲーションウィンドウで、[データサービス] > [データメトリクス] を選択し、[メトリックのカスタマイズ] をシングルクリックします。
[すべてのメトリック] タブに移動し、[メトリックの作成] をシングルクリックします。
画面の指示に従って、メトリック定義を構成します。
新しいメトリックのドメインを選択し、プロンプトの指示に従って特定のエンティティと [派生範囲] を選択します。
パラメーター
備考
このエンティティ
問題の現在のエンティティを指します。
サブエンティティ
現在のエンティティのサブエンティティを対象とします。 派生定義メトリックの場合、サブエンティティを選択する必要があります。
たとえば、製品のサブエンティティが対応するデバイスである場合、派生定義メトリックは製品全体ではなく、各デバイスに対して計算されます。
次のガイドラインを使用してメトリックを定義します。
パラメーター
備考
時間修飾子
新しいメトリックの統計データ範囲を定義する時間修飾子を選択します。
アトミック用語
メトリックドメインで以前に追加されたアトミック用語を選択します。
アトミック用語を追加するには、右側の [アトミック用語の作成に移動] ボタンをシングルクリックします。 詳細については、「アトミックワードの追加」をご参照ください。
メトリック名
メトリック名は固定されており、時間修飾子とアトミック用語が自動的に結合されます。
例:
過去1日間の平均気温測定単位
使用可能なオプションから単位タイプと特定の単位を選択します。
データ型
データ型、精度、小数点以下桁数、および値の範囲を定義します。
データ型の詳細な説明については、ヘルプ アイコンをクリックしてください。
処理方法
処理は既存のメトリックアセットから派生したものであり、変更できません。
計算可能かどうか
カウント、金額、頻度などの累積可能な数値メトリックの場合は、[はい] を選択します。
統計頻度
データは毎日処理および生成され、変更オプションはありません。
有効期限
メトリックの有効期限を設定します。
重要有効期限が過ぎると、データ生成のスケジュールは停止します。
メトリックの説明
メトリックのビジネス上の説明を入力します。通常は、時間修飾子とアトミック用語が含まれます。
例:
時間修飾子: 過去1日、アトミック用語: 平均気温次の手順に従って、計算ルールを設定します。
計算方法
備考
例
集計計算
ドロップダウンメニューから集計関数、メトリック、および演算子を選択します。 最大 10 個の式を追加できます。
たとえば、製品ドメインのサブエンティティ、関数
COUNT(Count)、および製品 (od3****) の温度を選択すると、派生定義メトリックによって製品 (od3****) の温度レコード数が計算されます。式計算
指定されたボックスに演算式を入力します。 サポートされている関数のリストについては、以下の付録: 関数リストを参照してください。
入力ボックスの上にある [関数] ボタンをクリックすると、手順と例が表示されます。
式の構文では、入力ボックスに集計関数を入力し、関数本体内に $ または @ 記号を挿入し、メトリックドメインを選択し、ピリオド (.) を追加し、メトリックドメインの下のエンティティを選択し、さらに別のピリオド (.) を選択し、最後に派生と計算のためのメトリックを選択します。
$ 記号と @ 記号は、異なるメトリックタイプに対応しています。
$: 元の定義メトリックと派生定義メトリック。
@: 元のメトリックと派生メトリック。
説明集計関数式内では、基本演算子はサポートされていません。
TH_sensor を含む 100 個のデバイスを持つ製品 温度および湿度センサー の場合、温度 の元のメトリックと定義に基づく 過去1日間の平均気温 の派生メトリック式は次のとおりです。
avg($Product.温度および湿度センサー.温度): 派生定義メトリックを使用して、製品のすべてのデバイスの平均気温を計算します。avg(@Device.TH_sensor.温度): 派生定義メトリックを使用して、TH_sensor デバイスの平均気温を計算します。
[完了して公開] を1回クリックします。
新しく完了したメトリックは、[すべてのメトリック] リストに表示されます。
説明[完了] ボタンをシングルクリックして選択されたメトリックは、[未公開] とマークされ、データは収集されません。
未完了のメトリックは、[下書きボックスに入る] をシングルクリックすることで下書きボックスに送信でき、さらに編集して最終的に公開プロセスを完了できます。
必要に応じて、[すべてのメトリック] リストで目的のメトリックを見つけ、操作列の関数ボタンをシングルクリックして、次の操作を実行します。
説明元の定義メトリックは、表示と削除の機能に制限されています。
操作
備考
[表示]
基本情報、計算ロジック、データプレビュー、その他のメトリックの詳細にアクセスします。
[編集]
派生メトリックの構成を調整します。
[公開停止]
メトリックを未公開の状態に戻します。 この操作により、関連する派生メトリックとサービスが失敗します。
[公開]
メトリックを公開します。
[クローン]
メトリックを複製し、クローンメトリックページで必要に応じてその定義と設定を変更して、新しいメトリックを作成します。
重要元と同じ構成のメトリックは保存できません。
[削除]
システムからメトリックを削除します。
重要特定の条件下でメトリックを削除しようとすると、失敗します。
メトリックに関連付けられたダウンストリームメトリックがあります。
メトリックがデータ分析レポート内で使用されています。
次の手順
派生メトリックは T+1 日のディメンション統計データを表すため、新しいメトリックを追加した直後にデータを表示するには、リフレッシュタスクを手動で開始する必要がある場合があります。
詳細な手順については、「メトリックのリフレッシュ」をご参照ください。
付録: 関数リスト
関数 | 備考 |
GREATEST | 指定されたパラメーターの中で最大の値を識別します。 |
LEAST | 入力パラメーターから最小の値を返します。 |
AVG | 指定されたパラメーターの平均値を計算します。 |
MAX | 入力の中から最大値を決定します。 |
MIN | 指定された入力から最小値を計算します。 |
SUM | すべての入力値を合計して合計値を生成します。 |
COUNT | 指定された条件を満たすレコードの数をカウントします。 |
ABS | 数値の絶対値を計算します。 |
CEIL | 数値を最も近い整数に切り上げます。 |
ROUND | 数値を指定された小数点以下の桁数に丸めます。 |
TRUNC | 数値を丸めずに、指定された小数点以下の桁数に切り捨てます。 |
COALESCE | パラメーターのリストから最初の非NULL値を返します。 |