我是数采实施商

驱动视图

整体展示结构为：驱动-连接-设备-点位。

左侧为驱动-连接列表，驱动即数采协议包，如下图所示，左侧驱动列表包括bacnet、device_simulator、iec61850、modbus，驱动下可以通过导入点表添加多条连接，如下图所示modbus驱动下有CON57、CON58等连接。

左侧窗口选中驱动，可以查看各条连接状态、连接/断连时间，数采点个数、属性点个数和进度，点击详情，可以查看连接配置。

数采点，指从PLC或DCS中直接采集到的原始变量，原始变量经过bit拆分、json提取得到属性点。如一个DWORD数采点拆分得到多个属性点。 进度条，驱动、连接、设备都有各自维度的属性点进度统计。

进度=100%，代表从连接建立开始，下面所有的属性点都正常上报过。

进度<100%，代表截止目前有属性点未上报过，需要排查连接配置、设备配置、数采地址配置、加工公式配置是否正确。 左侧窗口选中驱动下的某条连接，可以在右侧窗口看到该连接下的设备列表、各设备接入进度，点击详情可以查看设备配置。双击某一行或点击查看属性点可以进入设备下的属性点列表。

属性点列表，可以看到某个设备下各属性点实时值、质量码、时间戳，其中质量码0代表正常，0xC0（192）代表连接已断开（此时展示的实时值为系统缓存值），有写权限的属性点位会有写入按钮。 属性点有3个状态，如下

双击某一行或点击查看详情可以进入属性点详情页面。

属性点详情，基础信息包括驱动-连接-设备-数采点-公式转换-属性点状态，便于异常问题定位。

数采点，指从PLC或DCS中直接采集到的原始变量，原始变量经过bit拆分、json提取得到属性点。如一个DWORD数采点拆分得到多个属性点。数采点和属性点都有唯一的标识符ID。

历史数据，支持表格、图表2种展示方式。表格方式更准确，图表方式适合看趋势。图表展示时，会根据时间范围做间隔采样，即降采样，采样方法为在固定的时间间隔内抽取数据，有数据则展示，无数据不展示（未采取平均值、最大值、最小值等补值手段）。

设备视图

支持按连接编码、模板名称或编码、设备名称或编码、设备数采状态、属性名称或编码组合搜索，模糊搜索。其中模板名称或编码、设备名称或编码是必选，其他可选。

模板管理

相同的设备配置可以复用一套模板，参考下文的模板表excel说明。 模板搜索：支持按模板名称、模板编码搜索，模糊搜索。更新时间：模板表有修改，重新导入后，更新时间会变化。更新时间支持时间排序。

单个模板有2种视图，属性视图和采集视图。属性视图中属性按照属性组名称归类。

下图为OPC UA协议的采集视图（通过OPC UA扫描导入）。

excel点表介绍

以一个例子来展开说明3张表的差异，假设工厂中通过PLC接入了 10个电机、1个机械臂，且10个电机在PLC协议地址空间中是对称的，则可以创建1张电机模板表，1张电机设备表，1张机械臂设备表，1张机械臂设备点位表。如果PLC连接协议一样，变频器设备表和机械臂设备表也可以合2为1。

模板表详细说明

电机的模板表（技术属性模板表）如下（以OPC DA协议为例）：

蓝色列代表IT信息（属性编码、属性名称、存储类型、单位、取值范围等），*代表必选，其他字段选填。

绿色列代表OT信息（数采地址、数采加工公式）。 灰色列代表分隔符，没有实际意义。

提示：模板表的绿色列字段跟具体的协议强相关，如OPC DA的绿色列有ItemID、ValueType、IsWritable列，MODBUS的绿色列有寄存器偏移地址，OPC UA的绿色列有nodeid偏移地址等等。

整个表格传递的信息是IT属性 = 数据转换公式Expression + OT点。

表头包含如下信息

提示：模板表支持添加多张excel sheet页，每张sheet页代表一张新的模板。

每列字段含义如下

设备表详细说明

设备配置表，包含10台电机的链接信息，样例如下

