プロパティやその他のアセット (メトリクス) からのデータを集約する

メトリクスは、集計関数を使用してすべての入力データポイントを処理し、指定された時間間隔ごとに 1 つのデータポイントを出力する数式です。たとえば、メトリクスは、温度データストリームから時間当たりの平均温度を計算できます。

メトリクスは、関連付けられたアセットのメトリクスからデータを入力できるため、オペレーションまたはオペレーションのサブセットに関するインサイトを提供する統計情報を計算できます。たとえば、メトリクスは、風力発電所のすべての風力タービンの平均時間温度を計算できます。アセット間の関連付けを定義する方法の詳細については、「アセットモデル階層の定義」を参照してください。

メトリクスは、各時間間隔でのデータを集約することなく、他のプロパティからデータを入力することも可能です。コンピューティング式に[attribute] (属性) を指定した場合、 AWS IoT SiteWise はその属性の[latest] (最新) の値をコンピューティング式に使用します。式でメトリクスを指定すると、は式を計算する時間間隔の最後の値 AWS IoT SiteWise を使用します。つまり、 OEE = Availability * Quality * Performance、 Availability、 Quality はすべて同じアセットモデル上の他のメトリクスであり、Performance のようなメトリクスを定義することができるのです。

AWS IoT SiteWise は、すべてのアセットプロパティの基本的な集計メトリクスのセットも自動的に計算します。計算コストを削減するために、基本的な計算にカスタムメトリクスを定義する代わりに、これらの集計を使用できます。詳細については、「アセットプロパティ集計のクエリ」を参照してください。

メトリクスの定義 (コンソール）

AWS IoT SiteWise コンソールでアセットモデルのメトリクスを定義するときは、次のパラメータを指定します。

[Name] (名前) - プロパティの名前。
[Data type] (データ型) - 変換のデータ型で、[Double] (倍) または [String] (文字列) です。
外部 ID – (オプション) これはユーザー定義 ID です。詳細については、AWS IoT SiteWise ユーザーガイドの外部でオブジェクトを参照する IDsを参照してください。
[Formula] (計算式) - メトリクス式。メトリクス式では、[aggregation functions] (集約関数) を使用して、階層内のすべての関連するアセットに対するプロパティからデータを入力することができます。入力を開始するか、下矢印キーを押すと、オートコンプリート機能を実行できます。詳細については、「数式を使用する」を参照してください。

重要
メトリクスは、整数、倍、ブール値、文字列型のプロパティのみ使用可能です。ブール値は、0 (false) 、1 (true) に変換されます。
メトリクスの式でメトリクス入力変数を定義する場合、それらの入力には出力メトリクスと同じ時間間隔が必要です。
数式では、倍値または文字列値のみを出力できます。入れ子になった式は、文字列など他のデータ型を出力することができますが、式全体としては、数値または文字列として評価されなければなりません。[jp function] (jp関数) を使うと、文字列を数値に変換することができます。ブール値は 1 (true) または 0 (false) でなければならない。詳細については、「未定義の値、無限の値、およびオーバーフロー値」を参照してください。
[Time interval] (時間間隔) - メトリクスの時間間隔。AWS IoT SiteWise は次のタンブリングウィンドウ時間間隔をサポートし、各間隔は前の間隔が終了したときに開始される。
- [1 minute] (1 分) – 1 分。毎分の終わりに処理されます (午前 00:00:00、午前 00:01:00、午前 00:02:00 など)。
- [5 minutes] (5 分) – 5 分。正時から 5 分ごとに処理されます (午前 00:00:00、午前 00:05:00、午前 00:10:00 など)。
- [15 minutes] (15 分) – 15 分。正時から 15 分ごとに処理されます (午前 00:00:00、午前 00:15:00、午前 00:30:00 など)。
- 1 時間 – 1 時間 (60 分）、毎時間の最後にで計算されます UTC (午前 12:00:00、午前 1:00:00、午前 2:00:00 など）。
- 1 日 – 1 日 (24 時間）、で毎日の終わりに計算されます UTC (月曜日の午前 12:00:00、火曜日の午前 12:00:00 など）。
- 1 週間～1 週間 (7 日間）、で毎週日曜日の最後に計算されます UTC (月曜日の午前 12 時 00 分ごと）。
- [Custom interval] (カスタム時間間隔) - 1 分～1 週間の間で任意の時間間隔を入力できます。
[Offset date] (オフセット日) -(オプション) データを集計するためのリファレンス日です。
[Offset time] (オフセット時間) -(オプション) データを集計するリファレンス時間。オフセット時刻は、00:00:00 ～ 23:59:59 の間でなければなりません。
[Offset time zone] (オフセットタイムゾーン) -(オプション) オフセットのタイムゾーンです。指定しない場合、デフォルトのオフセットタイムゾーンは協定世界時 () ですUTC。
- （UTC+00:00) 協定世界時
- （UTC+01:00) 欧州中部標準時
- （UTC+02:00) 東ヨーロッパ
- （UTC03+:00) 東部アフリカ標準時
- （UTC+04:00) 近東部時間
- （UTC+05:00) パキスタンラホール時間
- （UTC+05:30) インド標準時
- （UTC+06:00) バングラデシュ標準時
- （UTC+07:00) ベトナム標準時
- （UTC+08:00) 中国台湾時間
- （UTC+09:00) 日本標準時
- （UTC+09:30) オーストラリア中部標準時
- （UTC+10:00) オーストラリア東部標準時
- （UTC+11:00) ソロモン標準時
- （UTC+12:00) ニュージーランド標準時
- （UTC-11:00) ミッドウェイ諸島時間
- （UTC-10:00) ハワイ標準時
- （UTC-09:00) アラスカ標準時
- （UTC-08:00) 太平洋標準時
- （UTC-07:00) フェニックス標準時
- （UTC-06:00) 中部標準時
- （UTC-05:00) 東部標準時
- （UTC-04:00) プエルトリコおよび米国領バージン諸島時間
- （UTC-03:00) アルゼンチン標準時
- （UTC-02:00) サウスジョージア時間
- （UTC-01:00) 中央アフリカ標準時

