ThinkLink 实践 / 现场与运维
ThinkLink 历史曲线断档怎么办:从上报证据到存储范围
按设备、物模型和时间窗口核对原始上报、解析值与历史存储,区分没有采集、没有保存和查询条件不匹配。
先固定设备、模型和时间范围,再检查该时段是否有原始上报及解析结果。实时值存在不能证明历史完整,曲线没有点也不能直接证明现场停止采集。
先把缺口描述准确
不要只截取一张空曲线就开始改配置。记录设备 EUI、所选物模型、目标字段、开始结束时间和页面时区,并说明是全部字段缺失还是单个字段缺失。先切换表格查看原始记录,排除曲线字段没有勾选或数值类型不适合绘图的情况。建议先查缺口前后的一小段时间,再逐步扩大范围;官方文档建议单次查询不超过七天是性能建议,不代表统一保留期限,也不应被解读为平台只能保存七天数据。跨午夜的查询还应确认日期边界使用同一时区。
建立一条完整的样本证据
在缺口附近选择一条已知上报,比较其原始消息、模型解析和历史查询结果。LoRaWAN 可结合 NS 与 AS 记录,其他接入方式使用对应来源证据。若原始消息没有到达,应先查采集与传输;若有报文但目标模型没有输出,应查绑定与解析分支;若业务值正常而历史没有记录,再检查持久化设置和保留策略。某一层日志未被保留时,结论应是证据不足,不能把查不到旧日志写成从未上报。每个判断都标注所依据的时间窗口。
核对保存设置与字段变化
历史数据依赖持久化存储,不能从当前实时值的存在推断全部历史都曾保存。请通过正式管理界面或接口检查有关存储配置,并向管理员确认对应数据的保留策略。再检查缺口前后是否更换模型、改名字段或调整单位;旧记录可能仍在原模型和原字段下。清空实时值也不能单独证明历史已删除。若涉及累计表读数,还要保留换表、清零和单位变化记录,不能把这些变化直接作为能耗下降。查询与汇总应先保证字段语义一致。
区别修复与补齐
修正配置后,用新上报验证后续记录是否正常写入,并分别查看表格和曲线。过去缺失的数据只有在存在合法原始来源且支持正确导入的情况下才可能补齐,不能承诺重启服务就自动恢复。若业务要求估算,必须将估算值与原始测量明确区分,记录算法、区间和用途,不得把插值冒充设备上报。建议用测试设备验证一次“有实时值但不符合保存条件”的情形,让交付人员理解两个视图的关系,避免通过删除正式数据来做演示。
- 先用表格确认缺失区间。
- 追踪一条原始上报至历史记录。
- 核对模型变更和存储策略。
- 区分后续恢复、历史补齐与估算。
给报表留下可解释的边界
最后输出缺口区间、影响设备及字段、已确认原因、恢复起点和是否补齐。报表中可以显示有效记录数量与缺失说明,但不要因缺失而默认零值,也不要只计算剩余数据后声称整段时间完整。若采样频率发生变化,预期记录数需要按各阶段分别计算。交接给现场人员时,应列出需要恢复的采集链路;交接给平台管理员时,应附模型与存储证据。这样的划分让后续人员知道该修哪里,也让使用报表的人理解数字能支持什么结论。
常见问题
实时数据有值,历史就一定有记录吗?
不一定。历史依赖持久化与保留策略,应实际查询。
曲线断点可以用零补齐吗?
不能默认补零。缺失与真实零值含义不同,估算应明确标注。
参考资料与延伸阅读
本文依据以下官方资料编写。示意图用于解释方法,具体菜单、字段和能力以目标版本文档为准。