蓝色列代表IT信息，如设备名称、模板编码。

绿色列代表OT信息，如数采连接地址、数采采样频率等，具体请参考对应的协议接入说明。 灰色列作为分隔符列，没有实际含义。 资产模板编码列代表设备引用了哪个模板，可以为空，为空代表设备的点位配置由点位表记录。

设备配置表可以添加多个设备，多个PLC，多套DCS的连接。

点位表详细说明

点位表主要用于散点设备的接入，散点设备指设备点位地址无规律、无法使用模板表，此时可以使用设备表 + 点位表完成数采实施。点位表和模板表的差异点，在于OT地址列是完整的。

前面的例子中，点位表的样例如下：

MODBUS点位接入流程

该章节包含以下内容

模板表配置说明

表格下载：控制台->采集->模板管理->导入模板->驱动名称选中"modbus"->点击下载。

绿色列代表驱动配置：

驱动程序采用MODBUS寻址，功能码+寄存器地址（0~65535），其他寻址模式需要进行转化。

指从设备中读取的数据格式，同时驱动程序通过相应的数据类型来告知读取一个、两个、四个或八个寄存器或者可能的布尔值；

1）BOOL（布尔型）

2）INT16（16位有符号整型）

3）UINT16（16位无符号整型）

4）INT32（32位有符号整型）

5）UINT32（32位无符号整型）

6）INT64（64位有符号整型）

7）UINT64（64位无符号整型）

8）DOUBLE（双精度浮点型）

9）FLOAT（单精度浮点型）

1）0x01（读线圈寄存器）

2）0x02（读离散输入寄存器）

3）0x03（读保持寄存器）

4）0x04（读输入寄存器）

1）0x05（写单个线圈寄存器）

2）0x06（写单个保持寄存器）

3）0x0F（写多个线圈寄存器）

4）0x10（写多个保持寄存器）

是否允许驱动程序将其和与其相邻的点位进行合并读取。

是否交换保持/输入寄存器内的字节顺序。

是否交换多个保持/输入寄存器之间的顺序。

缩放原始数据，目前支持“线性”缩放.

设备表配置说明

绿色列代表跟数采相关的配置。 连接配置：

MODBUS-TCP通讯的服务器的以太网IP地址。

MODBUS-TCP通讯默认端口为502。

设备配置：

设备在MODBUS-TCP通讯的服务器上的从站地址。

点位读取周期，单位ms。

点位读取超时，单位ms。

同模板表。

操作路径：模板管理->导入模板->选择对应的数采驱动->上传文件。

提示：

操作路径：点表配置->驱动视图->选择对应驱动->导入点表->设备表->上传文件。

提示：

点击部署，让以上点表配置生效，该过程需要几分钟。

提示：启用主备配置后，会多一个主备部署的按钮，主备部署可以让点表配置、告警配置等工程配置信息同步一份到另一台主机。建议定期做主备配置同步，以免两台机器配置不一致，造成使用上的混乱。

常见问题FAQ

OPC DA点位接入流程

OPC DA常用于散点设备的接入，散点设备的接入使用设备表 + 点位表。

1）模板表配置说明

2）设备表配置说明

3）点位表配置说明

4）导入模板表

操作路径：数采 -> 模板管理 -> 导入模板 -> 选择opcda驱动 ->上传文件。

5）导入设备表

操作路径：数采 -> 点表配置 -> 驱动视图 -> 选择opcda驱动 -> 导入点表 -> 设备配置表 ->上传文件。

6）资源部署

点击部署，让以上点表配置生效，该过程需要几分钟。

三色灯异常诊断

连接状态

连接状态包含连接、异常。

属性点三色灯

针对异常的点位，数采一体机提供诊断功能，用来快速排查问题。

各阶段异常的原因：

状态灯是根据点位上报情况推导出来的，不强依赖驱动上报的连接状态、设备状态虚拟点位。

Q. 和驱动上报的虚拟点位之间的关系？

连接成功、设备上线的虚拟点位上报不会影响状态灯。

