本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
通过活动收集 AWS 物联网 FleetWise 数据
活动是指数据收集规则的编排。活动向 AWS 物联网边缘代理 FleetWise 软件提供了有关如何选择、收集数据并将其传输到云端的说明。
您要在云中创建活动。在您或您的团队批准活动后， AWS IoT FleetWise 会自动将其部署到车辆上。您可以选择将活动部署到一辆车还是部署到车队。在将正在运行的活动部署到车辆之前，边缘代理软件不会开始收集数据。
注意
只有在具备以下条件后，活动才会生效。
-
您的车辆中正在运行边缘代理软件。有关如何开发、安装和使用边缘代理软件的更多信息，请执行以下操作。
-
在服务主页的 AWS 物联网入门 FleetWise部分，选择探索 Edge Agent。
-
您已设置 AWS IoT Core 好配置您的车辆。有关更多信息，请参阅 配置 AWS 物联网 FleetWise 车辆。
每个活动包含以下信息。
signalCatalogArn-
与活动关联的信号目录的 Amazon 资源名称 (ARN)。
- （可选）
tags -
标签是可用于管理活动的元数据。您可以将同一标签分配给不同服务的资源，以指示这些资源是否相关。
TargetArn-
部署战役ARN的车辆或车队的车辆。
name-
有助于识别活动的唯一名称。
collectionScheme-
数据收集方案为Edge Agent软件提供了有关要收集哪些数据或何时收集数据的指示。 AWS 物联网 FleetWise 目前支持基于条件的收集方案和基于时间的收集方案。
conditionBasedCollectionScheme-
基于条件的收集方案使用逻辑表达式来识别要收集哪些数据。满足条件时，边缘代理软件会收集数据。
expression-
用于识别要收集哪些数据的逻辑表达式。例如，如果指定
$variable.`myVehicle.InVehicleTemperature` > 50.0表达式，则边缘代理软件会收集大于 50.0 的温度值。有关如何编写表达式的说明，请参阅AWS 物联网 FleetWise活动的逻辑表达式。 - （可选）
triggerMode可以是以下值之一。 -
-
RISING_EDGE- 仅在第一次满足条件时，边缘代理软件才会收集数据。例如，$variable.`myVehicle.AirBagDeployed` == true。 -
ALWAYS- 满足条件时，边缘代理软件会收集数据。
-
- （可选）
minimumTriggerIntervalMs -
两次收集数据事件之间的最短时长，以毫秒为单位。如果信号经常变动，则您可能要以较低速率收集数据。
- （可选）
conditionLanguageVersion -
条件表达式语言的版本。
timeBasedCollectionScheme-
定义基于时间的收集方案时，请指定以毫秒为单位的时间段。边缘代理软件使用该时间段来决定收集数据的频率。例如，如果时间段为 120,000 毫秒，则边缘代理软件会每隔两分钟收集一次数据。
- （可选）
compression -
为了节省无线带宽并减少网络流量，您可以指定SNAPPY
压缩车辆中的数据。 默认情况下 (
OFF)，边缘代理软件不压缩数据。 dataDestinationConfigs-
选择活动将传输车辆数据的目标。您可以选择在 Amazon S3 或 Amazon Timestream 中存储数据。
S3 是一种经济实惠的数据存储机制，可提供持久的数据管理功能和下游数据服务。您可以使用 S3 获取与驾驶行为或分析长期维护相关的数据。
Timestream 是一种数据持久化机制，可以帮助您近乎实时地识别趋势和模式。您可以使用 Timestream 获取时间序列数据，执行车速或制动历史趋势分析等操作。
- （可选）
dataExtraDimensions -
您可以添加一个或多个属性，为信号提供其他信息。
- （可选）
description -
您可以添加描述，以帮助标识活动的目的。
- （可选）
diagnosticsMode -
将诊断模式配置为后
SEND_ACTIVE_DTCS，活动会发送存储的标准诊断故障代码 (DTCs)，以帮助识别您的车辆出了什么问题。例如，P0097 表示发动机控制模块 (ECM) 已确定进气温度传感器 2 (IAT2) 输入低于正常传感器范围。默认情况下 (
OFF)，边缘代理软件不发送诊断代码。 - （可选）
expiryTime -
您可以为活动定义到期日期。活动到期后，边缘代理软件将停止收集此活动中指定的数据。如果在车辆上部署了多个活动，则边缘代理软件会使用其他活动来收集数据。
默认值：
253402243200（9999 年 12 月 31 日，00:00:00UTC） - （可选）
postTriggerCollectionDuration -
您可以定义触发后的收集持续时间，以便边缘代理软件在调用方案后的指定时间段内继续收集数据。例如，如果调用带有以下表达式的基于条件的收集方案：
$variable.`myVehicle.Engine.RPM` > 7000.0，则 Edge Agent 软件将继续收集引擎的每分钟转数 (RPM) 值。即使RPM只有一次高于 7000，也可能表明存在机械问题。在这种情况下，您可能希望边缘代理软件继续收集数据以帮助监控情况。默认值：
0 - （可选）
priority -
您可以指定一个整数来表示活动的优先级。数值越小，活动的优先级越高。如果在车辆上部署多个活动，则优先级较高的活动将先启动。
默认值：
0 - （可选）
signalsToCollect -
调用数据收集方案时从中收集数据的信号列表。
name-
调用数据收集方案时从中收集数据的信号的名称。
- （可选）
maxSampleCount -
调用数据收集方案时，边缘代理软件收集并传输到云端的最大数据样本数。
- （可选）
minimumSamplingIntervalMs -
两次数据样本收集事件之间的最短时长，以毫秒为单位。如果信号经常变动，则您可能要使用此参数以较低速率收集数据。
有效范围：0‐4294967295
- （可选）
spoolingMode -
如果
spoolingMode配置为TO_DISK，那么在车辆未连接到云端时，边缘代理软件会临时将数据存储在本地。重新建立连接后，存储在本地的数据将自动传输到云端。默认值：
OFF - （可选）
startTime -
已批准的活动将在开始时间激活。
默认值：
0
活动状态可以是以下值之一：
-
CREATING— AWS IoT FleetWise 正在处理您创建活动的请求。 -
WAITING_FOR_APPROVAL- 活动在创建后即进入WAITING_FOR_APPROVAL状态。要批准该活动，请使用UpdateCampaignAPI操作。活动获得批准后， AWS IoT FleetWise 会自动将活动部署到目标车辆或车队。有关更多信息，请参阅 更新物 AWS 联网 FleetWise 活动。 -
RUNNING- 活动已激活。 -
SUSPENDED- 活动已暂停。要恢复活动，请使用UpdateCampaignAPI操作。
AWS IoT FleetWise 提供了以下API操作，您可以使用这些操作来创建和管理活动。
-
CreateCampaign— 创建新的广告系列。
-
UpdateCampaign— 更新现有广告系列。创建活动后，您必须使用此API操作来批准该活动。
-
DeleteCampaign— 删除现有广告系列。
-
ListCampaigns— 检索所有广告系列的分页摘要列表。
-
GetCampaign— 检索有关广告系列的信息。
