

AWS 自 2026 年 4 月 30 日起，物联网 FleetWise 将不再向新客户开放。现有的 AWS 物联网 FleetWise 客户可以继续使用该服务。[上的《互联移动指南》 AWS提供了有关如何为](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)互联移动解决方案开发和部署模块化服务的指导，这些解决方案可用于实现与 AWS 物联网同等的功能 FleetWise。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 通过活动收集 AWS 物联网 FleetWise 数据
<a name="campaigns"></a>

**重要**  
目前对某些 AWS 物联网 FleetWise 功能的访问受到限制。有关更多信息，请参阅 [AWS AWS 物联网中的区域和功能可用性 FleetWise](fleetwise-regions.md)。

活动是指数据收集规则的编排。活动向 AWS 物联网边缘代理 FleetWise 软件提供了有关如何选择、收集数据并将其传输到云端的说明。

您要在云中创建活动。在您或您的团队批准活动后， AWS 物联网会将该活动 FleetWise 设置为准备部署，并将在下次办理车辆登机手续时部署。您可以选择将活动部署到一辆车还是部署到车队。在将正在运行的活动部署到车辆之前，边缘代理软件不会开始收集数据。

**重要**  
只有在具备以下条件后，活动才会生效。  
您的车辆中正在运行边缘代理软件。有关如何开发、安装和使用边缘代理软件的更多信息，请执行以下操作。  
打开[AWS 物联网 FleetWise 控制台](https://console.aws.amazon.com/iotfleetwise)。
在服务主页的** AWS 物联网入门 FleetWise**部分，选择**探索 Edge Agent**。
您已设置 AWS IoT Core 好配置您的车辆。有关更多信息，请参阅 [配置 AWS 物联网 FleetWise 车辆](provision-vehicles.md)。

**注意**  
您还可以[监控车辆的最近已知状态](last-known-state.md)（而不是舰队）使用状态模板近乎实时地使用状态模板，这些模板允许您使用 “On Change” 或 “定期” 更新策略流式传输遥测数据。该功能还提供 “按需” 功能，用于激活或停用先前部署的模板或一次性请求当前的车辆状态（获取）。  
对上次已知状态的访问目前处于封锁状态。有关更多信息，请参阅 [AWS AWS 物联网中的区域和功能可用性 FleetWise](fleetwise-regions.md)。

每个活动包含以下信息。

`signalCatalogArn`  
与活动关联的信号目录的 Amazon 资源名称 (ARN)。

（可选）`tags`  
标签是可用于管理活动的元数据。您可以将同一标签分配给不同服务的资源，以指示这些资源是否相关。

`TargetArn`  
要部署活动的车辆或车队的 ARN。

`name`  
有助于识别活动的唯一名称。

`collectionScheme`  
数据收集方案为Edge Agent软件提供了有关要收集哪些数据或何时收集数据的指示。 AWS 物联网 FleetWise 目前支持基于条件的收集方案和基于时间的收集方案。  
+ `conditionBasedCollectionScheme`— 基于条件的收集方案使用逻辑表达式来识别要收集的数据。满足条件时，边缘代理软件会收集数据。
  + `expression`— 用于识别要收集哪些数据的逻辑表达式。例如，如果指定 `$variable.`myVehicle.InVehicleTemperature` > 50.0` 表达式，则边缘代理软件会收集大于 50.0 的温度值。有关如何编写表达式的说明，请参阅[AWS 物联网 FleetWise 活动的逻辑表达式](logical-expression.md)。
  + （可选）`conditionLanguageVersion`-条件表达式语言的版本。
  + （可选）`minimumTriggerIntervalMs`-两个数据收集事件之间的最短持续时间，以毫秒为单位。如果信号经常变动，则您可能要以较低速率收集数据。
  + （可选）`triggerMode`— 可以是以下值之一：
    + `RISING_EDGE`— Edge Agent 软件仅在首次满足条件时才收集数据。例如 `$variable.`myVehicle.AirBagDeployed` == true`。
    + `ALWAYS` - 满足条件时，边缘代理软件会收集数据。
+ `timeBasedCollectionScheme`— 定义基于时间的收集方案时，请指定以毫秒为单位的时间段。边缘代理软件使用该时间段来决定收集数据的频率。例如，如果时间段为 120,000 毫秒，则边缘代理软件会每隔两分钟收集一次数据。
  + `periodMs`— 决定数据收集频率的时间段（以毫秒为单位）。

（可选）`compression`  
为了节省无线带宽并减少网络流量，您可以指定 [SNAPPY](https://opensource.google/projects/snappy) 来压缩车辆中的数据。  
默认情况下 (`OFF`)，边缘代理软件不压缩数据。

`dataDestinationConfigs`  
选择广告活动将传输车辆数据的单个目的地。您可以将数据发送到 [MQTT 主题](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html)，也可以将其存储在 Amazon S3 或 Amazon Timestream 中。  
MQTT（消息队列遥测传输）是一种轻量级且被广泛采用的消息传递协议。您可以将数据发布到 MQTT 主题，以使用规则建立自己的事件驱动架构。 AWS IoT AWS IoT 对 MQTT 的支持基于 M [QTT v3.1.1 规范和 MQT [T v5.0](http://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html) 规范](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html)，但有一些区别。有关更多信息，请参阅 [MQTT 的区别](https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html#mqtt-differences.html)。  
S3 可以是一种经济实惠的数据存储机制，可提供持久的数据管理功能和下游数据服务。您可以使用 S3 获取与驾驶行为或分析长期维护相关的数据。  
Timestream 是一种数据持久化机制，可以帮助您近乎实时地识别趋势和模式。您可以使用 Timestream 获取时间序列数据，执行车速或制动历史趋势分析等操作。  
Amazon Timestream 不在亚太地区（孟买）区域推出。

（可选）`dataExtraDimensions`  
您可以添加一个或多个属性，为信号提供其他信息。

（可选）`dataPartitions`  
创建数据分区以临时存储车辆上的信号数据。您可以配置何时以及如何将数据转发到云端。  
+ 通过定义最大 FleetWise 存储大小、最短存活时间和存储位置，指定 AWS IoT 如何将数据存储在车辆或车队上。
+ 竞选活动`spoolingMode`必须是`TO_DISK`。
+ 上传配置包括定义条件语言和逻辑表达式的版本。

（可选）`description`  
添加描述以帮助确定广告活动的目的。

（可选）`diagnosticsMode`  
将诊断模式配置为后`SEND_ACTIVE_DTCS`，活动会发送存储的标准诊断故障代码 (DTCs)，以帮助识别您的车辆出了什么问题。例如，P0097 表示发动机控制模块 (ECM) 已确定进气温度传感器 2 (IAT2) 输入低于正常传感器范围。  
默认情况下 (`OFF`)，边缘代理软件不发送诊断代码。

（可选）`expiryTime`  
定义广告活动的到期日期。活动到期后，边缘代理软件将停止收集此活动中指定的数据。如果在车辆上部署了多个活动，则边缘代理软件会使用其他活动来收集数据。  
默认值：`253402243200`（9999 年 12 月 31 日，世界标准时间 00:00:00）

（可选）`postTriggerCollectionDuration`  
您可以定义触发后的收集持续时间，以便边缘代理软件在调用方案后的指定时间段内继续收集数据。例如，如果使用以下表达式调用基于条件的收集方案：`$variable.`myVehicle.Engine.RPM` > 7000.0`，则边缘代理软件将继续收集引擎的每分钟转数 (RPM) 值。即使 RPM 只高于 7000 一次，也可能表明存在机械问题。在这种情况下，您可能希望边缘代理软件继续收集数据以帮助监控情况。  
默认值：`0`

（可选）`priority`  
指定一个整数来表示活动的优先级。数值越小，活动的优先级越高。如果在车辆上部署多个活动，则优先级较高的活动将先启动。  
默认值：`0`

（可选）`signalsToCollect`  
调用数据收集方案时从中收集数据的信号列表。  
+ `name`— 调用数据收集方案时从中收集数据的信号的名称。
+ `dataPartitionId`— 要在信号中使用的数据分区的 ID。该身份证必须与中 IDs 提供的其中一个相匹配`dataPartitions`。如果您将信号作为条件上传到数据分区，则必须将相同的信号包含在数据分区中`signalsToCollect`。
+ （可选）`maxSampleCount`— 调用数据收集方案时，Edge Agent 软件收集并传输到云端的最大数据样本数。
+ （可选）`minimumSamplingIntervalMs`-两个数据样本收集事件之间的最短持续时间，以毫秒为单位。如果信号经常变动，则您可能要使用此参数以较低速率收集数据。

  有效范围：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 联网 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 联网 FleetWise 活动](create-campaign.md)
+ [更新物 AWS 联网 FleetWise 活动](update-campaign-cli.md)
+ [删除物 AWS 联网 FleetWise 活动](delete-campaign.md)
+ [获取 AWS 物联网 FleetWise 活动信息](get-campaign-information-cli.md)
+ [存储和转发广告系列数据](store-and-forward.md)
+ [使用 AWS IoT 收集诊断故障代码数据 FleetWise](diagnostic-trouble-codes.md)
+ [可视化 AWS 物联网 FleetWise 车辆数据](process-visualize-data.md)