Appearance
常见问题与排查
排查前记录组织、项目、设备、点位和发生时间。截图或提供日志时隐藏密码、安全码与完整令牌。
设备添加失败
核对设备 ID、安全码及目标组织。已经绑定的设备需要由有归属管理权限的所有者处理,不能仅通过重新创建同名项目解决。
设备离线或数据不更新
依次检查供电、网络、SIM 卡状态、天线和最近连接时间。设备在列表中存在,只说明已绑定;最近连接时间不表示当前仍在线。
设备在线但点位没有数据时,再检查点位是否启用、串口参数、从站 ID、功能码、地址和数据索引。排查步骤见 Modbus 配置参考。
数值明显不对
| 现象 | 检查项 |
|---|---|
| 相差 10 倍或 100 倍 | 数据比例、单位 |
| 整体偏移 | 数据偏移 |
| 负值或极大值 | 有符号格式、字节序、索引 |
| 多个通道值错位 | 起始地址、寄存器长度及索引 |
先与传感器本地读数或参考仪表对照,再修改参数。不要放宽阈值来掩盖错误读数。
实时有值,历史没有记录
检查查询时间和项目时区、点位创建时间、调试模式及历史存储。实时与历史来自不同保存链路,实时值更新不能证明历史记录已写入。
GPS 没有轨迹
检查该点位是否上报了有效经纬度,所选范围内是否有定位记录,地图是否正常加载。新建 GPS 类型的点位不会自动产生定位数据。
不能修改配置或控制设备
检查用户角色与项目访问权限以及设备是否支持对应功能。开启开放访问的项目只提供只读查看,不授予控制权限。
控制命令已发送,但设备没有动作
核对目标点位、命令记录、设备在线情况和状态回报,再检查现场接线、执行器、互锁和限位。超时后先查状态,不要连续重复发送。结果含义见控制设备。
定时或联动没有执行
- 查看定时器或规则是否启用,目标点位是否仍存在及兼容。
- 定时器:检查项目时间、触发方式和活动窗口。
- 联动规则:检查条件是否满足、数据是否继续上报、健康状态是否异常。
- 打开执行记录,区分失败、冷却期跳过和目标状态已满足等情况。
告警一直未恢复
检查新上报数据是否满足恢复条件。没有新数据、数据过期或设备离线时,不能据此认定已经恢复。标记已知晓只表示人员已看到告警,详见告警状态。
读数刚越界但未出现告警时,检查后续上报。触发和恢复都要求条件在有效上报中持续至少 30 秒,一次短暂变化不会立即改变告警状态。
有站内通知,但没有邮件或短信
检查邮件与短信通知是否启用、接收地址和类型是否匹配,以及投递结果。测试发送和业务消息分别验证;外部发送恢复后不会补发暂停期间的消息。
导出失败或文件为空
失败时查看任务错误提示,缩小时间跨度或减少点位;已完成但没有数据时,检查时间范围和历史记录。文件过期后不能继续使用原下载入口,详见数据导出。
目标系统收不到分发数据
先核对配置启用状态以及是否有新上报,再检查目标地址、认证和目标系统日志。MongoDB 同时检查以组织标识命名的集合;InfluxDB 检查 Measurement 与时间范围。各通道步骤见数据分发。
API 未授权或找不到资源
401 检查认证和有效期,403 检查角色、范围及资源访问条件,404 核对路径、数值主键和内部标识。先使用只读请求验证,参阅开放 API。
