采集服务

适用版本：DASS5（当前版本）
前提：已登录 DASSConsole；目标设备已安装对应采集驱动（缺失可在【应用市场】在线下载）

【说明】：数据采集是 DASS 软件的核心功能之一，用来配置从现场采集、并上传到指定服务器或应用的数据。采集与上传代表数据的流入和流出盒子两个方向，两种服务的操作步骤基本一致。

【入口】：数据采集 → 采集服务

本页分三部分：

• 采集服务管理：服务的新建、查询、编辑、日志级别设置、删除、日志下载、历史回补、启停与重启
• 采集通道管理：通道的新增、导出、编辑、删除、克隆、挂起与启用
• 采集测点管理：通道下测点的查询、新建、删除、编辑、导入、导出、模板下载、清空与清洗

页面布局：左侧是服务树（上方按钮为【创建服务】）。在树中选中服务时，右侧上方出现服务级按钮；选中通道时，右侧出现通道级按钮与测点工具栏。服务下方有三个页签：通道信息、测点信息、实时日志。

功能概述

采集服务是 DASS 的南向采集主体：在 DASS 与现场设备（PLC / 仪表 / 传感器 / 第三方系统）之间建立通信，按驱动解析协议，把采集到的实时数据写入实时库（openPlant）。

一个采集服务 = 一个驱动应用 + 若干通道 + 通道下的测点：服务决定用什么协议、连到哪里；通道通常对应一台设备或一段总线；测点才是最终落到实时库的数据点。

核心价值：把现场异构协议统一成实时库中的标准测点，供上传服务、数据一览、计算服务复用。

使用场景

• 新建产线 / 设备，需要把 PLC 等现场数据采进 DASS；
• 已有服务要改通信参数、增删通道或测点；
• 采集异常需排障（看实时日志、调日志级别、做历史回补）。

前置条件

• 驱动已装：目标网关的「应用管理」里已有对应驱动（如 PLC_Siemens_S7_Ethernet、GB_Modbus_Poll_TCP），没有请先从应用市场下载并离线导入；
• 网关可达：连接处于在线状态；
• 授权余量：服务数、点数均未超限（见「用户必读 → 权限模型」）；
• 命名约束：服务名 ≤ 11 字节且全局唯一；通道名 ≤ 12 字符（字母 / 数字 / 下划线）；点名 ≤ 60 字节；
• 知道通信参数：IP / 端口 / 协议 / 从站地址等，以现场设备与驱动说明书为准。

全部服务视图

【说明】：用于在一屏内总览本网关的全部采集服务，并按运行状态 / 链路状态快速筛选、批量启停。

【操作】：进入「数据采集 → 采集服务」后，左侧服务树顶部是一个「全部服务」容器根节点（图标与普通服务节点不同），默认选中；右侧展示的就是全部服务列表，而不是某一个服务的详情。

列表从上到下分四块：汇总条 → 查询区 → 批量操作条（勾选后才出现）→ 服务表格 + 分页。

汇总条：显示「共 N 个采集服务」，并提供三个可点击的快捷筛选块——运行中 N、已停止 N、链路异常 N。点击即按该条件筛选，再点一次取消筛选。其中「链路异常」的口径是：服务正在运行、但上行链路不是「已连接」的服务数（已停止的服务不计入，避免重复统计）。

查询区：输入服务名称 / 描述关键词搜索，另有两个下拉框——「全部状态」（正在运行 / 已停止）、「全部链路」（上行已连接 / 上行断开），点【查询】生效。搜索与筛选、分页都在本地完成，不会重新向设备发请求。

服务表格：

列	说明
服务名称	服务名；下方小字显示驱动名称与版本（如 驱动: GB_Modbus_Poll_TCP）；名字以 _ 开头的虚拟服务额外显示「虚拟」标签
服务描述	该服务的描述，未填写时显示 —
运行状态	正在运行 / 已停止
链路状态	上行链路四态：上行已连接 / 上行正在连接 / 上行连接失败 / 上行未连接。服务停止时固定显示「上行未连接」
通道数	该服务下的通道数量
资源占用	CPU 与内存两行进度条，右侧显示百分比；数值越高进度条颜色越醒目
操作	【查看】【编辑】【停止】（服务已停止时显示【启动】）

