系统
目录
- 概览
- 界面构成 — System 组
- 监控界面 (
/monitoring/index) - 日志界面 (
/log/index) - 设置界面 (
/config/index) - 环境信息界面 (
/env/view) - 应用场景
- 常见问题
- 相关界面
概览
系统菜单是汇总了 Platform 自身运行状态、安全账户、设置、日志、环境信息和集群的区域。目前左侧菜单的 System 组包含以下项目。
| 子菜单 | 内部 URL / 外部端口 | 用途 |
|---|---|---|
| 用户 | /user/index | 用户账户管理 |
| 安全策略 | /security/index | 密码·访问安全策略 |
| API 令牌 | /token/index | 外部联动用 API 令牌 |
| 监控 | /monitoring/index | 基础设施健康·数据流水线·引擎指标实时仪表板 |
| 诊断 | /diagnostic/index | 系统诊断事件查询 |
| 日志 | /log/index | 按时间顺序查询服务器应用程序日志（类·方法·行单位） |
| 设置 | /config/index | 系统运行键值设置管理（重新应用/重启） |
| 环境信息 | /env/view | 按标签页查询每个属性文件的环境设置值 |
| 集群 | /cluster/index | 集群节点状态 |
| HA | /ha/index | 高可用配置状态 |
| 审计 | /audit/index | 审计日志 |
本文档重点说明 监控 / 日志 / 设置 / 环境信息。关于用户·安全·令牌请参考 安全管理，诊断请参考 诊断，外部工具请参考 标准及外部工具。
界面构成 — System 组
| 界面 | 主要用户 | 一句话总结 |
|---|---|---|
| 监控 | 系统管理员 | 基础设施健康 5格 + 流水线图 + 引擎指标 9面板 + 流量·集群·诊断 |
| 诊断 | 运营者/管理员 | 系统诊断事件及 INFO/WARN/ERROR 流程 |
| 日志 | 运营者/管理员 | 包含类·方法·行信息的详细应用程序日志 |
| 设置 | 系统管理员 | 系统键值设置添加·修改·缓存重新应用 |
| 环境信息 | 系统管理员 | 查询属性文件（引擎/应用程序/消息队列/存储/邮件/WebSocket）（只读） |
| 集群 | 系统管理员 | 集群节点、模式、延迟、资源状态 |
| HA | 系统管理员 | 高可用配置状态 |
| 审计 | 系统管理员 | 审计日志 |
监控界面 (/monitoring/index)
以仪表板形式显示 Platform 自身的实时运行指标。 副标题中会显示 服务器启动时间 — 可一眼确认是否刚刚重启。
| 数字 | 位置 | 内容 |
|---|---|---|
| ① | 左上 | 基础设施健康 — 5格 |
| ② | 左中 | 数据流水线 图 |
| ③ | 左下 | 引擎指标 9面板 |
| ④ | 右上 | 数据流量 — 每秒字节 + Sparkline |
| ⑤ | 右中 | 集群 — 各节点状态·读/写延迟·存储 |
| ⑥ | 右下 | 系统诊断 — 健康时间线 + 最近诊断 |
① 基础设施健康 — 5格
| 格 | 标签 |
|---|---|
| 1 | 缓存 |
| 2 | MQTT |
| 3 | KAFKA |
| 4 | 事件存储 |
| 5 | 时序引擎 |
每个格显示正常/异常。全部正常则运营状态稳定。
副标题文字列出了「缓存·WebSocket·MQTT·Kafka·事件存储·时序引擎」六项， 但实际绘制的格为 五 个。WebSocket/STOMP 已于 2026-07 退役 （浏览器推送已改为 SSE），仅先移除了该格 — 这是副标题的残留。
② 数据流水线图
将 数据源 → 消息总线 → 引擎 → 分析 → 存储 分为五段排列节点， 通过节点间的流动线显示实际路径。
| 段 | 放置节点(示例) |
|---|---|
| 数据源 | Edge/文件/API · DB · Modbus · PLC · OPC — 每个节点显示 注册数 |
| 消息总线 | Messaging Hub — MSG/S |
| 引擎 | Pipeline(处理数·等待) · CEP(任务数) · Ingestion |
| 分析 | Scheduler · Batch · Stream(MPS) |
| 存储 | 缓存 · 事件存储 · TSE(WPS) |
节点下方的细小文字为该节点的当前指标。寻找阻塞点时请先查看此处 — 若前段数字上升而后续段停止，则该区间为瓶颈。
③ 引擎指标 — 9面板
3列 × 3行。每个面板由若干键值对 + 小型图表组成。
| 面板 | 显示值 |
|---|---|
| PPS | 当前 PPS · 最大 PPS (每秒采集 · 最近 1 分钟) |
| JVM 堆 | 已使用 · 总量 |
| Pipeline | 处理完成 · 队列等待 |
| 存储 | 缓冲区等待 · 活跃批次 |
| 消息 | KAFKA · MQTT |
| 流处理 | 处理笔数 · 超时 |
| 异步执行器 | 活跃 · 等待 |
| 诊断 | 警告 · 严重 |
| 缓存 | HIT · MISS |
④ 数据流量
用大数字显示每秒字节数，下方附带 Sparkline。
⑤ 集群
| 列 | 显示 |
|---|---|
| 状态 | 节点状态点 |
| 节点 IP | |
| 读取 | 读取 | 写入 延迟 (ops/s) |
| 存储 | 节点写入容量 |
顶部显示 总集群 N 节点，底部显示最后更新时间。
⑥ 系统诊断
包含 健康时间线 (正常 · 信息 · 警告 · 严重 四种图例) 和 最近 诊断列表。
每行附带发生时间·相对时间及来源标记(SERVER / EDGE)，可立即区分是 Platform 产生还是由现场 Edge 上传。详细查询请前往 诊断 界面。
该界面以前有按数据源显示颜色块网格的 连接热力图， 但现在不再绘制（仅保留消息文字）。如需以网格查看各连接状态， 请使用 连接状态界面 的数据源卡片网格。
日志界面 (/log/index)
按时间顺序查询服务器应用程序的代码级日志（类·方法·行）。与 /diagnostic/index 的诊断日志不同，这是 开发人员/管理员用于调试 的详细日志。
顶部搜索区域
📋 로그 [기간 ▭▭▭▭] [레벨 ▼] [건수 ▼] [조회] [전체 출력] [↻]
| 控制 | 宽度 | 说明 |
|---|---|---|
期间 (search_time) | 280px | 开始~结束 (居中，粗体) |
级别 (level) | 100px | 所有级别/INFO/WARN/ERROR |
消息 (message) | 250px (默认隐藏) | 关键词搜索。根据运行环境决定是否显示 |
笔数 (limit) | 130px | 50/100/200/300/500/1,000 |
| 查询 | 红色 + 🔍 | search() |
| 全部输出 | 红色 + 📄 | downloadCSV() — 将符合搜索条件的全部日志导出为 CSV |
刷新 (realtime_icon) | 红色 + ↻ | refresh() |
hidden 字段
app_name的默认值为SERVER。这意味着此界面仅查询服务器应用程序日志。
时间线 + 快速时间范围
与诊断界面相同的 6 按钮快速时间范围(10M/30M/1H/6H/12H/ALL) 和时间线(alarm_timeline)。
日志表格 (6列)
显示比诊断界面更深一层的代码级信息。
| 列 | 宽度 | 说明 |
|---|---|---|
| 级别 | 80px | INFO/WARN/ERROR 颜色标记 |
| 时间 | 160px | 日志发生时间 |
| 日志类 | 200px | Java 类全名 |
| 方法名 | 120px | 被调用的方法 |
| 行号 | 80px | 源代码行号 |
| 消息 | 自动 | 日志正文 + stack trace (若有) |
日志类/方法/行信息在系统管理员精确定位代码进行调试时非常有用。一般的运行异常信号追踪更适合使用 诊断 界面。
设置界面 (/config/index)
用于添加·修改·删除系统运行所需的键值设置，并重新应用缓存的界面。
地址设置
由于 Platform 无法自动获知用户在浏览器输入的地址，因此在此配置。可以留空保存。
| 设置键 | 用途 | 留空时 |
|---|---|---|
PP_UI_CONSOLE_URL | 控制台地址。用于报警邮件的 «前往确认报警» 链接及 QR 标签 | 邮件不带链接发送，QR 标签不绘制代码 |
PP_UI_FRONTLINE_URL | 现场 App 地址。用于 QR 公开页面的 «在 frontline 中打开» 按钮 | 隐藏按钮 |
值应为如 https://plantpulse.example.com 那样以 http(s) 开头的绝对地址。末尾的 / 将被截断保存，若包含查询语句或 # 则会被拒绝。
邮件服务器设置(MAIL_*)也在本界面完成 — 邮件设置。
顶部工具
🎚️ 시스템 설정 [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
| 控制 | 宽度 | 说明 |
|---|---|---|
设置键搜索 (search_keyword) | 200px | placeholder: "搜索设置键 ..." |
| 查询 | 红色 + 🔍 | search() — 应用关键词过滤 |
| 刷新 | 红色 + ↻ | refresh() |
| 添加设置 | 红色 + ➕ | addConfig() — 打开新设置添加表单 |
| 重新应用 | 蓝色 + 🔄 | refreshCache() — 无需重启服务器重新应用设置缓存 (工具提示: "无需重启服务器重新应用设置缓存。") |
设置列表表格
| 列 | 宽度 | 说明 |
|---|---|---|
| 设置键 | 300px | 系统识别的键 (例: engine.timeout.ms) |
| 设置值 | 600px | 键的当前值 |
| 说明 | 自动 | 键用途备注 |
| 修改日 | 150px | 最后修改时间 |
| 操作 | 80px | 修改·删除按钮 |
页面底部显示引导框。
ℹ️ 系统设置指南 管理系统运行所需的键值设置。更改设置后，部分项目可能需要重启服务器。
设置添加/修改表单
通过顶部 添加设置 或列表的操作进入设置表单界面(/config/form)。
| 输入 | 说明 |
|---|---|
| 设置键 | 仅限使用 英文/数字/./_。例: engine.timeout.ms |
| 设置值 | 文本 (数字·boolean·JSON 均可，取决于键定义) |
| 说明 | 自由文本 (方便运营者识别的备注) |
保存后如需立即生效，请返回列表界面点击 重新应用。部分设置可能仍需重启服务器。
环境信息界面 (/env/view)
该界面为 只读 模式，用于按组标签页查询 Platform 启动时读取的属性文件。
顶部引导框
❓ 系统环境信息 按属性文件显示服务器系统中配置的环境信息。如需更改环境配置，请修改对应文件。
- 更改配置后必须重启服务器。
6 标签页构成
| 标签页 | 显示内容 |
|---|---|
| 引擎 | 引擎核心运行设置 (时间/线程/队列限制等) |
| 应用程序 | Web 应用程序通用设置 |
| 消息队列 | 消息通道连接设置 (Broker 主机·认证·Topic 等) |
| 存储 | 时序·事件存储连接设置 |
| 邮件 | 电子邮件发送 SMTP 设置 |
| WebSocket | 实时推送通道设置 |
各标签页表格 (通用)
| 列 | 显示内容 |
|---|---|
| 键 | 属性键 |
| 设置值 | 当前值 (掩码后的密码显示为 ***) |
环境信息界面 无法修改 数值。如需更改，系统管理员必须直接修改服务器对应的属性文件并重启服务器。可在 设置 界面管理可动态更改的键值。
应用场景
| 场景 | 界面 | 步骤 |
|---|---|---|
| PPS 低于平常 | 监控 | PPS 面板图表 → 基础设施健康 5格 → 识别数据流水线图的瓶颈节点 |
| GC 时间过长 / 怀疑内存泄漏 | 监控 | JVM 堆面板的 GC 时间趋势 → 通知系统管理员 |
| 确认服务器启动后正常运行 | 监控 | 副标题启动时间 + 基础设施健康 5格全部正常 + 流水线节点数值上升 |
| 追踪特定类中的 ERROR | 日志 | 级别=ERROR + 消息搜索类名关键词 → 分析包含行号的日志 |
| 临时应用设置变更 | 设置 | 添加/修改设置 → 重新应用 (无需重启) |
| 更改密码策略·会话时间 | 环境信息 | 在应用程序标签页确认当前值 → 系统管理员修改文件 → 重启服务器 |
| 查找哪个连接失效 | 连接管理 | 状态界面 的数据源卡片网格 → 点击卡片 → 详细信息 |
常见问题
Q. 监控界面与诊断界面有什么区别？ A. 监控 关注 Platform 自身的实时运行指标（吞吐量·内存·健康度），诊断 则是各模块的 INFO/WARN/ERROR 事件日志。两者均由系统管理员使用，但监控回答的是“现在如何？”，而诊断回答的是“发生了什么？”。
Q. 监控的基础设施健康中有一个格显示为红色。 A. 表示该组件未响应或健康检查失败。请立即在 诊断 界面确认 SERVER 或该组件的 ERROR 日志，并同时通知系统管理员。
Q. 数据流水线图的节点显示为灰色。 A. 表示该阶段未激活或无处理数据。部分阶段在平时显示为灰色属正常（如备份·归档），但若在数据入口时段显示为灰色则可能是问题。
Q. 以前的 «连接热力图» 不见了。
A. 已从监控界面移除。连接状态请在 连接管理 > 状态 界面的数据源卡片网格中查看，点击卡片可进入详细界面(/connect/view)。
Q. 日志界面和诊断界面应该看哪个？ A. 异常信号追踪 使用 诊断，代码级调试 使用日志。如果在诊断中发现 ERROR 但消息不足，请在同一时间的日志界面查看该类/方法的详细日志。
Q. 设置界面的 “重新应用” 按钮安全吗？ A. 它仅刷新内存缓存而无需重启服务器。对大多数设置是安全的，但部分设置（如线程池大小·DB 连接池等）仍需重启。重新应用后若动作不符合预期，请咨询系统管理员。
Q. 我想在界面上修改环境信息的值。 A. 环境信息界面为只读。更改必须修改服务器侧的属性文件并重启服务器。可在界面上更改的键值请在 设置 界面中管理。
Q. 日志的 “全部输出” CSV 文件太大。 A. 请缩短搜索期间（1小时内），将级别缩小至 ERROR/WARN 后重新下载。或在下载 CSV 后使用外部分析工具。
Q. 监控界面会自动更新吗？ A. 监控通过实时推送自动更新。如果指标停止更新，请先确认页眉的实时连接状态是否为红色。