连接断开的虚拟点位上报，会重置该连接及其下的设备、点位的状态，变红。

设备下线的虚拟点位上报，会重置该设备及其下的点位的状态，变红。

Q. 和部署之间的关系？

部署会重连修改过的连接，会重置该连接及其下的设备、点位的状态，导致相关状态都变红。

Q. 和点位质量码之间的关系？

点位质量码为零，认为该点位正常，显示绿色。

点位质量码为非零，认为该点位异常，显示红色。

告警模板

典型场景：大量I/O数字量需要批量配置告警信息

操作路径：告警模板 -> 新建模板 -> 填写模板信息 -> 在excel模板表或点位表填写告警模板编码

步骤一：创建告警模板

步骤二：操作路径1：采集->模板管理->选择对应的模板->查看->属性视图->选择属性->编辑->选择告警模板->保存，然后部署。

操作路径2：在excel点表（模板表或点位表）中填充告警模板编码，并在控制台重新导入excel模板表，然后部署。

步骤3：资源部署 -> 本机部署

步骤4：查看告警事件

未解除：指进行中的告警（告警条件被触发，且当前仍满足触发条件）已解除：指已消除的告警（告警条件曾被触发，当前触发条件不满足）

告警确认：运维人员通过手动确认告警，来保障整个自动化系统的正常运行。 告警搜索：支持通过时间窗口、设备资产编码来搜索过滤告警。

常见问题

Q. 新建或修改告警模板后是否需要部署？

不需要部署，保存即生效。

Q. 如何配置或恢复两台机器之间的告警数据同步？

一、清理原有数据库
1、docker stop postgres12
2、docker rm postgres12
3、rm -rf /datafactory_data/postgres 

二、下载新的pg安装文件：
wget http://xxx/postgres12_install_file.tar.gz

三、重新走一遍双机postgres的安装流程
sudo mkdir -p /datafactory_data/postgres/
sudo ./install_PG.sh /datafactory_data/postgres/
sudo ./config_PG_step1.sh
# 在LE1上执行
sudo ./config_PG_step2.sh ${LE2_IP} 5432
# 在LE2上执行
sudo ./config_PG_step2.sh ${LE1_IP} 5432

阿里云IoT

一体机内部和阿里云IoT平台有2条通道，一条为管控通道，一条为数据通道。

管控通道：对应一个管控通道三元组，管控通道用于云端下发各种参数配置。 数据通道：对应N个数据通道三元组，数据通道用于一体机上报数据。由于上云数据通常较大，物联网平台单条连接流量上限约1MB/s，可以在一体机上配置起N条链接，N条链接对应N个三元组。配置方法见后续说明。数据通道对应物联网平台的虚拟网方案（子设备数据可以选择任意一条通道上云），同时配合物联网连接型实例，一体机做了数据聚合、压缩优化。因此配置时重点关注以下几点

配置步骤如下

控制通道配置

在物模型映射，查看数字工厂对应的物联网平台LP（Link Platform）对应的接入地址。

提示： 1. 域名后面需要拼接端口，端口固定为1883。如：iot-xxxxoktpaa.mqtt.iothub.aliyuncs.com:1883。 2. 物联网平台需要区分连接型实例和普通实例！两者在一体机中的配置不同，前者需要开启数据压缩选项，支持更大并发，后者不支持压缩。

对接物联网平台：使能开关，在开关打开后数采一体机开始尝试和阿里云物联网平台进行连接。

ProductKey：产品名称，在阿里云物联网平台上进行产品创建时生成。

DeviceName：设备名称，在阿里云物联网平台上进行设备创建时生成。

deviceSecret：设备密钥，阿里云物联网平台上进行设备创建时生成。

物联网平台接入地址：阿里云物联网平台接入地址，对应实例的连接地址。

设备过滤规则：对应上元数据转发的OT数据的过滤规则，参考下文中的过滤规则集说明。

数据通道配置

操作路径：登录物联网平台，选择对应的企业实例，任意一个创建产品和设备，保存设备三元组。

和控制通道不同，阿里云Iot数据通道配置通过现场施工时进行后台修改配置文件完成，对应配置文件路径如下：

