AWS IoT FleetWise キャンペーンを作成する

AWS IoT FleetWise コンソールまたは API を使用して、車両データを収集するキャンペーンを作成できます。

重要

キャンペーンが機能するためには、次の条件が満たされている必要があります。

エッジエージェントソフトウェアが車両内で実行されている。エッジエージェントソフトウェアを開発、インストール、使用する方法の詳細を確認するには、以下の操作を行います。
1. AWS IoT FleetWise コンソールに移動します。
2. サービスのホームページの AWS IoT FleetWise の使用を開始する」セクションで、エッジエージェントの探索「」を選択します。
車両をプロビジョニング AWS IoT Core するようにを設定しました。詳細については、「Provision AWS IoT FleetWise 車両」を参照してください。

トピック

キャンペーンの作成 (コンソール)
キャンペーンの作成 (AWS CLI)
AWS IoT FleetWise キャンペーンの論理式

キャンペーンの作成 (コンソール)

AWS IoT FleetWise コンソールを使用してキャンペーンを作成し、車両データを選択、収集、クラウドに転送できます。

キャンペーンを作成するには

AWS IoT FleetWise コンソールに移動します。
ナビゲーションペインで、[キャンペーン] を選択します。
[キャンペーン] ページで、[キャンペーンを作成] を選択し、以下のトピックの手順を完了します。

重要

キャンペーンを作成する前に、シグナルカタログと車両を用意する必要があります。詳細については、「Manage AWS IoT FleetWise シグナルカタログ」および「Manage AWS IoT FleetWise 車両」を参照してください。
キャンペーンが作成されたら、そのキャンペーンを承認する必要があります。詳細については、「ステップ 5: キャンペーンをデプロイする」を参照してください。

ステップ 1: キャンペーンを構成する

[一般的な情報] セクションで、次の操作を行います。

キャンペーンの名前を入力します。
(オプション) 説明を入力します。

キャンペーンのデータ収集スキームを構成します。データ収集スキームは、どのようなデータをいつ収集するかに関する指示をエッジエージェントソフトウェアに与えます。 AWS IoT FleetWise コンソールでは、以下の方法でデータ収集スキームを設定できます。

データ収集スキームを手動で定義します。
データ収集スキームを自動的に定義するためのファイルをアップロードします。

[設定オプション] で、次のいずれかを選択します。

手動でデータ収集スキームのタイプを指定し、オプションを定義してスキームをカスタマイズするには、[データ収集スキームを定義] を選択します。
手動でデータ収集スキームのタイプを指定し、オプションを定義してスキームをカスタマイズします。
1. [データ収集スキームの詳細] セクションで、このキャンペーンで使用するデータ収集スキームのタイプを選択します。収集する車両データを認識するために論理式を使用するには、[条件ベース] を選択します。特定の時間間隔を使用して車両データの収集頻度を決定するには、[時間ベース] を選択します。
2. キャンペーンでデータを収集する期間を定義します。
  
  注記
  デフォルトでは、承認されたキャンペーンはすぐにアクティブ化され、終了時間は設定されません。追加料金が発生しないようにするには、時間範囲を指定する必要があります。
3. 条件ベースのデータ収集スキームを指定した場合は、収集するデータを認識する論理式を定義する必要があります。 AWS IoT FleetWise は論理式を使用して、条件ベースのスキームのために収集するデータを認識します。この式では、シグナルの完全修飾名を表す変数、比較演算子、および比較値を指定する必要があります。
  
  例えば、$variable.`myVehicle.InVehicleTemperature` > 50.0式を指定すると、 AWS IoT FleetWise は 50.0 を超える温度値を収集します。式の書き方の手順については、「AWS IoT FleetWise キャンペーンの論理式」を参照してください。
  
  収集するデータを認識するために使用される論理式を入力します。