批量启停：勾选一行或多行后，表格上方浮出「已选 N 项：」操作条，提供【批量启动】【批量停止】【批量重启】【取消选择】。点击任一批量按钮都会弹出二次确认框——标题形如 批量启动服务（N 个），正文列出本次受影响的服务名与数量（此操作将批量启动以下 N 个服务，请谨慎操作！），确认后才执行。

行为说明：

• 点击行只是选中高亮；双击行或点击操作列【查看】，进入该服务的详情页（与在左侧树中点击该服务节点一致），可继续做通道与测点操作；
• 服务树与列表状态由 WebSocket 实时推送驱动（服务新增、删除、启停、状态变化会实时刷新），页面没有刷新按钮，也不需要手动刷新；
• 虚拟服务只打标、不过滤：以 _ 开头的虚拟服务照常列出，不会被隐藏；
• 筛选后没有匹配项时，表格显示「没有符合条件的服务」，可点【重置筛选】恢复全部；
• 分页每页可选 10 / 20 / 50 条。

【注意】批量启停会同时中断或恢复多个服务的数据采集，确认框里的服务名清单请逐条核对后再点确定。

采集服务管理

在左侧树中选中一个服务后，可用的按钮是：停止服务 ／ 重启服务 ／ 编辑 ／ 删除 ／ 下载日志 ／ 历史回补（另有添加通道、通道导出，见「采集通道管理」）。

新建采集服务

【说明】：用于新建采集服务。
【操作】：点击【数据采集】→【采集服务】菜单，再点击【创建服务】按钮。后续步骤与配置向导中创建采集服务一致，可参考上文。

查询采集服务

【说明】：用于查询采集服务。
【操作】：在搜索框内输入节点名称即可。

编辑采集服务

【说明】：用于修改服务配置。
【操作】：在左侧树中选中一个服务，点击【编辑】即可修改服务配置。

设置日志级别

【说明】：日志级别决定服务写入日志的详细程度，是排查现场问题时最常调整的一项。级别越详细，日志量越大、占用磁盘越多。

日志级别属于服务级配置，只在【编辑】服务的表单里出现——新建服务时没有这一项（新建表单只有 服务名称 / 描述 / 服务监控点 / 选择应用）。

【操作】：

步骤1. 在左侧树中选中一个服务，点击【编辑】。

步骤2. 在服务配置表单中找到日志级别，从下拉框中选择级别：

可选值	说明
debug	最详细，含调试信息。排查问题时临时调到这一级，定位完成后建议调回
info	常规运行信息（默认值）
warn	只记录警告及以上
error	只记录错误，日志量最小

步骤3. 点击【保存】。日志级别修改后立即生效，无需手动重启服务：

• 支持多通道的服务：由后台通过 gRPC 在线下发，服务不中断；
• HTTP 接口类型的服务：由后台自动重启该服务使配置生效。

【注意】级别越详细，日志文件增长越快、越占磁盘。长时间使用 debug 前请确认设备剩余磁盘空间。

【说明】部分驱动的通道另有自己的日志级别（出现在【编辑通道】表单里）；本次核实的设备上，采集通道表单没有该项，按本节的服务级设置即可。

删除采集服务

【说明】：删除当前采集服务及其下测点数据。删除后服务对应的节点也会一并删除。

【警告】删除不可恢复。若只是要重配测点、保留服务配置，请改用【清空测点】。

【操作】：在左侧树中选中一个服务，点击【删除】，在二次确认弹框中点击【确定】即可。确认框标题为 提示，正文为 此操作将删除该服务，请谨慎操作！。

下载日志

【说明】：按时间选取所需下载的日志文件。日志内容的详细程度由服务级的【日志级别】决定，见上文「设置日志级别」。
【操作】：在左侧树中选中一个服务，点击【下载日志】，在弹出的「日志下载」窗口中选择要下载的日志，点击该行末尾的【下载】即可；也可点【批量下载】一次下载全部日志。

历史回补

【说明】：用于将指定时间段内的历史数据全部重新发送，会消耗较大流量，请酌情使用。

采集服务中，在驱动支持的前提下，以下数据可自选时间段进行回补：

• DASS 与设备建立连接之前，被采集设备已保存的历史数据；
• 由于通讯异常，导致 DASS 中保存的历史数据少于设备实际保存的历史数据。

【操作】：在左侧树中选中一个服务，点击【历史回补】，选择回补的时间段，点击【确认】即可。

启停控制

【说明】：用于控制服务启停。

• 开启服务：启用服务，与设备建立连接，正常请求测点数据；
• 停止服务：服务中止，与设备连接断开，测点无数据。

