キャンペーンを使用して AWS IoT FleetWise データを収集する - AWS IoT FleetWise

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

キャンペーンを使用して AWS IoT FleetWise データを収集する

キャンペーンとは、データ収集ルールのオーケストレーションです。キャンペーンでは、エッジエージェント for AWS IoT FleetWise ソフトウェアに、データの選択、収集、クラウドへの転送の方法に関する手順を提供します。

キャンペーンはクラウドで作成します。あなたまたはチームがキャンペーンを承認すると、 AWS IoT FleetWise は自動的にそれを車両にデプロイします。キャンペーンを 1 台の車両にデプロイするか、車両のフリートにデプロイするかを選択できます。エッジエージェントソフトウェアは、実施中のキャンペーンが車両にデプロイされるまでデータの収集を開始しません。

注記

キャンペーンは、次の条件が満たされるまで機能しません。

  • エッジエージェントソフトウェアが車両内で実行されている。エッジエージェントソフトウェアを開発、インストール、使用する方法の詳細を確認するには、以下の操作を行います。

    1. AWS IoT FleetWise コンソール に移動します。

    2. サービスのホームページの AWS IoT FleetWise の使用を開始する」セクションで、エッジエージェントの探索「」を選択します。

  • 車両をプロビジョニング AWS IoT Core するように を設定しました。詳細については、「Provision AWS IoT FleetWise 車両」を参照してください。

各キャンペーンには、以下の情報が含まれています。

signalCatalogArn

