物联网数据应用开发最佳实践——数据价值类

 IoT Studio 对接后可以在 web 页面引用展示当前 IoT Studio 项目关联设备的一些运行数据及统计指标，获取设备的运行状态等

前提条件

• 使用真实设备或 SDK 模拟设备连续多天上报数据

• 上报的属性必须为数值类型属性

背景信息

本文以 IoT Studio 项目引用同一产品多个设备为例，设备主要属性为三个温度值（temperature_1,temperature_2,temperature_3）,代表设备不同部件温度值，一个温度告警事件，

查看设备单一属性一天内最高温度，最低温度，平均温度

单一设备 最近一天温度报警次数 （针对 temperature_1 属性）

整个 studio 项目（分组）最近一天温度报警次数（针对 temperature_1 属性）

操作步骤

注：购买数据型企业实例，或已有企业实例升配至数据型实例请参考实例购买或升配，产品，设备的创建及设备上报属性不在此赘述

1: 创建 studio 项目

进入增值服务 studio 控制台，左侧选择相应的实例，点击新增项目，创建 studio 项目

2: 绑定产品和设备

进入新建的项目后，关联产品及设备

关联产品

在产品列表页勾选要关联的产品，点击确认，将产品关联到 stuido 项目中，即可在后续的操作中使用该产品

关联设备

可选择关联物联网平台设备（需要是上一步绑定的产品下的设备），勾选相应的设备后点击确定，或直接添加设备（新建设备并绑定到项目）

添加设备

3. 数据分析

IoT Studio 项目在数据分析工作台会映射为一个分组（注：需要在 stuido 项目所归属示例中操作）

eg: 示例中使用的项目名为： test0525mxj 则在 LA 数据分析中可在分组视角中看到该项目

该分组只能查看，不能做其他编辑

点击查看，可看到设备列表中展示分组绑定的四个产品（三个之前绑定，一个新增设备）

3.1 备份产品数据

数据备份为了保存了设备上报的历史数据（默认只能存储 1 个月，开启备份后可根据需要选择备份周期），为后续数据分析提供原始数据

进入数据分析-> 数据管理

搜索相应的产品（IoT Studio 项目中绑定的产品），示例中产品为：IoT Studio 产品

注： 若之前未开启备份，操作按钮会有 备份按钮，若已开启备份（备份状态为运行中），则操作中包含“停止”，若已停止，则可选择“开启”

未开启备份示例：

已开启备份示例

3.2 属性数据分析

数据资产中，点击新建指标即可创建指标

3.2.1 为分组下的设备创建指标

选择设备，表明该指标为设备的衍生指标

选择分组->test0525mxj（分组名）-> lzf_test_studio01(设备名)

表示：为分组(studio 项目) test0525mxj 中的 lzf_test_studio01 设备创建一个衍生指标

注： 选择所属实体选择时：使用分组，若选择产品，则会导致指标创建在产品-》设备维度下，无法在 studio 项目中引用

选择事件修饰词，原子词，以及计算规则等，为 lzf_test_studio01 创建一个衍生指标，计算温度 1 这个属性最近一天的平均值

注：若原子词表义不够精确，或当前可选原子词中没有期望值，可根据需要新建原子词

例如： 以下截图中选择的原子词表义不够明确，应该为：最近一天温度 1 的平均值

可创建新的原子词，温度 1 度平均值 ，再返回创建指标即可使用新的原子词

使用新的原子词

根据上述流程，分别为 lzf_test_studio01- lzf_test_studio04 创建温度 1 的最近 1 天平均值，最大值，最小值等指标

3.2.2 为分组创建指标

选择分组，表明该指标为分组的衍生指标

选择分组： test0525mxj（分组名）

其他操作参考 3.2.1

3.2.3 回刷指标

指标上线后，会每天凌晨开始自动调度，生成上一日的统计值

若期望当天使用该指标，可根据历史数据，回刷之前的数据，生成今天之前的统计数据

创建回刷任务：

1. 点击指标任务，进入指标任务管理页面

2. 选择回刷实例（周期实例为周期调度产生，详情请产考数据分析周期实例介绍文档）

3. 新增回刷任务

4. 选择开始时间结束时间（单次回刷最多可选择 30 天范围，若期望更长时间，可在将时间分割为多个时间多，分多次回刷）

5. 选择要回刷的指标（一个回刷任务可回刷一个指标，回刷多个指标需创建多个回刷任务）