4. (オプション) 条件式の言語バージョンを指定できます。デフォルト値は 1 です。
5. (オプション) 最小トリガー間隔を指定できます。これは、2 つのデータ収集イベント間の最小時間を表します。例えば、シグナルが頻繁に変化する場合は、データの収集速度を遅くすることができます。
6. エッジエージェントソフトウェアでデータを収集するための [トリガーモード] の条件を指定します。デフォルトでは、Edge Agent for AWS IoT FleetWise ソフトウェアは、条件が満たされるたびに常にデータを収集します。または、[最初のトリガー時] を選択して、条件が初めて満たされたときにのみデータを収集することもできます。
7. 時間ベースのデータ収集スキームを指定した場合は、[期間] を 10,000～60,000 ミリ秒で指定する必要があります。エッジエージェントソフトウェアは、その時間間隔を使用してデータの収集頻度を決定します。
8. (オプション) [高度なスキームオプション] で、スキームの高度なオプションを編集できます。
  
  データを圧縮することでワイヤレス帯域幅を節約し、ネットワークトラフィックを減らすには、SNAPPY を選択します。
  (オプション) データ収集イベントの後にデータを収集し続ける期間をミリ秒単位で定義するには、[トリガー後の収集期間] を指定します。
  (オプション) キャンペーンの優先度を指定するには、キャンペーンの [優先度] を指定します。優先度の数値が小さいキャンペーンほど優先度が高いと見なされ、最初にデプロイされます。
  エッジエージェントソフトウェアは、車両がクラウドに接続されていないときにデータを一時的にローカルに保存できます。接続が再確立されると、ローカルに保存されたデータが自動的にクラウドに転送されます。[データのローカル保存] で、接続の切断時にエッジエージェントでデータをローカルに保存すかどうかを指定します。
  (オプション) シグナルの追加情報を提供するには、[追加のデータディメンション] として最大 5 個の属性を追加します。
ファイルをアップロードしてデータ収集スキームを定義するには、ローカルデバイスから .json ファイルをアップロードを選択します。 AWS IoT FleetWise は、ファイルで定義できるオプションを自動的に定義します。選択されたオプションを確認して更新できます。
データ収集スキームに関する詳細が記述された .json ファイルをアップロードします。
1. データ収集スキームの情報をインポートするには、[ファイルを選択] を選択します。必要なファイル形式の詳細については、CreateCampaignAPIドキュメントを参照してください。
  
  注記
  AWS IoT FleetWise は現在、.json ファイル形式の拡張をサポートしています。
2. AWS IoT FleetWise は、ファイル内の情報に基づいてデータ収集スキームを自動的に定義します。 AWS IoT FleetWise が選択したオプションを確認します。必要に応じてオプションを更新できます。

シグナルの指定

データ収集スキームが呼び出されたときにデータを収集するシグナルを指定します。

データを収集するシグナルを指定するには

[名前] で、シグナルの完全修飾名を検索します。

注記
シグナルの完全修飾名は、シグナルのパスにシグナルの名前を続けたものです。子シグナルを参照するには、ドット (.) を使用します。
例えば、Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState は HandsOffSteeringState アクチュエータの完全修飾名です。Vehicle.Chassis.SteeringWheel.HandsOff. はこのアクチュエータのパスを示します。
(オプション) [最大サンプル数] に、データ収集スキームが呼び出されたときにエッジエージェントソフトウェアが収集してクラウドに転送するデータサンプルの最大数を入力します。
(オプション) [最小サンプリング間隔] に、2 つのデータサンプル収集イベント間の最小時間をミリ秒単位で入力します。シグナルが頻繁に変化する場合は、このパラメータを使用してデータの収集速度を遅くすることができます。
別のシグナルを追加するには、[シグナルをさらに追加] を選択します。最大 999 個のシグナルを追加できます。
[次へ] を選択します。

ステップ 2: 保存先を定義する

注記

キャンペーンにビジョンシステムデータシグナルが含まれている場合のみ、車両データを Amazon S3 に転送できます。

ビジョンシステムデータはプレビューリリースであり、変更される可能性があります。

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

[送信先の設定] で、次の操作を行います。

ドロップダウンリストから S3 または Timestream を選択します。

車両データを S3 バケットに保存する場合は、[Amazon S3] を選択します。S3 は、データをオブジェクトとしてバケットに保存するオブジェクトストレージサービスです。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「Amazon S3 バケットの作成、設定、操作」を参照してください。

S3 は、データストレージのコストを最適化し、データレイク、一元化されたデータストレージ、データ処理パイプライン、分析など、車両データを利用するための追加メカニズムを提供します。S3 を使用すると、データを保存してバッチ処理や分析を行うことができます。例えば、機械学習 (ML) モデル用に急ブレーキイベントのレポートを作成できます。受信した車両データは、配信前に 10 分間バッファリングされます。