例オフセット付きのカスタム時間間隔 (コンソール)

次の例は、2021 年 2 月 20 日午後 6 時 30 分 30 秒 () にオフセットを使用して 12 時間の時間間隔を定義する方法を示していますPST。

オフセット付きのカスタム時間間隔を定義するには

[Time interval] (時間間隔) で [Custom interval] (カスタム間隔) を選択します。
[Time interval] (時間間隔) については、次のいずれかを行ってください。
- 12 を入力し、[hours] (時間) を選択します。
- 720 を入力し、[minutes] (分) を選択します。
- 43200 を入力し、[seconds] (秒) を選択します。
重要
[Time interval] (時間間隔) は単位に関係なく整数でなければならない。
[Offset date] (オフセット日付) は、[2021/02/20]を選択します。
[Offset time] (オフセット時間) には、18:30:30 を入力します。
オフセットタイムゾーン で、 （UTC-08:00) 太平洋標準時 を選択します。

メトリクスを 2021 年 7 月 1 日午後 6 時 30 分 30 秒前 (PST) に作成した場合、最初の集計結果は 2021 年 7 月 1 日午後 6 時 30 分 30 秒 () に取得されますPST。2 番目の集計結果は 2021 年 7 月 2 日午前 6 時 30 分 30 秒 (PST) に続きます。