6. 点击确认

回刷任务列表：

可点击查看运行状态，若回刷失败，可点击重跑，（单次回刷多个可能导致上下依赖，或任务等待超时，导致失败），若持续失败，可进入答疑群，由技术同学提供支持

3.3 事件解析

通过对设备上报的事件数据解析，可获取事件上报内容，实现对事件进行分类，统计等操作

以下示例对温度报警事件进行分类统计，统计最近 1 天温度 1 的报警次数

3.3.1 解析事件内容

在数据分析工作台，可以通过 topic 解析任务来处理设备上报的数据

1: 创建 topic 解析任务

2: 设置源定义

选择指定的实例， 产品，选择全部设备（所有设备上报的数据均会被解析），选择物模型通信 topic（若事件通过自定义 topic 上报，则可选择自定义 topic）， 选择对应的事件 topic

可通过拉去线上数据查看事件内容

3: 设置筛选器

这里只对温度 1 的报警事件进行统计，暂时只选择

params.identifier_name = temperature_1 的数据进行统计

4:设置表达式

在此期望后续对报警次数进行统计，可新增一个计数器，每处理一条符合条件的事件记录，则产出一个指标，数值为 1，表示该事件触发一次，后续对该改字段进行累加即可获取相应时间段内该事件触发次数

5: 输出相应字段

可根据需要输出期望字段，移除不需要的字段

6: 调试

7：上线

查看生成的原始指标：

3.3.2 回刷解析任务

解析任务上线后，会每天凌晨开始自动调度，解析上一日的事件记录

若期望处理历史事件数据，可创建回刷任务，回刷历史数据

1: 点击解析任务，进入解析任务管理页

2: 进入回刷任务列表（周期任务为定时调度产生）

3: 创建回刷任务

选择回刷日期，相关任务，点击确认即可提交任务

4: 若执行失败可进行重跑

3.3.3 进行统计分析

创建分析指标，引用 topic 解析生成的原始指标

截图为 为 lzf_test_studio04 创建 温度 1 报警记录统计

选择新生成的 temperature_1_alert_count 进行 sum 求和获取最近一天温度 1 的报警次数

创建后，回刷请参考 3.2.3

4 创建数据服务

系统 API 主要提供系统指标以及产品原始数据查询 API

数据服务- > 自定义服务-> 新增 API

填写 API 名称和 APIpath 点击进入下一步

指标域可选 分组/设备 或这个分组

表示引用分组下的设备的指标创建 API，或引用分组下的衍生指标创建 API

数据集，选择相应的分组，以及分组下的设备

请求参数和返回参数可选择该设备已上线的指标以及业务时间（当天创建的指标需要回刷后或第二天自动调度成功后方可使用）

配置完成后，对 API 进行测试

测试成功后点击发布 API，即可在 studio 中调用该 API

5: IoT Studio 使用数据分析数据

5.1 使用系统 API 查看原始数据

准备

新建 web 页面，拖入时间范围组件（可以为后续 API 提供时间参数）

设置默认时间，避免接口饮用时无默认值导致失败

选择折线图组件（或者表格组件等其他组件），点击配置数据源

配置数据源

1: 数据源选择接口

2:接口来源选择数据分析服务

3:接口类型选择： 通用接口（系统 API）

4:选择需要需要查看的产品的原始数据查询 API

设置参数：

1: 静态参数

直接对参数进行赋值，页面发布后，每次请求都会以此参数请求数据

2:动态参数

进入动态参数列表，选择 timestamp 参数来源于组件（可选择之前拖入对时间组件）

选择之前拖入的时间组件的值为接口入参

配置完成后，会自动获取指定时间范围内的数据

配置图表展示数据

点击确认后可查看当前 API 所有可选字段包含：

设备名，设备 id，以及产品下设定的物模型属性，通过 topic 解析生成的原始指标（temperature_1_alert_count）

以上数据需要重新上传，数据可读性不高

期望： 展示温度 1 的历史记录，同时在数据大于 20 时，会触发一次报警

5.2 使用自定义 API 查案统计数据

配置数据源选择用户接口：

studioTestApi （上一步创建的自定义 API）

其他步骤参考使用系统 API 查看数据

物联网平台产品介绍详情：​​https://www.aliyun.com/product/iot/iot_instc_public_cn​​

阿里云物联网平台客户交流群