キャンペーンに関連付けられたシグナルカタログの Amazon リソースネーム (ARN）。

(オプション) tags

タグは、キャンペーンの管理に使用できるメタデータです。さまざまなサービスのリソースに同じタグを割り当てて、それらのリソースが関連していることを示すことができます。

TargetArn

キャンペーンがデプロイされる車両またはフリートARNの 。

name

キャンペーンを識別するために役立つ一意の名前。

collectionScheme

データ収集スキームは、Edge Agent に、収集するデータ、またはいつ収集するかに関するソフトウェア手順を提供します。 AWS IoT FleetWise は現在、条件ベースの収集スキームと時間ベースの収集スキームをサポートしています。

conditionBasedCollectionScheme

条件ベースの収集スキームでは、収集するデータを認識するために論理式が使用されます。エッジエージェントソフトウェアは、条件が満たされたときにデータを収集します。

expression

収集するデータを認識するために使用される論理式。例えば、$variable.`myVehicle.InVehicleTemperature` > 50.0 という式を指定すると、エッジエージェントソフトウェアは 50.0 より大きい温度値を収集します。式の書き方の手順については、「AWS IoT FleetWise キャンペーンの論理式」を参照してください。

(オプション) triggerMode には次のいずれかの値を指定できます。

  • RISING_EDGE - エッジエージェントソフトウェアは、条件が初めて満たされたときにのみデータを収集します。例えば、$variable.`myVehicle.AirBagDeployed` == true と指定します。

  • ALWAYS - エッジエージェントソフトウェアは、条件が満たされるたびにデータを収集します。

(オプション) minimumTriggerIntervalMs

2 つのデータ収集イベント間の最小時間 (ミリ秒単位)。シグナルが頻繁に変化する場合は、データの収集速度を遅くすることができます。

(オプション) conditionLanguageVersion

条件式言語のバージョン。

timeBasedCollectionScheme

時間ベースの収集スキームを定義するときは、時間間隔をミリ秒単位で指定します。エッジエージェントソフトウェアは、その時間間隔を使用してデータの収集頻度を決定します。例えば、時間間隔が 120,000 ミリ秒の場合、エッジエージェントソフトウェアはデータを 2 分ごとに 1 回収集します。

(オプション) compression

ワイヤレス帯域幅を節約し、ネットワークトラフィックを減らすには、車両内のデータを圧縮SNAPPYするように を指定できます。

デフォルト (OFF) では、エッジエージェントソフトウェアはデータを圧縮しません。

dataDestinationConfigs

キャンペーンで車両データを転送する宛先を選択します。Amazon S3 または Amazon Timestream にデータを保存できます。

S3 は、耐久性の高いデータ管理機能とダウンストリームデータサービスを提供する、コスト効率に優れたデータストレージメカニズムです。S3 は、運転動作や長期メンテナンスの分析に関連するデータに使用できます。

Timestream は、傾向やパターンをほぼリアルタイムで特定するために役立つデータ永続化メカニズムです。Timestream は、車両の速度やブレーキの履歴の傾向を分析する場合など、時系列データに使用できます。

(オプション) dataExtraDimensions

1 つ以上の属性を追加して、シグナルに追加情報を提供できます。

(オプション) description

キャンペーンの目的を識別するために役立つ説明を追加できます。

(オプション) diagnosticsMode

診断モードが に設定されている場合SEND_ACTIVE_DTCS、キャンペーンは、車両の問題を特定するのに役立つ、保存されている標準診断トラブルコード (DTCs) を送信します。例えば、P0097 は、エンジンコントロールモジュール (ECM) が、吸気温度センサー 2 (IAT2) 入力が通常のセンサー範囲よりも低いと判断したことを示します。

デフォルト (OFF) では、エッジエージェントソフトウェアは診断コードを送信しません。

(オプション) expiryTime

キャンペーンの有効期限を定義できます。キャンペーンの有効期限が切れると、エッジエージェントソフトウェアはこのキャンペーンで指定されたデータの収集を停止します。車両に複数のキャンペーンがデプロイされている場合、エッジエージェントソフトウェアは他のキャンペーンを使用してデータを収集します。

デフォルト値: 253402243200 (9999 年 12 月 31 日 00:00:00 UTC）

(オプション) postTriggerCollectionDuration

スキームが呼び出された後、エッジエージェントソフトウェアで一定期間データを収集し続けるように、トリガー後の収集期間を定義できます。例えば、次の式を持つ条件ベースのコレクションスキームが呼び出された場合$variable.`myVehicle.Engine.RPM` > 7000.0、エッジエージェントソフトウェアはエンジンの 1 分あたりの回転数 (RPM) 値を引き続き収集します。RPM が 1 回だけ 7000 を超えた場合でも、機械的問題があることを示している可能性があります。この場合、エッジエージェントソフトウェアでデータの収集を継続して状況をモニタリングできます。

デフォルト値: 0

(オプション) priority

キャンペーンの優先度を示す整数を指定できます。数値が小さいキャンペーンほど優先度が高くなります。1 つの車両に複数のキャンペーンをデプロイする場合、優先度の高いキャンペーンが最初に開始されます。

デフォルト値: 0

(オプション) signalsToCollect

データ収集スキームが呼び出されたときにデータが収集されるシグナルのリスト。

name

データ収集スキームが呼び出されたときにデータが収集されるシグナルの名前。

(オプション) maxSampleCount

データ収集スキームが呼び出されたときにエッジエージェントソフトウェアが収集してクラウドに転送するデータサンプルの最大数。

(オプション) minimumSamplingIntervalMs

2 つのデータサンプル収集イベント間の最小時間 (ミリ秒単位)。シグナルが頻繁に変化する場合は、このパラメータを使用してデータの収集速度を遅くすることができます。

有効な範囲: 0～4294967295

(オプション) spoolingMode

spoolingMode が TO_DISK に設定されている場合、エッジエージェントソフトウェアは、車両がクラウドに接続されていないときにデータを一時的にローカルに保存します。接続が再確立されると、ローカルに保存されたデータが自動的にクラウドに転送されます。

デフォルト値: OFF

(オプション) startTime

承認されたキャンペーンは開始時刻に有効になります。

デフォルト値: 0

キャンペーンのステータスは次のいずれかの値になります。

  • CREATING – AWS IoT FleetWise はキャンペーンを作成するリクエストを処理しています。

  • WAITING_FOR_APPROVAL - 作成後のキャンペーンは WAITING_FOR_APPROVAL 状態になります。キャンペーンを承認するには、 UpdateCampaignAPIオペレーションを使用します。キャンペーンが承認されると、 AWS IoT FleetWise はターゲット車両またはフリートにキャンペーンを自動的にデプロイします。詳細については、「AWS IoT FleetWise キャンペーンを更新する」を参照してください。

  • RUNNING - キャンペーンはアクティブです。

  • SUSPENDED - キャンペーンは停止しています。キャンペーンを再開するには、 UpdateCampaignAPIオペレーションを使用します。

AWS IoT FleetWise では、キャンペーンの作成と管理に使用できる以下のAPIオペレーションが用意されています。

  • CreateCampaign – 新しいキャンペーンを作成します。

  • UpdateCampaign – 既存のキャンペーンを更新します。キャンペーンを作成したら、このAPIオペレーションを使用してキャンペーンを承認する必要があります。

  • DeleteCampaign – 既存のキャンペーンを削除します。

  • ListCampaigns — すべてのキャンペーンの概要のページ分割されたリストを取得します。

  • GetCampaign – キャンペーンに関する情報を取得します。

チュートリアル