平台配置

平台配置用于集中管理物联网平台运行期的开关、性能阈值、数据保留期等参数。改动保存后立即生效,无需重启

img.png

页面入口:平台配置

使用说明
1、所有配置项都不允许删除,但可以单项或整组重置为默认值。
2、改动后右下角会显示「未保存」角标,点 保存全部改动 提交。
3、首次进入页面就能看到全部配置项,已有改动会被保留。

配置项总览

设备自注册

配置项默认作用
设备自注册关闭控制未注册的设备首次接入时是否自动建档。开启:陌生 SN 上报数据后自动创建设备并继承产品的物模型 / 告警规则 / 指令;关闭:陌生 SN 的数据被直接丢弃。
使用建议
1、生产环境建议关闭,避免恶意上报或调试设备污染平台。
2、测试 / 联调阶段可临时开启,省去逐台手工建档的成本。

批量入库

平台对 4 种高频写库场景都支持异步批处理:先在内存里聚批,攒够数量再统一写库,能显著提升整体吞吐。需要注意——极端崩溃时还没写库的那一批数据会丢失,对完整性敏感的业务请谨慎开启。

每组 3 个配置项:

配置项作用
启用批量入库是否启用
批次大小每次集中写库的条数;建议 200 ~ 1000
队列容量内存中最多堆积的条数;满了之后新到的数据会被直接丢弃
4 组对照
适用场景默认 批次 / 队列
设备日志 · 批量入库设备实时数据上报500 / 10000
指令下发 · 批量入库指令下发记录200 / 5000
告警记录 · 批量入库设备告警200 / 5000
联动告警 · 批量入库联动规则触发记录100 / 2000
使用建议
1、低吞吐场景(百级设备)保持关闭即可,单条同步入库延迟更可控。
2、高吞吐场景(千级 / 万级设备)按顺序:先开 设备日志,观察一段时间数据库负载,再视情况开其它三类。
3、批次大小增大可提升吞吐但写入延迟也会增加;队列容量建议至少是 批次大小 的 5 倍以上,给流量尖峰留缓冲。
4、批量入库与 TDengine 兼容,开启对应类型后批处理依然正常工作。

数据保留期

针对历史时序数据的自动清理策略。每天凌晨 02:00 触发一次,删除超过保留天数的旧记录。默认全部关闭,开启后才会实际清理。

每组 2 个配置项:

配置项作用
启用自动清理是否启用
保留天数仅保留最近 N 天的数据,更早的会被删除
4 组对照
清理对象默认天数
设备日志 · 保留期设备实时上报数据30
指令下发 · 保留期指令下发记录30
告警记录 · 保留期设备告警90
联动告警 · 保留期联动规则触发记录90
使用建议
1、开启前先评估业务对历史数据的查询需求。告警 / 联动告警一般需要留存更久(半年起),设备日志数据量最大可以激进清理。
2、若启用了 TDengine,对应类型的保留期请直接在 TDengine 侧配置,本页面的开关对其无效。
3、清理任务在凌晨 02:00 执行,单次大批量删除可能耗时较长。首次开启建议把 保留天数 设大一些(如 365)让数据分阶段清理,避免一次性删除几亿行造成数据库卡顿。
4、单设备级的"数据定期删除"配置已下线,统一改用本页面的保留期策略管理。

常见问答

Q:保存配置后多久生效?
10 秒内自动生效。批量入库类配置变更会自动重启对应的处理器,无需重启服务。
Q:误改了一组配置怎么办?
每组卡片右上角有 重置本组默认值,每项右侧也有单独的 重置 按钮。
Q:可以新增自定义配置项吗?
不可以。配置项由平台统一定义,UI 不开放新增 / 删除入口,如需扩展请联系开发同学随版本发布。