重要

IoT に S3 バケットに書き込むアクセス許可 AWS IoT FleetWise がある場合にのみ、データを S3 に転送できます。アクセス許可の詳細については、AWS IoT FleetWise によるアクセスの制御」を参照してください。

[S3 destination settings] で、次の操作を行います。

S3 バケット では、アクセス許可 AWS IoT FleetWise を持つバケットを選択します。
(オプション) S3 バケットに保存されているデータを体系化するために使用できるカスタムプレフィックスを入力します。
出力形式を選択します。これは、S3 バケットに保存されるファイルの形式です。
S3 バケットに保存されたデータを .gzip ファイルとして圧縮するかどうかを選択します。ストレージコストが最小限に抑えられるため、データを圧縮することをお勧めします。
S3 送信先設定で選択したオプションは、サンプル S3 オブジェクト URIを変更します。これは、S3 に保存されるファイルの例を示すものです。

車両データを Timestream テーブルに保存するには、[Amazon Timestream] を選択します。Timestream を使用すると、車両データにクエリを実行して傾向やパターンを特定できます。例えば、Timestream を使用して車両の燃料レベルのアラームを作成できます。受信した車両データは、ほぼリアルタイムに Timestream に転送されます。詳細については、「Amazon Timestream Developer Guide」の「What is Amazon Timestream?」を参照してください。

重要

AWS IoT FleetWise に Timestream にデータを書き込むアクセス許可がある場合にのみ、データをテーブルに転送できます。アクセス許可の詳細については、AWS IoT FleetWise によるアクセスの制御」を参照してください。

[Timestream テーブルの設定] で、次の操作を行います。

[Timestream データベース名] で、ドロップダウンリストから Timestream データベースの名前を選択します。
[Timestream テーブル名] で、ドロップダウンリストから Timestream テーブルの名前を選択します。

[Timestream のサービスアクセス] で、次の操作を行います。

ドロップダウンリストからIAMロールを選択します。

[Next (次へ)] を選択します。

ステップ 3: 車両を追加する

キャンペーンをデプロイする車両を選択するには、車両のリストで目的の車両を選択します。車両の作成時に追加した属性や値、または車両名で検索して、車両をフィルタリングします。

[車両をフィルタリング] で、次の操作を行います。

検索ボックスで属性または車両名を検索し、リストから選択します。

注記
各属性は 1 回だけ使用できます。
キャンペーンをデプロイする属性の値または車両名を入力します。例えば、属性の完全修飾名が fuelType の場合は、その値として gasoline を入力します。
別の車両属性を検索するには、前のステップを繰り返します。車両属性は最大 5 つまで、車両名はいくつでも検索できます。
[車両名] に、検索条件に一致する車両のリストが表示されます。キャンペーンをデプロイする先の車両を選択します。

注記
検索結果には最大 100 台の車両が表示されます。[すべて選択] を選択すると、すべての車両がキャンペーンに追加されます。
[Next (次へ)] を選択します。

ステップ 4: 確認して作成する

キャンペーンの構成を確認し、[キャンペーンを作成] を選択します。

注記

キャンペーンが作成されたら、ユーザーまたはユーザーのチームがキャンペーンを車両にデプロイする必要があります。

ステップ 5: キャンペーンをデプロイする

キャンペーンを作成したら、ユーザーまたはユーザーのチームがキャンペーンを車両にデプロイする必要があります。

キャンペーンをデプロイするには

[キャンペーンの概要] ページで、[デプロイ] を選択します。
デプロイを開始してキャンペーンに接続された車両からデータ収集を開始することを確認します。
[デプロイ] を選択します。

キャンペーンに接続されている車両からのデータ収集を一時停止する場合は、[キャンペーンの概要] ページで [停止] を選択します。キャンペーンに接続されている車両からのデータ収集を再開するには、[再開] を選択します。

キャンペーンの作成 (AWS CLI)

CreateCampaign API オペレーションを使用してキャンペーンを作成できます。次の例では AWS CLIを使用しています。