メトリクスの定義 (AWS CLI）

を使用してアセットモデルのメトリクスを定義する場合は AWS IoT SiteWise API、次のパラメータを指定します。

name - プロパティの名前。
dataType - メトリクスのデータ型 (DOUBLE または STRING)。
externalId – (オプション) これはユーザー定義 ID です。詳細については、AWS IoT SiteWise ユーザーガイドの外部でオブジェクトを参照する IDsを参照してください。
expression - メトリクス式。メトリクス式では、[aggregation functions] (集約関数) を使用して、階層内のすべての関連するアセットに対するプロパティからデータを入力することができます。詳細については、「数式を使用する」を参照してください。
window - メメトリクスタンブリングウィンドウの時間間隔とオフセットで、各間隔は前の間隔が終了したときに開始されます。
- interval - タンブリングウィンドウの時間間隔です。時間間隔は 1 分以上 1 週間以内にする必要があります。
- offsets - タンブリングウィンドウのオフセット。
詳細については、「 AWS IoT SiteWise APIリファレンスTumblingWindow」の「」を参照してください。
例オフセット付きカスタム時間間隔 (AWS CLI)
次の例は、2021 年 2 月 20 日午後 6 時 30 分 30 秒 () にオフセットを使用して 12 時間の時間間隔を定義する方法を示していますPST。
```
{
    "window": {
        "tumbling": {
            "interval": "12h",
            "offset": " 2021-07-23T18:30:30-08"
        }
    }
}
```
メトリクスを 2021 年 7 月 1 日午後 6 時 30 分 30 秒前 (PST) に作成した場合、最初の集計結果は 2021 年 7 月 1 日午後 6 時 30 分 30 秒 () に取得されますPST。2 番目の集計結果は 2021 年 7 月 2 日午前 6 時 30 分 30 秒 (PST) に続きます。
variables - 式で使用するアセットまたは子アセットのその他のプロパティを定義する変数のリスト。各変数構造には、式で使用する単純な名前と、その変数にリンクされるプロパティを定義する value 構造が含まれます。value 構造体には、以下の情報が含まれています。
- propertyId - 値を取得するプロパティの ID。プロパティが (階層からモデルで定義されているのではなく) 現在のモデルで定義されている場合は、ID の代わりにプロパティの名前を使用できます。
- hierarchyId -(オプション) プロパティの子アセットをクエリする階層の ID。ID の代わりに階層定義の名前を使用できます。この値を省略すると、は現在のモデルでプロパティ AWS IoT SiteWise を検索します。
重要
メトリクスは、整数、倍、ブール値、文字列型のプロパティのみ使用可能です。ブール値は、0 (false) 、1 (true) に変換されます。
メトリクスの式でメトリクス入力変数を定義する場合、それらの入力には出力メトリクスと同じ時間間隔が必要です。
数式では、倍値または文字列値のみを出力できます。入れ子になった式は、文字列など他のデータ型を出力することができますが、式全体としては、数値または文字列として評価されなければなりません。[jp function] (jp関数) を使うと、文字列を数値に変換することができます。ブール値は 1 (true) または 0 (false) でなければならない。詳細については、「未定義の値、無限の値、およびオーバーフロー値」を参照してください。
unit –(オプション) プロパティの科学単位 (mm、摂氏など)。

例メトリクス定義の例

次の例は、アセットの温度測定データを集計して、時間当たりの最高温度を華氏で計算するメトリクスプロパティを示しています。このオブジェクトは、メトリクス AssetModelPropertyを含むの例です。 https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Metric.htmlこのオブジェクトをCreateAssetModelリクエストペイロードの一部として指定して、メトリクスプロパティを作成できます。詳細については、「アセットモデルを作成する (AWS CLI）」を参照してください。



{
      ...
      "assetModelProperties": [
      ...
      {
        "name": "Max temperature",
        "dataType": "DOUBLE",
        "type": {
          "metric": {
            "expression": "max(temp_f)",
            "variables": [
              {
                "name": "temp_f",
                "value": {
                  "propertyId": "Temperature F"
                }
              }
            ],
            "window": {
              "tumbling": {
                "interval": "1h"
              }
            }
          }
        },
        "unit": "Fahrenheit"
      }
    ],
    ...
}

例関連アセットからデータを入力するメトリクス定義例。

次の例は、複数の風力タービンの平均電力データを集約し、風力発電所の総平均電力を算出するメトリックプロパティを示しています。このオブジェクトは、メトリクス AssetModelPropertyを含むの例です。 https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Metric.htmlこのオブジェクトをCreateAssetModelリクエストペイロードの一部として指定して、メトリクスプロパティを作成できます。


{
      ...
      "assetModelProperties": [
      ...
      {
          "name": "Total Average Power",
          "dataType": "DOUBLE",
          "type": {
            "metric": {
              "expression": "avg(power)",
              "variables": [
                {
                  "name": "power",
                  "value": {
                    "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                    "hierarchyId": "Turbine Asset Model"
                  }
                }
              ],
              "window": {
                "tumbling": {
                  "interval": "5m"
                }
              }
            }
        },
        "unit": "kWh"
      }
    ],
    ...
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

変換データ (変換）

数式を使用する

プロパティやその他のアセット (メトリクス) からのデータを集約する

トピック

メトリクスの定義 (コンソール）

重要

例 オフセット付きのカスタム時間間隔 (コンソール)

オフセット付きのカスタム時間間隔 を定義するには

重要

メトリクスの定義 (AWS CLI）

例 オフセット付きカスタム時間間隔 (AWS CLI)

重要

例 メトリクス定義の例

例 関連アセットからデータを入力するメトリクス定義例。

例オフセット付きのカスタム時間間隔 (コンソール)

オフセット付きのカスタム時間間隔を定義するには

例オフセット付きカスタム時間間隔 (AWS CLI)

例メトリクス定義の例

例関連アセットからデータを入力するメトリクス定義例。