事件查询
# 事件查询
事件查询用于按设备、事件类型和时间范围检索平台产生的各类事件记录，并单独提供系统事件的查询入口。
# 视频教程
# 1 概述
本章介绍事件查询模块的用途、典型场景与常用术语。
# 1.1 功能简介
事件查询模块用于追溯平台运行过程中产生的各类记录。平台把设备侧和系统侧发生的事情都记成"事件"，本模块提供按条件检索这些事件的界面。
本模块包含两个功能页面：
| 页面 | 功能定位 |
|---|---|
| 设备事件 | 查询设备侧产生的事件：设备自身的离线/在线与报警、遥测量的越限与恢复、遥信量的变位与恢复、以及对设备下发设置量的记录 |
| 系统事件 | 查询平台侧产生的事件：系统启动、用户登录、数据采集启停等与具体设备无关的记录 |
说明 本模块只读。事件由平台在运行过程中自动记录，事件查询不提供新增、修改或删除事件的入口。
# 1.2 应用场景
| 场景 | 说明 |
|---|---|
| 故障回溯 | 某台设备在特定时段频繁报警，调出该设备的事件记录定位时间点与报警值 |
| 通讯质量排查 | 查看设备"离线 / 恢复在线"事件，统计通讯中断的次数与时长 |
| 操作审计 | 查询系统事件中的用户登录记录，确认谁在什么时候登录了平台 |
| 报警确认情况检查 | 通过"确认人 / 确认时间"列，检查报警是否已被值班人员确认 |
| 事件关联排查 | 通过"预案"列，确认报警触发时是否联动了预案 |
# 1.3 术语表
| 术语 | 说明 |
|---|---|
| 事件 | 平台在运行过程中记录的一条带时间戳的流水记录 |
| 设备事件 | 与某台设备绑定的事件，记录中带设备号与设备名称 |
| 系统事件 | 与设备无关的平台级事件，如系统启动、用户登录 |
| 事件类型 | 设备事件的四个子类：设备事件、遥测事件、遥信事件、设置事件 |
| 遥测事件 | 模拟量测点（如温度、电压）报警或恢复正常时产生的事件 |
| 遥信事件 | 状态量测点（如开关分/合）变位或恢复正常时产生的事件 |
| 设置事件 | 对设备下发设置量（控制命令）时产生的事件 |
| 事件级别 | 事件的严重程度分级，取值由平台配置决定 |
| 预案 | 事件触发时联动的处理预案，未关联时该列为空 |
| 确认人 / 确认时间 | 该事件被人工确认的操作人与操作时刻；未确认时显示 - |
# 3 前提条件
执行本模块的操作前，请确认：
| 前提 | 说明 |
|---|---|
| 已登录平台 | 使用具备事件查询权限的账号登录 IoTCenter |
| 已分配菜单权限 | 左侧目录中能看到事件查询及其下的设备事件、系统事件 |
| 已分配接口权限 | 账号需被授予事件查询对应的接口策略，否则进入页面后查询会失败 |
| 已接入设备 | 查询设备事件需要先有设备台账（见设备管理模块）。系统事件不依赖设备 |
| 设备正在产生事件 | 若所选设备在时间范围内没有任何事件，列表会显示为空，这是正常结果而非故障 |
说明 事件数据由平台自动记录，不需要事先开启。系统事件从平台部署完成起就开始产生。
# 4 进入事件查询模块
操作步骤：
登录 IoTCenter 平台。
在左侧目录中找到事件查询，点击展开，可见两个子菜单：
- 设备事件
- 系统事件
点击设备事件进入设备事件查询页面，或点击系统事件进入系统事件查询页面。
说明 两个子菜单是相互独立的两张页面，各自维护自己的查询条件，互相之间不会带条件跳转。
# 5 设备事件
设备事件页面用于查询指定设备在指定时间范围内、指定事件类型下的全部事件记录。
# 5.1 界面说明
页面分为左右两部分：
| 区域 | 内容 |
|---|---|
| 左侧设备面板 | 顶部标题为选择查询设备(数量)，其下是搜索框与设备树。设备树按分组 → 设备两级展示，每个设备前有复选框 |
| 右侧查询与结果区 | 顶部是查询条件条，自上而下依次是页面标题设备事件、事件类型下拉框、时间范围，以及查询按钮；条件条下方是结果列表与分页 |
查询条件条的构成如下：
| 控件 | 说明 |
|---|---|
| 事件类型 | 下拉框，可选设备事件 / 遥测事件 / 遥信事件 / 设置事件，默认选中设备事件 |
| 时间范围 | 两个日期时间输入框，中间以至连接，默认是当天 00:00:00 至 23:59:59 |
| 查询 | 按当前条件执行查询 |
结果列表默认有 9 列：时间、设备号、设备名称、设备事件、事件级别、预案、确认人、确认时间、确认备注。分页可选 20 / 100 / 200 / 300 条/页。
# 5.2 选择查询设备
操作步骤：
在左侧设备面板的搜索框中输入设备名称关键字，可筛选设备树。
勾选需要查询的一台或多台设备前的复选框。
勾选分组前的复选框可一次选中该分组下的全部设备。
注意 未选择任何设备就点击查询，页面会提示请选择设备后进行查询!。
# 5.3 选择事件类型
在事件类型下拉框中按需选择：
| 选项 | 查询范围 |
|---|---|
| 设备事件 | 设备自身的离线、恢复在线、报警等整体性事件 |
| 遥测事件 | 该设备下模拟量测点的报警与恢复正常 |
| 遥信事件 | 该设备下状态量测点的变位与恢复正常 |
| 设置事件 | 对该设备下发设置量（控制命令）的记录 |
# 5.4 选择时间范围
操作步骤：
点击时间范围输入框，展开日期时间面板。
可任选以下两种方式之一：
- 快捷区间：点击最近一周、最近一个月或最近三个月，面板会自动填入对应的起止时间；点击清空可清除已选区间。
- 自定义：分别在开始日期与开始时间、结束日期与结束时间中逐项选择。
点击确定关闭面板。
注意 开始时间不得晚于结束时间，否则查询时提示开始时间不能大于结束时间。
# 5.5 执行查询
操作步骤：
确认设备、事件类型、时间范围三项条件已设置。
点击查询，列表返回符合条件的事件记录，并在分页区显示总条数。
说明 若所选设备在该时间范围内没有任何事件，列表为空且总条数为 0，这是正常结果。
# 5.6 数据量较大时的提示
当命中的事件数据量较大时，平台会先统计总条数，再弹出提示，请用户确认是否继续取回结果。此时按提示点击确认后等待结果返回即可，不要重复点击查询。
# 6 系统事件
系统事件页面用于查询与设备无关的平台级事件。
# 6.1 界面说明
页面顶部是查询条件条，标题为系统事件（条数），其下是时间范围与查询按钮；条件条下方是结果列表与分页。
| 控件 | 说明 |
|---|---|
| 时间范围 | 两个日期时间输入框，中间以至连接，默认是当天 00:00:00 至 23:59:59 |
| 查询 | 按当前时间范围执行查询 |
结果列表有 5 列：时间、系统事件、确认人、确认时间、确认备注。分页默认 20 条/页。
# 6.2 查询系统事件
操作步骤：
进入事件查询 → 系统事件，页面默认显示当天的系统事件。
如需查询其他时间段，修改时间范围中的起止时间。
点击查询，列表返回该时间段内的系统事件。
典型的系统事件记录如系统启动数据采集！、用户-admin((127.0.0.1,64173)-登录平台成功！。
注意 系统事件的时间跨度不能超过 90 天，超出时提示时间间隔不能超过90天！。
# 7 参数说明
# 7.1 查询条件
| 条件 | 适用页面 | 是否必填 | 说明 |
|---|---|---|---|
| 查询设备 | 设备事件 | 是 | 一台或多台设备，来自左侧设备树的勾选结果 |
| 事件类型 | 设备事件 | 是 | 设备事件 / 遥测事件 / 遥信事件 / 设置事件 |
| 时间范围 | 两个页面 | 否（默认当天） | 起止时间；设备事件无 90 天上限，系统事件上限 90 天 |
# 7.2 设备事件列表字段
| 列名 | 说明 |
|---|---|
| 时间 | 事件发生的时刻 |
| 设备号 | 产生该事件的设备编号 |
| 设备名称 | 产生该事件的设备名称 |
| 设备事件 | 事件内容描述，如"通讯恢复正常" |
| 事件级别 | 事件的严重程度分级 |
| 预案 | 该事件联动的预案；未关联时为空 |
| 确认人 | 确认该事件的操作人；未确认时显示 - |
| 确认时间 | 确认该事件的时刻；未确认时为空 |
| 确认备注 | 确认时填写的备注；未确认时显示 - |
# 7.3 系统事件列表字段
| 列名 | 说明 |
|---|---|
| 时间 | 事件发生的时刻 |
| 系统事件 | 事件内容描述，如"系统启动数据采集！" |
| 确认人 | 确认该事件的操作人；未确认时显示 - |
| 确认时间 | 确认该事件的时刻；未确认时为空 |
| 确认备注 | 确认时填写的备注；未确认时显示 - |
# 7.4 事件类型说明
| 类型 | 平台内的含义 |
|---|---|
| 设备事件 | 设备层面的整体事件，典型为离线、恢复在线、报警 |
| 遥测事件 | 模拟量测点的报警与恢复正常 |
| 遥信事件 | 状态量测点的报警与恢复正常 |
| 设置事件 | 对设备下发设置量产生的记录 |
| 系统事件 | 平台层面的记录，不归属任何设备 |
# 7.5 取值与格式约定
| 项 | 格式 |
|---|---|
| 日期时间 | YYYY-MM-DD HH:mm:ss，如 2026-09-28 13:50:20 |
| 时间范围默认值 | 当天 00:00:00 至 23:59:59 |
| 未确认的确认人 / 确认备注 | 显示为 - |
| 未确认的确认时间 | 显示为空 |
| 分页可选条数 | 设备事件 20 / 100 / 200 / 300 条/页；系统事件 20 条/页 |
# 8 约束与注意事项
# 8.1 数据量与性能
- 事件的单次查询结果总量有上限（默认 1000000 条），达到上限时平台会给出提示。
- 数据量较大时平台会先统计条数并请用户确认后再取回结果，确认后请耐心等待，不要反复点击查询。
- 处理过程中可以关闭弹窗继续操作其他页面，处理完成后结果会返回。
# 8.2 其他
- 本模块只读，不提供新增、修改、删除事件的入口。
- 事件由平台自动记录：设备侧事件依赖设备正在接入并产生数据；系统事件自平台部署完成起产生。
- 设备事件的列表列数会随部署版本略有差异。
- 平台另有一个系统查询页面（自定义条件查询系统数据表），未挂载到当前版本的平台菜单中，无法从左侧目录进入。
# 9 常见问题
# 9.1 操作类问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 查询结果为空 | 所选设备在该时间范围内没有事件 | 放宽时间范围，或改选其他事件类型 |
| 左侧设备树中找不到设备 | 设备不在当前账号的分组权限范围内 | 联系管理员确认分组权限，或到设备管理中确认设备是否存在 |
| 登录后在左侧目录找不到事件查询 | 账号未分配该菜单权限 | 联系管理员分配菜单与接口权限 |
# 9.2 错误提示对照
| 提示原文 | 触发条件 | 处理 |
|---|---|---|
| 请选择设备后进行查询! | 未勾选设备 | 勾选至少一台设备 |
| 请选择事件类型 | 事件类型为空 | 重新选择事件类型 |
| 查询时间为空 | 未设置时间范围 | 设置起止时间 |
| 开始时间不能大于结束时间 | 起止时间填反 | 调整时间范围 |
| 时间间隔不能超过90天！ | 系统事件跨度超限 | 拆分为多段查询 |
| 数据处理中，可关闭弹窗操作其他页面！ | 后台正在处理大批量数据 | 可关闭弹窗继续操作，稍后取结果 |
| 网络请求超时，请继续等待或者重新登录 | 请求超时 | 等待或重新登录后重试 |
| 请求参数为空，请检查 | 查询参数缺失 | 重新设置查询条件后重试 |
| 没有相关数据 | 没有符合条件的记录 | 放宽查询条件 |