服务运行时卡片上显示【停止服务】，停止后显示【开启服务】。

停止服务

【操作】：在左侧树中选中一个服务，点击【停止服务】即可，点击后立即执行、无需二次确认；停止完成后卡片上的按钮变为【开启服务】。

启动服务

【操作】：在左侧树中选中一个服务，点击【开启服务】即可，点击后立即执行、无需二次确认；启动完成后按钮变回【停止服务】。

重启服务

【说明】：用于重启该服务，使配置变更生效。
【操作】：在左侧树中选中一个服务，点击【重启服务】即可，点击后立即执行、无需二次确认；重启过程中服务短暂不可用。

采集通道管理

在左侧树中选中一个服务时，服务卡片上提供添加通道、通道导出两个按钮；选中一个通道时，通道卡片上提供挂起通道 ／ 编辑 ／ 删除 ／ 下载日志 ／ 克隆（通道已挂起时显示启用通道）。

【注意】DEC / VDEC 通道（旧版驱动自动创建）不显示通道级按钮——它们不支持挂起、启用、克隆等操作。这类通道只需创建测点即可，相关说明见《配置向导》。

查询通道

【说明】：用于查询采集服务中的通道。
【操作】：在输入框中输入节点名称即可查询。

添加通道

【操作】：在左侧树中选中一个服务，点击【添加通道】按钮。后续步骤与配置向导中创建采集通道一致，可参考上文。

通道导出

【说明】：系统按当前通道配置状态执行差异化导出：

• 目标服务下尚未配置有效通道时，自动生成预设格式的通道模板文件；
• 服务中已有通道时，导出包含全部通道属性及元数据的结构化配置文件。

【操作】：在左侧树中选中一个服务，点击【通道导出】按钮即可。

删除通道

【操作】：在左侧树中选中要删除的通道，点击【删除】，在弹框中点击【确定】即可。

实测提示（2026-09-11）：删除通道时确认框正文写的是 此操作将删除该服务，请谨慎操作！（标题 提示）—— 文案与「服务」相同，属界面文案沿用问题，实际操作的是通道（源码 device-message.vue 的 deleteDevice() 调用 deleteEquipment 并传入 channels）。

编辑通道

【操作】：

步骤1. 在左侧树中选中需要编辑的通道，点击【编辑】。

步骤2. 通道名称不可修改，编辑通道配置后点击【保存】即可。

克隆通道

【说明】：用于快速复制出多个配置相同、测点相同的通道。

【操作】：

步骤1. 在左侧树中选中需要克隆的通道，点击【克隆】。

步骤2. 填写克隆的通道信息：

• 服务名称：创建采集服务时已填写，此处无需再填；
• 通道名称：必填项，填写格式为字母、数字、下划线，示例：device1copy。

步骤3. 填写配置信息（不同驱动版本的配置项不同，见对应驱动说明书），填写完点击【确认克隆】即可。

挂起通道

【说明】：挂起通道表示通道暂时无法执行通信操作，且不能做测点的新增、编辑、导入操作。
【操作】：在左侧树中选中需要挂起的通道，点击【挂起通道】按钮。\

下面是「挂起通道 → 按钮变成启用通道 → 再启用回来」的完整过程：

启用通道

【说明】：启用通道表示通道可以执行通信操作。
【操作】：在左侧树中选中需要启用的通道，点击【启用通道】按钮。

采集测点管理

在左侧树中选中一个通道，右侧切到【测点信息】页签。
工具栏按钮：新建测点 ／ 删除测点 ／ 清空测点 ／ 导入测点 ／ 导出测点 ／ 模板下载 ／ 清洗测点。

查询测点

【操作】：在左侧树中选中一个通道，在输入框中输入点名或描述，点击【查询】按钮即可。

新建测点

【操作】：在左侧树中选中一个通道，点击【新建测点】按钮即可。后续步骤与配置向导中创建采集测点一致，可参考上文。

删除测点

【操作】：在左侧树中选中一个通道，勾选该通道下要删除的测点，点击【删除测点】，在弹框中点击【确定】即可。

编辑测点

【操作】：

步骤1. 在左侧树中选中一个通道，勾选要编辑的测点，点击该行【操作】列中的【编辑】。

步骤2. 修改测点信息，点击【保存】即可。

导入测点

【说明】：当已通过模板或导出功能获得测点文件（.xlsx）时，可在此处上传。
【操作】：点击【导入测点】，选择相应的 .xlsx 文件，点击【上传】按钮即可。

