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

# キャンペーンを使用して AWS IoT FleetWise データを収集する
<a name="campaigns"></a>

**重要**  
現在、特定の AWS IoT FleetWise 機能へのアクセスはゲートされています。詳細については、「[AWS AWS IoT FleetWise でのリージョンと機能の可用性](fleetwise-regions.md)」を参照してください。

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

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

**重要**  
キャンペーンは、次の条件が満たされるまで機能しません。  
エッジエージェントソフトウェアが車両内で実行されている。エッジエージェントソフトウェアを開発、インストール、使用する方法の詳細を確認するには、以下の操作を行います。  
[AWS IoT FleetWise コンソール](https://console.aws.amazon.com/iotfleetwise)を開きます。
サービスのホームページの「Get **started with AWS IoT FleetWise**」セクションで、**「Explore Edge Agent**」を選択します。
車両をプロビジョニング AWS IoT Core するように をセットアップしました。詳細については、「[Provision AWS IoT FleetWise 車両](provision-vehicles.md)」を参照してください。

**注記**  
また、「On Change」または「Periodic」更新戦略を使用してテレメトリデータをストリーミングできる状態テンプレートを使用して、ほぼリアルタイムで [車両の最新の既知の状態をモニタリングする](last-known-state.md) (フリートではなく) することもできます。この機能には、以前にデプロイされたテンプレートを有効または無効にしたり、現在の車両状態を 1 回リクエスト (フェッチ) したりするための「オンデマンド」機能も用意されています。  
最後の既知の状態へのアクセスは、現在ゲートされています。詳細については、「[AWS AWS IoT FleetWise でのリージョンと機能の可用性](fleetwise-regions.md)」を参照してください。

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

`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 キャンペーンの論理式](logical-expression.md)」を参照してください。
  + (オプション) `conditionLanguageVersion` – 条件式言語のバージョン。
  + (オプション) `minimumTriggerIntervalMs` – 2 つのデータ収集イベント間の最小時間。ミリ秒単位。シグナルが頻繁に変化する場合は、データの収集速度を遅くすることができます。
  + (オプション) `triggerMode` – 次のいずれかの値を指定できます。
    + `RISING_EDGE` – Edge Agent ソフトウェアは、条件が初めて満たされた場合にのみデータを収集します。例えば、`$variable.`myVehicle.AirBagDeployed` == true`。
    + `ALWAYS` - エッジエージェントソフトウェアは、条件が満たされるたびにデータを収集します。
+ `timeBasedCollectionScheme` – 時間ベースの収集スキームを定義する場合は、期間をミリ秒単位で指定します。エッジエージェントソフトウェアは、その時間間隔を使用してデータの収集頻度を決定します。例えば、時間間隔が 120,000 ミリ秒の場合、エッジエージェントソフトウェアはデータを 2 分ごとに 1 回収集します。
  + `periodMs` – データを収集する頻度を決定する期間 (ミリ秒単位）。

(オプション) `compression`  
ワイヤレス帯域幅を節約し、ネットワークトラフィックを減らすために、[SNAPPY](https://opensource.google/projects/snappy) を指定して車両内のデータを圧縮できます。  
デフォルト (`OFF`) では、エッジエージェントソフトウェアはデータを圧縮しません。

`dataDestinationConfigs`  
キャンペーンが車両データを転送する 1 つの送信先を選択します。データを [MQTT トピック](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html)に送信するか、Amazon S3 または Amazon Timestream に保存できます。  
MQTT (Message Queuing Telemetry Transport) は、軽量で広く採用されているメッセージングプロトコルです。 AWS IoT rules を使用して MQTT トピックにデータを発行し、独自のイベント駆動型アーキテクチャを立ち上げることができます。MQTT AWS IoT のサポートは [ MQTT v3.1.1 仕様](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html)と [MQTT v5.0 仕様](http://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html)に基づいていますが、いくつかの違いがあります。詳細については、[「MQTT の違い](https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html#mqtt-differences.html)」を参照してください。  
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 キャンペーンを更新する](update-campaign-cli.md)」を参照してください。
+ `RUNNING ` - キャンペーンはアクティブです。
+ `SUSPENDED` - キャンペーンは停止しています。キャンペーンを再開するには、`UpdateCampaign` API オペレーションを使用します。

AWS IoT FleetWise には、キャンペーンの作成と管理に使用できる以下の API オペレーションが用意されています。
+ [CreateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateCampaign.html) - 新しいキャンペーンを作成します。
+ [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html) - 既存のキャンペーンを更新します。キャンペーンを作成したら、この API オペレーションを使用してキャンペーンを承認する必要があります。
+ [DeleteCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteCampaign.html) - 既存のキャンペーンを削除します。
+ [ListCampaigns](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListCampaigns.html) - すべてのキャンペーンの概要をページ分割されたリストとして取得します。
+ [GetCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetCampaign.html) - キャンペーンに関する情報を取得します。

**Topics**
+ [AWS IoT FleetWise キャンペーンを作成する](create-campaign.md)
+ [AWS IoT FleetWise キャンペーンを更新する](update-campaign-cli.md)
+ [AWS IoT FleetWise キャンペーンを削除する](delete-campaign.md)
+ [Get AWS IoT FleetWise キャンペーン情報](get-campaign-information-cli.md)
+ [キャンペーンデータの保存と転送](store-and-forward.md)
+ [AWS IoT FleetWise を使用して診断トラブルコードデータを収集する](diagnostic-trouble-codes.md)
+ [Visualize AWS IoT FleetWise 車両データ](process-visualize-data.md)