创建北向应用
南向插件用于连接南向设备实现数据采集,北向插件用于连接到IOT平台或边缘流处理引擎。北向插件和南向插件组合使用实现数据采集和数据传递。
Neuron 目前支持以下北向节点:
- MQTT:MQTT 插件允许用户快速构建使用 MQTT 协议的物联网应用程序,可以在设备和云之间进行通讯。
- eKuiper:LF Edge eKuiper 是轻量级物联网数据分析和流处理引擎,eKuiper 插件使用户能够将收集到的数据转发到 eKuiper 以进一步处理。
- SparkPlugB:Sparkplug B 是一种建立在 MQTT 3.1.1 基础上的工业物联网数据传输规范。Sparkplug B 插件从设备采集到的数据可以通过 Sparkplug B 协议从边缘端传输到 Sparkplug B 应用中,用户也可以从 Sparkplug B 应用程序向 Neuron 发送指令修改设备数据。
- WebSocket:WebSocket 网络协议支持在单个 TCP 连接上提供双向通信通道。借助 WebSocket 插件,用户可以将采集的数据推送到 WebSocket 服务器。
- Monitor:Neuron 在启动时创建一个 Monitor 单例节点,用于监控Neuron的运行状态。您可以在仪表板的北向应用页签中看到 Monitor 节点。
本节将以 MQTT 插件为例,演示完整的北向应用添加流程以及如何订阅南向数据组。
添加北向应用
创建北向 MQTT 节点,连接并将点位数值上传到 MQTT Broker。
在配置 -> 北向应用,点击 添加应用 添加 MQTT 客户端节点:
- 名称:此应用节点名称,例如,mqtt;
- 插件:选择 MQTT 插件。
点击创建后,将跳转至应用配置页面,我们将在这里配置 Neuron 与北向应用建立连接所需的参数。您也可点击设备卡片上的设备配置图标进入应用配置界面。
设置北向应用参数
点击应用卡片上的 应用配置 按键进入应用配置界面设置 MQTT 连接,有关 MQTT 插件的配置项,可以查看 MQTT 页面。
点击提交,完成北向应用的配置,应用卡片自动进入 运行中 的工作状态。
设备卡片
在北向应用页,在右上角可以选择列表或卡片展示北向应用,这里将以设备卡片为例介绍其中各选项的含义。
- 名称:用户为北向应用提供的唯一名称。
- 应用配置:点击该按钮进入配置界面,用于设置 Neuron 连接北向应用所需的参数。
- 编辑:在希望更改名称的目标节点,点击编辑图标,在弹出的编辑设备对话框,修改节点名称。
- 数据统计:统计节点卡片信息。
- DEBUG 日志:打印当前节点的 DEBUG 级别日志,十分钟后,Neuron 将恢复打印默认级别日志。
- 删除:从设备列表中删除该节点。
- 工作状态:显示设备节点的当前状态,目前节点分为五种工作状态。
- 初始化:首次添加北向应用后,将进入初始化状态。
- 配置中:进入设备配置,并进入配置状态。
- 就绪:配置成功后,进入就绪状态。
- 运行中:运行设备卡片。
- 停止:停止设备卡片。
- 工作状态切换按钮:是否打开与设备的连接。
- 打开:Neuron与设备/应用建立连接,开始收集数据。
- 关闭:断开设备连接,停止收集数据。
- 连接状态:显示设备的连接状态。
- 插件:用于显示该设备使用的插件模块的名称。
订阅南向数据
采集点位是以组为单位进行数据上传的,订阅选择要上传的点位组。
点击 MQTT 节点卡片,进入组列表页,点击 添加订阅 选择要订阅的点位组,订阅南向设备的点位组。
- 南向设备:选择要订阅的南向设备,例如,modbus-tcp-1;
- 组:选择南向设备下的某个组,例如,group-1。
运行与维护
数据统计
在设备卡片或设备列,您可点击数据统计图表查看及应用运行情况、接受和发送的数据情况
其中关键字段说明如下:
参数 | 说明 |
---|---|
send_msgs_total | 发送消息总条数 |
send_msg_errors_total | 消息发送失败的总条数 |
recv_msgs_total | 接收消息的总条数 |
link_state | 节点连接状态 DISCONNECTED = 0 CONNECTED = 1 |
running_state | 节点状态 INIT = 1 READY = 2 RUNNING = 3 STOPPED = 4 |
故障诊断
如果设备运行出现任何问题,您可点击 DEBUG 日志图表,此时系统将自动打印该节点的 DEBUG 级别日志,十分钟后将切回系统默认级别日志。稍后,您可点击页面顶部功能栏的系统信息 -> 日志查看日志,并进行故障诊断。有关系统日志的详细解析,见管理日志。