IndustrialSphere Industrial Data · Edge · SCADA · IoT

工业历史趋势图为什么会误导人?用三条数据检查倒序、缺测和截断

适合读者:趋势图、看板与历史查询开发者。

读完可以做什么:用三条数据检查升序绘图、null断线和hasMore提示,避免把缺测画成正常运行。

全部系列与阅读路线

IndustrialSphere开发实战 · 第2篇,共3篇

选择“今天”,接口返回1000条数据,折线也画出来了。这张图是否真的代表今天?如果返回的是最近1000条记录,页面却仍标着全天,读者看到的范围就可能与实际数据范围不一致。

另外两类问题也容易藏在正常渲染的折线里:时间顺序反了,或通讯中断被连成一段平滑曲线。本文使用EdgeHub历史接口,给出查询、转换和判断方法,示例点位为Demo_Temperature。

先确认历史已经产生

历史接口不会根据当前值生成过去的数据。开始之前,应确认测试点位已经启用所需归档、历史存储可用,并在网关侧查看到实际记录。

如果没有记录,先检查归档配置与存储状态,再检查查询时间。接口返回空集合与历史库连接失败是不同情况,页面也应分别表达。

明确查询时区和范围

以下示例查询一个带明确时区的小时区间。日期只是请求格式示例,使用时应换成测试环境确有历史记录的时间。

POST /api/v1/edgehub/history
Authorization: Bearer {{token}}
Content-Type: application/json

{
  "tagNames": ["Demo_Temperature"],
  "from": "2026-11-16T08:00:00+08:00",
  "to": "2026-11-16T09:00:00+08:00",
  "limit": 1000
}

令牌取得方式见上一篇。时间使用带时区的ISO格式,页面显示时再转换到目标时区。不要通过简单增加八小时、删除时区等方式修正读数,否则跨环境时容易出现重复转换。

当前接口单次最多查询50个变量,时间跨度不超过31天,单点返回数量上限为10000。项目仍应按实际点数、采样密度与页面用途选择更小的合理范围。

读取结果时检查完整性

响应包含data和hasMore。data按变量名称组织数据点,每个点包含timestamp、value和quality;hasMore按点位提示查询结果是否存在截断。

当前接口按时间倒序返回记录。绘图前应按实际时间升序整理,再把数值字符串转换为有限数字。质量异常的状态记录可能以空值表达,空值不能转换为零。

如果hasMore.Demo_Temperature为真,这批数据就不能代表完整查询区间。页面应明确提示,并缩小时间范围或分段获取。相邻查询边界可能重复包含同一记录,合并时需处理重复边界,不能把重复样本用于二次统计。

缺测不要自动连成正常曲线

人工数据样例:按时间升序显示,异常空值保留断点,同时检查查询是否截断。

图:人工数据样例:按时间升序显示,异常空值保留断点,同时检查查询是否截断。图示为说明示例。

可以用下面三条示例数据检查自己的图表。这是用于页面验证的人工样例,按接口返回的时间倒序排列。

返回顺序 数据时间 value quality
1 08:02 "27" 192,正常
2 08:01 null 0,异常
3 08:00 "25" 192,正常

绘图前先按时间升序整理。08:01应保留为空值断点:把null转成0,会制造一次不存在的温度骤降;删除这一条再连接两端,又会掩盖中间的异常。图表需要保留缺口,并关闭跨空值连线等不符合当前需求的选项。

趋势应利用质量异常记录显示断点;对于没有显式异常记录的长间隔,还要结合项目的采样与归档规则判断是否构成缺口。按变化保存的数据,连续相同值可能不会不断新增记录,因此不能仅凭时间间隔做统一推断。

页面还可以分开显示“请求范围”和“实际返回范围”。当hasMore为真时,提示“当前结果已截断,请缩小范围”,比只展示一条填满画布的曲线更便于判断。悬停时显示原始时间、数值和质量,方便工程人员核对记录。

实时曲线、历史查询和统计结果分开设计

实时卡片适合当前快照;历史趋势读取已归档记录;日均值、峰值等统计则需要明确有效样本与时间口径。

如果只取最近1000条记录再计算“全天平均值”,即使折线能够显示,也可能得到错误的日统计。用于报表的计算应覆盖约定区间,并明确缺测处理,不能直接把绘图采样结果当作完整统计依据。

IndustrialSphere提供两种实施入口:采用BI已有的EdgeHub历史趋势绑定,或由自己的应用调用历史接口。前者适合先完成平台内展示,后者便于把曲线嵌入已有业务流程;两种方式都需要确认数据覆盖范围与统计口径。

用几种可解释的数据检查页面

建议在测试环境分别检查数值上升、数值稳定、通讯异常、没有历史和返回截断。核对图表左右端时间、单位、断点及提示是否符合预期。

一条可用的工业趋势,应该帮助读者判断实际发生了什么,也清楚表达哪些时间没有足够依据。

延伸阅读与交流

上一篇:通过API读取实时数据;下一篇:从写入请求到回读确认。BI介绍说明现成的趋势与报表能力。

可以把上面的三条样例放进自己的绘图逻辑,观察时间顺序、断点和空值处理,再核对一次截断提示。欢迎带上脱敏后的返回数据和页面表现,到IndustrialSphere技术交流群(QQ群:1128988613)交流趋势页面的实现。

继续解决相关问题

posted @ 2026-11-16 23:11  IndustrialSphere  阅读(0)  评论(0)    收藏  举报