vim /linkedge/gateway/build/config/data_cloudproxy/data_proxy_client.json

配置文件中包含数据上云的N个三元组信息，需要上云的数据流量事先进行规划。

下文以3对三元组为例，进行配置说明。

{
  "identityInform":[
  {
    "ProductKey": "g4kneyYU5SY",
    "DeviceName": "IndustryDeviceAsset230_111",
    "DeviceSecret": "xxxxxx"
  },
  {
    "ProductKey": "g4kneyYU5SY",
    "DeviceName": "IndustryDeviceAsset230_222",
    "DeviceSecret": "xxxxxxx"
  },
  {
    "ProductKey": "g4kneyYU5SY",
    "DeviceName": "IndustryDeviceAsset230_333",
    "DeviceSecret": "xxxxxxxxx"
  }]
}

消息队列kafka

作为南向接入设备，数采一体机在支持采集的设备数据上行转发到公有云场景的同时，也存在支持将采集的设备数据转发到三方数据中台的场景。消息队列kafka功能提供了的数采一体连接三方数据中台kafka_server的相关配置能力，当进行对应连接信息的录入后，数采一体机能够实现和三方数据中台kafka_server的远程连接和南向工业数据采集后的转发能力。

工作原理

数采一体机连接三方数据中台kafka_server进行上行数据转发的工作原理类似于kafka的标准生产者（producer）的流程，主要包括：

数采一体机作为kafka_client和指定的kafka_server建立连接，对应kafka_server的连接信息来自界面配置，主要包括：broker连接地址、sasl鉴权信息（用户名/密码）、cert证书（安全连接）等。

数据一体机作为数据的生产者（producer）向kafka_broker的指定topic转发数据，当前主要支持设备数据和告警数据的数据转发，需要在界面指定broker映射的不同topic。

配置说明

对于消息队列kafka的转发配置，在数采一体机上提供了可视化界面，对应侧边栏：数据转发--->kafka转发。

kafka转发的配置信息默认只读，需要点击“编辑”按钮进行编辑操作。

是否开启：kafka转发的使能开关，在开关打开后数采一体机开始尝试和三方数据中台的kafka_broker进行连接。

broker地址：三方数据中台的broker地址，支持通过“;”符号连接多个，地址组成包括：ip地址（域名） + port端口号。

设备数据Topic：三方数据中台作为kafka_broker提供的设备上报属性数据的topic，需要在kafka_broker侧进行规划和配置。

告警数据Topic：三方数据中台作为kafka_broker提供的上报告警数据的topic，需要在kafka_broker侧进行规划和配置。

启用SASL鉴权：连接kafka_broker鉴权开关，在kafka_broker连接需要开启时打开。

SASL鉴权信息：对应kafka_broker连接时输入正确的鉴权信息，包括用户名/密码。

kafka证书：对应kafka_broker需要证书认证时进行上传，默认支持一个证书，后面上传会覆盖前面上传的证书。

设备过滤规则：对应kafka转发的OT数据的过滤规则，参考下文中的过滤规则集说明。

常见问题

Q. kafka_broker多个地址的录入

本地控制台支持多个kafka_broker地址的输入，在kafka_broker在集群模式下需要多地址录入的场景下，可以在本地控制台上通过“;”进行不同地址间的隔离。

过滤规则集

考虑作为生产制造过程中产生的OT数据并非都是北向设备需要的，因此需要在数采一体机设备数据上云转发前实现报文按照一定维度的过滤，以此提升带宽利用率。数据一体机当前提供了按照设备维度的上报属性数据的过滤能力，并支持为重复数据设置过滤时间窗，以满足提高上行数据有效性的诉求。

工作原理

数采一体机的过滤规则主要支持三种类型：

数据一体机的过滤规则集支持创建多个，用户可以根据需求创建多条不同类型和指定多个设备的过滤规则。但过滤规则的生效需要通过和对应的上云连接进行绑定，为了防止规则间的冲突，一个上云连接只支持绑定一条规则，当前支持的绑定模式包括mqtt（阿里云物联网平台）和kafka（三方数据中台）。

