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

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

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

重要

現在、特定の AWS IoT FleetWise 機能へのアクセスはゲートされています。詳細については、「AWSAWS IoT FleetWise でのリージョンと機能の可用性」を参照してください。

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

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

重要

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

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

    1. AWS IoT FleetWise コンソールを開きます。

    2. サービスのホームページの「Get started with AWS IoT FleetWise」セクションで、「Explore Edge Agent」を選択します。

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

注記

また、「On Change」または「Periodic」更新戦略を使用してテレメトリデータをストリーミングできる状態テンプレートを使用して、ほぼリアルタイムで 車両の最終状態をモニタリングする (フリートではなく) することもできます。また、以前にデプロイされたテンプレートを有効または無効にしたり、現在の車両状態を 1 回リクエスト (フェッチ) したりする「オンデマンド」機能も提供します。

最後の既知の状態へのアクセスは、現在ゲートされています。詳細については、「AWSAWS 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 キャンペーンの論理式」を参照してください。

    • (オプション) conditionLanguageVersion – 条件式言語のバージョン。

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

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

      • RISING_EDGE – Edge Agent ソフトウェアは、条件が初めて満たされた場合にのみデータを収集します。例えば、$variable.`myVehicle.AirBagDeployed` == true。

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

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

    • periodMs – データを収集する頻度を決定する期間 (ミリ秒単位）。

(オプション) compression

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

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

dataDestinationConfigs

キャンペーンが車両データを転送する 1 つの送信先を選択します。データを MQTT トピックに送信するか、Amazon S3 または Amazon Timestream に保存できます。

MQTT (Message Queuing Telemetry Transport) は、軽量で広く採用されているメッセージングプロトコルです。 AWS IoT ルールを使用して MQTT トピックにデータを発行し、独自のイベント駆動型アーキテクチャを立ち上げることができます。MQTT AWS IoT のサポートは MQTT v3.1.1 仕様と MQTT v5.0 仕様に基づいていますが、いくつかの違いがあります。詳細については、「MQTT の違い」を参照してください。

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

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

注記

Amazon Timestream は、アジアパシフィック (ムンバイ) リージョンでは利用できません。

(オプション) dataExtraDimensions

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

(オプション) dataPartitions

信号データを車両に一時的に保存するデータパーティションを作成します。データをクラウドに転送するタイミングと方法を設定します。

  • 最大ストレージサイズ、最小有効期間、ストレージの場所を定義して、 AWS IoT FleetWise が車両またはフリートにデータを保存する方法を指定します。

  • キャンペーンは spoolingModeである必要がありますTO_DISK。

  • 設定のアップロードには、条件言語のバージョンと論理式の定義が含まれます。

(オプション) description

キャンペーンの目的を特定するのに役立つ説明を追加します。

(オプション) diagnosticsMode

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

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

(オプション) expiryTime

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

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

(オプション) postTriggerCollectionDuration

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

デフォルト値: 0

(オプション) priority

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

デフォルト値: 0

(オプション) signalsToCollect

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

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

  • dataPartitionId – シグナルで使用するデータパーティションの ID。ID は、 で指定された IDs のいずれかと一致する必要がありますdataPartitions。データパーティションの条件としてシグナルをアップロードする場合、それらの同じシグナルを に含める必要がありますsignalsToCollect。

  • (オプション) maxSampleCount – データ収集スキームが呼び出されたときに Edge Agent ソフトウェアが収集してクラウドに転送するデータサンプルの最大数。

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

    有効な範囲: 0～4294967295

(オプション) spoolingMode

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

デフォルト値: OFF

(オプション) startTime

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

デフォルト値: 0

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

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

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

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

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

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

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

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

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

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

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

チュートリアル