View a markdown version of this page

收集 AWS 包含活动的 IoT FleetWise 数据 - AWS 物联网 FleetWise

AWS 物联网 FleetWise 不再向新客户开放。现有的 AWS 物联网 FleetWise 客户可以继续使用该服务。《互联出行指南》 AWS为如何开发和部署用于实现与 AWS 物联网同等功能的互联移动解决方案的模块化服务提供了指导 FleetWise。

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

收集 AWS 包含活动的 IoT FleetWise 数据

重要

某些 AWS 物联网 FleetWise 功能的访问权限目前受到限制。有关更多信息,请参阅 AWS AWS 物联网中的区域和功能可用性 FleetWise。

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

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

重要

只有在具备以下条件后,活动才会生效。

  • 您的车辆中正在运行边缘代理软件。有关如何开发、安装和使用边缘代理软件的更多信息,请执行以下操作。

    1. 打开AWS 物联网 FleetWise 控制台。

    2. 在服务主页上的 AWS 物联网入门 FleetWise部分中,选择探索边缘代理。

  • 您已设置 AWS IoT Core 好配置车辆。有关更多信息,请参阅 供应 AWS 物联网 FleetWise 车辆。

注意

您也可以监控车辆的最近已知状态(不是舰队)使用状态模板进行近乎实时的传输,这些模板允许您使用 “On Change” 或 “定期” 更新策略传输遥测数据。该功能还提供 “按需” 功能,用于激活或停用先前部署的模板或一次性请求当前车辆状态(提取)。

对上次已知状态的访问权限目前处于封闭状态。有关更多信息,请参阅 AWS 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 活动。

    • (可选)conditionLanguageVersion— 条件表达式语言的版本。

    • (可选)minimumTriggerIntervalMs— 两个数据收集事件之间的最短持续时间,以毫秒为单位。如果信号经常变动,则您可能要以较低速率收集数据。

    • (可选)triggerMode— 可以是以下值之一:

      • RISING_EDGE— Edge Agent 软件仅在首次满足条件时收集数据。例如 $variable.`myVehicle.AirBagDeployed` == true。

      • ALWAYS - 满足条件时,边缘代理软件会收集数据。

  • timeBasedCollectionScheme— 定义基于时间的收集方案时,以毫秒为单位指定时间段。边缘代理软件使用该时间段来决定收集数据的频率。例如,如果时间段为 120,000 毫秒,则边缘代理软件会每隔两分钟收集一次数据。

    • periodMs— 决定收集数据频率的时间段(以毫秒为单位)。

(可选)compression

为了节省无线带宽并减少网络流量,您可以指定 SNAPPY 来压缩车辆中的数据。

默认情况下 (OFF),边缘代理软件不压缩数据。

dataDestinationConfigs

选择活动将传输车辆数据的单一目的地。您可以将数据发送到 MQTT 主题,也可以将其存储在亚马逊 S3 或 Amazon Timestream 中。

MQTT(消息队列遥测传输)是一种轻量级且被广泛采用的消息协议。您可以将数据发布到 MQTT 主题,以使用规则建立自己的事件驱动架构。 AWS IoT AWS IoT 对 MQTT 的支持基于 M QTT v3.1.1 规范和 MQT T v5.0 规范,但有一些区别。有关更多信息,请参阅 MQTT 差异。

S3 可以是一种经济高效的数据存储机制,可提供持久的数据管理功能和下游数据服务。您可以使用 S3 获取与驾驶行为或分析长期维护相关的数据。

Timestream 是一种数据持久化机制,可以帮助您近乎实时地识别趋势和模式。您可以使用 Timestream 获取时间序列数据,执行车速或制动历史趋势分析等操作。

注意

亚马逊 Timestream 不在亚太地区(孟买)地区提供。

(可选)dataExtraDimensions

您可以添加一个或多个属性,为信号提供其他信息。

(可选)dataPartitions

创建数据分区以临时将信号数据存储在车辆上。您可以配置何时以及如何将数据转发到云端。

  • 通过定义最大 FleetWise 存储大小、最短生存时间和存储位置,指定 AWS IoT 如何将数据存储在车辆或车队上。

  • 竞选活动spoolingMode必须是TO_DISK。

  • 上传配置包括定义条件语言和逻辑表达式的版本。

(可选)description

添加描述以帮助确定活动的目的。

(可选)diagnosticsMode

将诊断模式配置为 SEND_ACTIVE_DTCS 后,活动会发送存储的标准诊断故障代码 (DTC),以帮助识别您的车辆出了什么问题。例如,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。该 ID 必须与中提供的其中一个 ID 相匹配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 活动。

  • RUNNING - 活动已激活。

  • SUSPENDED - 活动已暂停。要批准该活动,请使用 UpdateCampaign API 操作。

AWS IoT FleetWise 提供以下 API 操作,您可以使用这些操作来创建和管理活动。