过滤规则除了支持按照设备维度进行属性过滤外，还支持设备属性在时间维度上的时间窗过滤，通过时间窗设置：对于在周期时间内（从收到报文开始进行技术）属性值相同的设备属性上报认为是重复数据，在上报前进行过滤处理。

配置说明

对于过滤规则集的添加、编辑和删除，数采一体机提供了可视化界面，对应侧边栏：数据转发--->过滤规则集

通过过滤规则集界面上“新建规则”按钮创建规则，输入规则编码、规则类型、去重间隔（去重时间窗）、选中设备等信息创建过滤规则。其中规则类型分为三种，全量同步规则不需要选设备。

在规则创建后，可以通过过滤规则集界面中选中规则进行编辑和删除操作，控制台还提供了批量删除功能方便删除的批量操作。

在规则创建后，通过在上云链路对应界面中进行绑定生效。当前支持mqtt（阿里云物联网平台）和kafka（三方数据中台）两种上云方式，分别对应数据转发菜单中“阿里云IoT”和“kafka转发”配置中的“设备过滤规则”的选项配置。

常见问题

Q. 配置过滤规则集并绑定到kafka转发后，告警转发没有进行过滤生效

过滤规则当前只对设备属性数据进行过滤，对告警数据不进行过滤，过滤规则对于告警的转发无效。

Q. 修改绑定到kafka转发或者阿里云IoT的过滤规则，发现存在设置的时间窗内相同属性值的设备属性重复上报

过滤规则支持热加载，在用户修改已绑定到上元转发的规则立即生效。但在规则生效后对已有设备属性的时间窗信息会重新加载，已有时间窗内的数据会被重置。

Q. 界面配置了多条过滤规则（白名单）方式，但无法进行多个规则绑定到同一条转发链路

数据转发设置多条过滤规则意味着计算的冗余和性能的下降，当前转发链路只支持绑定一条设备过滤规则，需要将相同维度过滤放到一条过滤规则中。

主备配置

工作原理

资产一体机使用VRRP协议来实现两台主机之间的状态同步、主机选举；备机上的数采驱动、规则告警、数据转发服务处于热备状态。

配置说明

是否开启：控制是否启用主备功能。

本机地址：填写本机的局域网IP地址，和对端主机处于同一网络。

对端地址：规则同“本机地址”，填写互为主备的另一台网关/服务器。

配置密钥：同控制台的账户/密码，用于访问主/备机服务的。

主备调试：调试开关，关闭后意味着本机禁止参与主备抢占，此时对端会进入主机状态（mater）。

状态：当前主备工作状态，一共4个状态：主机、备机、异常、禁用。

主备策略：支持两种策略。

提示：“XX 优先”模式下，XX发生异常会切换为备机（backup），异常消失后会再切换为主机（master）。

浮动虚拟IP：主备服务器器统一对外提供服务的IP，该IP会跟随着主机；配置主备功能后，建议后续使用该IP来访问控制台，以及MQTT和HTTP openAPI。

常见问题

Q. 两节点同时为“主机”

查看防火墙

sudo systemctl status firewalld.service

系统监控

一体机自带系统运行指标监控，对关键数据指标进行采集，进行可视化展示，并且可以配置规则，推送告警事件。

操作路径：系统监控 -> 搜索并输入"overview" -> 打开系统监控overview画面

Overview监控大盘

Overview看板展示了系统运行的核心指标，运维工程师需要重点关注Overview看板。

图表指标说明

数据流转延时计算流程，见下图。

如上图所示，红色图标表示告警产生，绿色图标表示告警恢复

异常日志

可以查看系统各模块产生异常日志的速率，当模块异常日志输出异常时，进入的边缘一体机后台/linkedge/run/logger目录下查看模块的异常日志。

NetPing

cd /linkedge/gateway/build/bin/
./tool_config -s system_metric_netprobe_list '["x.x.x.x","y.y.y.y"]'
sudo killall -9 edge_metric