でアセットにアラームを設定する AWS IoT SiteWise - AWS IoT SiteWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

でアセットにアラームを設定する AWS IoT SiteWise

アセットモデルに AWS IoT Events アラームを定義したら、アセットモデルに基づいて各アセットにアラームを設定できます。アラームのしきい値や通知設定を編集することができます。これらの値はそれぞれアセット上の属性であるため、属性のデフォルト値を更新することでこれらの値を設定することができます。

注記

これらの値は AWS IoT Events アラームには設定できますが、外部アラームには設定できません。

しきい値を設定する (コンソール)

AWS IoT SiteWise コンソールを使用して、アラームのしきい値を指定する属性の値を更新できます。

アラームのしきい値を更新するには (コンソール)。
  1. AWS IoT SiteWise コンソールに移動します。

  2. ナビゲーションペインで [Assets (アセット) ] を選択します。

  3. アラームしきい値を更新したいアセットを選択します。

    ヒント

    矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。

  4. [編集] を選択します。

  5. アラームがしきい値に使用している属性を検索し、新しい値を入力します。

  6. [Save] を選択します。

しきい値を設定する (AWS CLI)

AWS Command Line Interface (AWS CLI) を使用して、アラームのしきい値を指定する属性の値を更新できます。

この手順を完了するには、アセットの assetId とプロパティの propertyId を知っている必要があります。外部 ID を使用することもできます。アセットを作成したが、その assetId がわからない場合は、ListAssets API を使用して、特定のモデルのすべてのアセットを一覧表示します。DescribeAsset オペレーションを使用して、プロパティ ID を含むアセットのプロパティを表示します。

BatchPutAssetPropertyValue オペレーションを使用して、アセットに属性値を割り当てます。このオペレーションを使用すると、複数の属性を一度に設定できます。このオペレーションのペイロードにはエントリのリストが含まれ、各エントリにはアセット ID、プロパティ ID、属性値が含まれます。

属性の値を更新するには (AWS CLI)
  1. batch-put-payload.json という名前のファイルを作成して、次の JSON オブジェクトをファイルにコピーします。このペイロードの例は、風力タービンの緯度と経度を設定する方法を示しています。ID、値、タイムスタンプを更新して、ユースケースのペイロードを変更します。

    { "entries": [ { "entryId": "windfarm3-turbine7-latitude", "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "propertyValues": [ { "value": { "doubleValue": 47.6204 }, "timestamp": { "timeInSeconds": 1575691200 } } ] }, { "entryId": "windfarm3-turbine7-longitude", "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE", "propertyValues": [ { "value": { "doubleValue": 122.3491 }, "timestamp": { "timeInSeconds": 1575691200 } } ] } ] }
    • ペイロードの各エントリには、一意の文字列として定義できる entryId が含まれています。リクエストのエントリが失敗した場合、各エラーには、対応するリクエストの entryId が含まれるため、再試行するリクエストを確認できます。

    • 属性値を設定するには、各属性プロパティの propertyValues のリストに 1 つのタイムスタンプ品質値 (TQV) 構造を含めることができます。この構造には、新しい value および現在の timestamp を含める必要があります。

      • value - 設定中のプロパティの型に応じて、次のいずれかのフィールドを含む構造。

        • booleanValue

        • doubleValue

        • integerValue

        • stringValue

        • nullValue

      • timestamp – 現在の Unix エポック時間を秒単位で含む構造timeInSeconds。. は、過去 7 日以上、または 5 分より新しいタイムスタンプを持つデータポイント AWS IoT SiteWise を拒否します。

    BatchPutAssetPropertyValue の ペイロードを準備する方法の詳細については、AWS IoT SiteWise APIs を使用してデータを取り込む を参照してください。

  2. 次のコマンドを実行して、属性値を AWS IoT SiteWiseに送信します。

    aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json