キャンペーンを作成するときは、車両から収集されたデータを Amazon S3 (S3) と Amazon Timestream のいずれかに保存できます。ほぼリアルタイムの処理を必要とするデータを保存する場合など、高速でスケーラブルなサーバーレス時系列データベースが必要な場合は、Timestream を選択します。業界をリードするスケーラビリティ、データ可用性、セキュリティ、パフォーマンスを提供するオブジェクトストレージが必要な場合は、S3 を選択します。

重要

車両データを転送できるのは、 AWS IoT FleetWise に S3 または Timestream にデータを書き込むアクセス許可がある場合のみです。アクセスの許可の詳細については、AWS IoT FleetWise によるアクセスの制御」を参照してください。

キャンペーンの作成

重要

キャンペーンを作成する前に、シグナルカタログと車両またはフリートが必要です。詳細については、Manage AWS IoT FleetWise シグナルカタログ、Manage AWS IoT FleetWise 車両、およびAWS IoT FleetWise でフリートを管理するを参照してください。
キャンペーンを作成したら、 UpdateCampaignAPIオペレーションを使用してキャンペーンを承認する必要があります。詳細については、「AWS IoT FleetWise キャンペーンを更新する」を参照してください

キャンペーンを作成するには、次のコマンドを実行します。

置換 file-name キャンペーン設定を含むJSONファイルの名前。


aws iotfleetwise create-campaign --cli-input-json file://file-name.json

置換 campaign-name 作成しているキャンペーンの名前。
置換 signal-catalog-arn シグナルカタログの Amazon リソースネーム (ARN) を使用します。
置換 target-arn 作成したARNフリートまたは車両のを使用します。
置換 bucket-arn S3 バケットARNのを使用します。


{
    "name": "campaign-name",
    "targetArn": "target-arn", 
    "signalCatalogArn": "signal-catalog-arn", 
    "collectionScheme": {
        "conditionBasedCollectionScheme": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
            "minimumTriggerIntervalMs": 1000,
            "triggerMode": "ALWAYS"
        }
    },
    "compression": "SNAPPY",
    "diagnosticsMode": "OFF",
    "postTriggerCollectionDuration": 1000,
    "priority": 0,
    "signalsToCollect": [
        {
         "maxSampleCount": 100,
         "minimumSamplingIntervalMs": 0,
         "name": "Vehicle.DemoEngineTorque"
        },
        {
         "maxSampleCount": 100,
         "minimumSamplingIntervalMs": 0,
         "name": "Vehicle.DemoBrakePedalPressure"
        }
    ],
    "spoolingMode": "TO_DISK",
    "dataDestinationConfigs": [
        {
         "s3Config": { 
             "bucketArn": "bucket-arn",
             "dataFormat": "PARQUET",
             "prefix": "campaign-name",
              "storageCompressionFormat": "GZIP"
      }
    }
  ]
}

置換 campaign-name 作成しているキャンペーンの名前。
置換 signal-catalog-arn シグナルカタログの Amazon リソースネーム (ARN) を使用します。
置換 target-arn 作成したARNフリートまたは車両のを使用します。
置換 role-arn Timestream テーブルにデータを配信するアクセス許可を AWS IoT FleetWise に付与するタスク実行ロールARNの。
置換 table-arn Timestream テーブルARNのを使用します。


{
  "name": "campaign-name",
  "targetArn": "target-arn",
  "signalCatalogArn": "signal-catalog-arn",
  "collectionScheme": {
    "conditionBasedCollectionScheme": {
      "conditionLanguageVersion": 1,
      "expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
      "minimumTriggerIntervalMs": 1000,
      "triggerMode": "ALWAYS"
    }
  },
  "compression": "SNAPPY",
  "diagnosticsMode": "OFF",
  "postTriggerCollectionDuration": 1000,
  "priority": 0,
  "signalsToCollect": [
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoEngineTorque"
    },
    {
      "maxSampleCount": 100,
      "minimumSamplingIntervalMs": 0,
      "name": "Vehicle.DemoBrakePedalPressure"
    }
  ],
  "spoolingMode": "TO_DISK",
  "dataDestinationConfigs": [
    {
      "timestreamConfig": {
        "executionRoleArn": "role-arn",
        "timestreamTableArn": "table-arn"
      }
    }
  ]
}

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

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

ドキュメントの表記規則

キャンペーンでデータを管理する

AWS IoT FleetWise キャンペーンの論理式