时序数据接入

鉴权流程图

X-Collector需要supOS平台提供的UUID才可以接入supOS平台，下图为X-Collector软件接入supOS平台流程示意图。

接入supOS操作步骤

新增鉴权

步骤1：在supOS端，【设备节点管理/鉴权管理】页面下点击〔新增〕按钮新增鉴权；输入名称、负责人、公司地址、公司名称、描述，点击〔生成〕按钮自动生成UUID，类型选择“时序数据采集器”，选择时间戳类型（上送数据使用supOS平台服务器的时间或采集器服务器的时间），选择是否开启supOS和采集器之间的通讯加密，点击〔确认〕。

步骤2：查看鉴权状态为“待接入”。

连接配置

步骤1：在采集器软件端，选择菜单【时序数据采集管理/连接配置】。

步骤2：新增supOS连接。一个采集器支持连接1-5套supOS平台进行数据上送。默认有一个连接配置。点击左侧连接配置下的〔新增〕按钮可新增supOS，单击删除已配置的supOS连接，只有一个supOS连接时不允许删除。

步骤3：选择一个supOS平台，配置supOS服务器信息。

提示：默认连接里的supOS服务器地址为127.0.0.1，数据上送方式TCP，请根据实际情况修改。

• supOS服务器地址

  • supOS单机部署时，填写supOS服务器IP地址。

  • supOS集群部署时，仅支持TCP协议通信。采集器与supOS之间的通信IP可设置为集群中多个节点服务器的IP地址。点击〔+〕添加服务器节点，最多可添加5个。优先填写k8s workermain和k8s worker节点服务器的IP地址。

• 数据上送方式为TCP或UDP，选择“TCP”时通信端口为32568；选择“UDP”时通信端口为32569。

步骤4：配置鉴权节点信息。输入鉴权节点名称、输入supOS端生成的UUID。

提示：默认连接的鉴权节点名称、UUID标识和描述请根据实际情况修改。

• 鉴权节点名称：与supOS鉴权管理名称一致且区分大小写。输入鉴权节点名称后连接配置名称同步修改。
• UUID标识：与supOS侧生成的UUID标识一致。

步骤5：配置全局读写状态。采集器全局提供读写、只读配置，默认只读。对不同的supOS平台可以单独做读写配置。

• 冗余设置：若采集器需要冗余配置，开启此选项，输入冗余组ID及冗余编号。

• 冗余组ID：两台采集器的冗余组ID必须相同。
• 冗余编号：两台采集器的冗余编号要保证唯一性，一个为A，另一个必须为B。

步骤6：配置断点续传：支持网络断线期间的历史数据回补，开启断点续传，输入缓存保存路径，开启断点续传后缓存数据自动保存在该路径下。采集器安装完成后断点续传默认打开，需要配置缓存保存路径。数据上送方式为UDP时，不支持断点续传。

提示：1、上送不同supOS平台时，缓存保存路径不允许重复。2、注意缓存路径磁盘大小，以1w点秒变数据为例，断点续传1天所需磁盘为7GB。

步骤6：配置通讯加密：supOS与采集器之间的数据传输支持加密以保证信息传输安全。

• supOS侧：新建鉴权时，打开通讯加密开关，显示密钥输入框和操作按钮。开启，自动生成密钥，也可点击〔生成〕按钮重新生成。点击〔复制〕按钮复制密钥。

  

• X-Collector侧：打开通讯加密开关，显示密钥输入框，将supOS生成的密钥完整拷贝至输入框。

  

提示：在设置加密功能开关及修改密钥时, 建议先修改supOS平台端的加密配置，再修改采集器的加密配置，以此保持数据的连续性。加密配置的修改在采集器修改后生效。

步骤8：点击〔保存〕按钮，弹出“操作成功”对话框。

完成接入

步骤1：在supOS端，【设备节点管理/状态管理】页面，查看状态为“待审核”。点击操作栏的〔同意〕按钮，同意采集器接入。

提示：该对象实例下自动生成采集器状态的属性online，数值类型为bool型，若状态为true时表示采集器/源点在线，状态为false时表示采集器离线，可在对象选择器下选择该属性来查看采集器的状态。工程师可以将采集器状态通过APP页面组态链接online属性，展示给用户查看。

步骤2：在采集器软件端连接状态显示“登录成功”。

步骤3：在supOS端【设备节点管理/鉴权管理】中状态显示“已审核”，鉴权完成。

提示：接入状态说明：

• 待接入：灰色，表示该UUID还未被使用。
• 待审核：橙色，表示有采集器正在用该UUID发起接入申请。
• 待替换：红色，表示同一采集器更换鉴权重新接入，待被替换。
• 已拒绝：红色，表示supOS已拒绝采集器接入。
• 已审核：绿色，表示已有采集器通过该UUID接入。

步骤4：在supOS【设备节点管理/状态管理】下点击采集器行操作栏中的查看按钮，选择“源点状态”页签，可以查看采集器源点状态。

采集器接入更换

在进行采集器或UUID替换时，采集器名称需使用原名称，之前已绑定的属性才能进行关联，更换采集器名称会导致已绑定属性找不到数据源报错。

UUID更换

采集器替换UUID步骤如下：

步骤1：在supOS上用新的名称申请新的UUID。

步骤2：在采集器上用新的名称和新的UUID申请接入supOS。

步骤3：在supOS上同意新名称和UUID的替换接入。

采集器更换

给采集器替换电脑的步骤如下：

步骤1：在新电脑的采集器端用原先的名称和UUID申请接入supOS。

步骤2：在supOS上同意原名称和UUID的新设备替换接入。

数据调用

在supOS【对象模型管理】菜单下，在“对象实例/物模板/采集器模板”下自动新增一个对象实例，名称与新增鉴权名称一致，连接的位号均在该实例下。

提示：请在【用户安全管理】中进入用户或角色权限分配页面，在“数据分组”页签下，查看用户的数据权限，确保用户获取了相应对象实例属性数据的权限、属性报警的权限，在运行期APP页面仅显示用户有权限的对应属性数据。