导出测点

【说明】：导出该服务内的所有测点，可用于测点迁移 / 备份。
【操作】：点击【导出测点】，即可获取测点文件（服务名.xlsx），按需编辑后上传导入至其他服务。

下载测点模板

【说明】：由于单个添加测点效率较低，DASS 支持通过 .xlsx 文件批量创建测点。
【操作】：点击【模板下载】，即可获取测点模板文件（服务名.xlsx），按需编辑后上传导入至其他服务。

清空采集测点

【说明】：清空该服务下所有测点信息。当希望保持服务配置且重配测点时使用。

【警告】清空后该服务下的测点全部消失且不可恢复，操作前请先【导出测点】留一份备份。

【操作】：点击【清空测点】，在弹框提示中点击【确定】即开始删除所有测点信息。

清洗测点

【说明】：用于清理该服务下所有测点的脏数据，包括缓存、无效、重复的数据，提高 DASS 系统的空间利用率。
【操作】：在左侧树中选中一个服务，点击【清洗测点】，弹框中点击【确定】即可。

参数说明

本章涉及字段的默认值与约束见「用户必读 → 默认参数」；此处只列采集服务特有的：

字段	取值 / 约束	说明
服务名称	≤ 11 字节，全局唯一	服务编码取服务名（V5.2.0 起）；改名等于新建
选择应用	网关已装的驱动	列表里没有 → 先到「应用管理」离线导入驱动
描述	不能为空	—
通道名称	≤ 12 字符，字母 / 数字 / 下划线	同一服务下唯一
测点属性	见附录《测点属性表》	点名 / ID / 点的类型创建后不可改
日志级别	debug / info / error / warn，默认 info	改动实时生效（多通道服务经 gRPC 在线下发；HTTP 接口类由后台自动重启）

注意事项

✅ 允许：服务 / 通道 / 测点的增删改；查看实时日志；下载日志；历史回补。

❌ 禁止 / 需谨慎：

• ⚠️ 警告 删除服务会连带删除其下通道与测点，采集随之中断 → 先导出点表留档；
• ⚠️ 警告 【停止】/【重启】服务会中断该服务采集，历史数据可能出现空档；
• ⚠️ 注意 点名、ID、点的类型创建后不可修改，改错只能"新建 + 删除"；
• ⚠️ 注意 排障后请把日志级别调回 info，debug 会明显加快日志增长。

示例

以 Modbus TCP 为例（完整演示见「快速入门 → 动手做一遍」）：

1. 新建服务：应用 GB_Modbus_Poll_TCP，服务名 qs_das，描述 快速入门示例；
2. 通信配置：填写目标设备 IP 与端口 502；
3. 添加通道：通道名 ch1；
4. 添加测点：点名 dm1、点的类型 模拟量、地址信息（AD）1.3.0、采集点类型（SR）INT16；
5. 验证：在「数据一览」中能看到 qs_das/ch1/dm1 的实时值，且状态为 Good。

常见问题及解决方法

现象	原因	处置
新建服务时应用列表为空	驱动未装或平台不匹配	从应用市场取对应平台驱动 → 应用管理离线导入
建不出通道 / 驱动表单为空	驱动与设备版本不匹配	换与设备版本一致的驱动包
测点状态一直 timeout	更新间隔 > 1.5 × 分辨率（FQ）	核对 AD、确认设备在线；必要时调大 FQ
导入测点后服务配置没变化	导入结果未回查	刷新测点列表确认（见「常见问题及解决方法 → 导入测点报 ID 相关的错误」）
保存时报「服务名超长」	服务名 > 11 字节	缩短服务名
建服务报授权相关错误	点数/服务数余量不足	见「常见问题及解决方法 → 新建服务 / 测点时报错，但配置看着都对」

相关命令/接口

见**《DASS5 接口与二次开发手册》** → 「4.3 采集服务」「4.4 采集通道」「4.5 采集测点」「4.6 上传服务与上传测点」。

安全声明

⚠️ 警告 删除服务、清空测点、点表覆盖导入都会造成不可恢复的配置 / 数据损失，执行前必须先备份（见「常用操作 → 系统备份与恢复」）。

⚠️ 注意 采集地址（AD）格式由驱动决定：PLC 是寄存器地址、MQTT 是主题、OPC-UA 是节点 ID。填错通常不报错但会读到错值，务必对照驱动说明书。