系统
目录
- 概述
- 界面构成 — System 分组
- 监控界面 (
/monitoring/index) - 日志界面 (
/log/index) - 配置界面 (
/config/index) - 环境信息界面 (
/env/view) - 应用场景
- 常见问题
- 相关界面
概述
系统菜单集中管理平台自身的运行状态、安全账户、配置、日志、环境信息与集群。当前左侧菜单的 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 分组
| 界面 | 主要使用者 | 一句话概要 |
|---|---|---|
| 监控 | 系统管理员 | 六分格基础设施健康 + 管道 + 6 项引擎指标 |
| 诊断 | 操作员/管理员 | 系统诊断事件与 INFO/WARN/ERROR 流向 |
| 日志 | 操作员/管理员 | 含类、方法、行号信息的详细应用日志 |
| 配置 | 系统管理员 | 系统键值配置的新增、修改与缓存重新应用 |
| 环境信息 | 系统管理员 | 属性文件(引擎/应用/消息队列/存储/邮件/WebSocket)查看(只读) |
| 集群 | 系统管理员 | 集群节点、模式、延迟、资源状态 |
| HA | 系统管理员 | 高可用配置状态 |
| 审计 | 系统管理员 | 审计日志 |
监控界面 (/monitoring/index)
以仪表板形式展示平台自身的实时运行指标。
顶部 — 服务器启动时间
🩺 모니터링 YYYY-MM-DD HH:MM:SS 에 서버가 시작됨 [↻]
| 项目 | 显示 |
|---|---|
| 页面标题 | 🩺 “监控” |
| 辅助信息 | 服务器启动时间(灰色小字)— EngineManager.getInstance().getStartedDate() |
| 刷新 | 红色按钮 + ↻ — 重新加载全部指标 |
基础设施健康状态(六分格面板)
顶部面板的六分格构成。每个单元格等宽(约 16.66%)排列。
| 单元格 | 图标 | 标签 | 显示值 ID |
|---|---|---|---|
| 1 | 💾 (内存) | 缓存 | side_jmx_h_redis |
| 2 | 🔌 (插头) | WebSocket | side_jmx_h_stomp |
| 3 | 📡 (卫星天线) | MQTT | side_jmx_h_mqtt |
| 4 | 🌊 (流) | KAFKA | side_jmx_h_kafka |
| 5 | 🗄️ (DB) | 事件存储 | (健康 ID — 事件持久化存储状态) |
| 6 | 🕐 (时钟) | 时序引擎 | side_jmx_h_timeseries |
各单元格以彩色文字显示正常/异常状态。全部正常即表示运行处于稳定状态。
数据管道示意图
| 项目 | 说明 |
|---|---|
| 表头 | ⚡ “数据管道” |
| 正文 | pipeline_diagram — 580px 高度示意图 — 可视化展示 接入 → 校验 → 转换 → 存储 流程的节点与吞吐量 |
各节点上方显示吞吐量(每秒条数)、等待、丢弃指标。
连接热力图
🌐 연결 히트맵 N 에이전트
[■][■][■][■][■][■]... ← 24×24px 색 블록 그리드
─────────────────────────
🟢 정상 N 🟠 지연 N 🔴 이상 N ⬜ 미연결 N
| 项目 | 含义 |
|---|---|
| 表头 | 🌐 “连接热力图 ” + N 个代理(已注册的 OPC 数量) |
| 网格正文 | 按数据源的色块 (eq-block 24×24px) |
| 色块悬停 | 数据源名称、类型提示 |
| 色块点击 | /connect/view?opc_id=... 详情界面新窗口 |
颜色含义(摘要)
| 颜色 | 含义 | ID 计数器 |
|---|---|---|
| 🟢 绿色 | 正常 | heatmap_ok |
| 🟠 橙色 | 延迟 | heatmap_warn |
| 🔴 红色 | 异常 | heatmap_error |
| ⬜ 灰色 | 未连接 | heatmap_unknown |
引擎指标 6 面板
3 列 × 2 行网格中的 6 个指标面板。每个面板由左侧键值表 + 右侧/下方小图表组成。
1) PPS(每秒采集 · 最近 1 分钟)
| 项目 | ID | 说明 |
|---|---|---|
| 当前 PPS | side_pps_current | 每秒采集点数 (p/s) |
| 最大 PPS | side_pps_max | 最近 1 分钟最大值 (p/s) |
| 图表 | side_realtime_chart (220px) | 1 分钟折线图 |
2) JVM 堆
| 项目 | ID |
|---|---|
| 已用 | side_jmx_heap_used |
| 总量 | side_jmx_heap_total |
| GC | side_jmx_gc (毫秒) |
| 图表 | mon_jvm_chart (150px) |
3) 管道
| 项目 | ID |
|---|---|
| 任务 | side_jmx_pipe_task |
| 处理完成 | side_jmx_pipe_processed |
| 队列等待 | side_jmx_pipe_pending |
| 图表 | mon_pipeline_chart (100px) |
4) 存储
| 项目 | ID |
|---|---|
| 总存储 | side_jmx_store_saved |
| 写入/秒 | side_jmx_store_wps |
| 缓冲等待 | side_jmx_store_buf |
| 活动批次 | side_jmx_store_batch |
| 图表 | mon_storage_chart (100px) |
5) 消息
| 项目 | ID |
|---|---|
| 总接收 | side_jmx_msg_total |
| 每秒接收 | side_jmx_msg_rate (/s) |
| KAFKA | side_jmx_msg_kafka |
| MQTT | side_jmx_msg_mqtt |
| 图表 | mon_msg_chart (100px) |
6) 流式处理、异步、诊断
界面其他区域连续显示流式处理、异步执行器、诊断计数(仪表板 — 右侧健康栏 中的同一系列运行指标)。
日志界面 (/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)
用于新增、修改、删除系统运行所需的键值配置,并重新应用缓存的界面。
顶部工具
🎚️ 시스템 설정 [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
| 控件 | 宽度 | 说明 |
|---|---|---|
配置键搜索 (search_keyword) | 200px | placeholder: “配置键搜索 ...” |
| 查询 | 红色 + 🔍 | search() — 应用关键词过滤 |
| 刷新 | 红色 + ↻ | refresh() |
| 新增配置 | 红色 + ➕ | addConfig() — 打开新增配置表单 |
| 重新应用 | 蓝色 + 🔄 | refreshCache() — 无需重启服务器即可重新应用配置缓存(提示:“无需重启服务器即可重新应用配置缓存。”) |
配置列表表格
| 列 | 宽度 | 说明 |
|---|---|---|
| 配置键 | 300px | 系统识别的键(例:engine.timeout.ms) |
| 配置值 | 600px | 该键的当前值 |
| 说明 | 自动 | 键用途备注 |
| 修改日期 | 150px | 最后修改时间 |
| 操作 | 80px | 修改、删除按钮 |
页面底部显示提示框。
ℹ️ 系统配置说明 管理系统运行所需的键值配置。配置变更后,部分项目可能需要重启服务器。
配置新增/修改表单
通过顶部的 新增配置 或列表中的操作按钮进入配置表单界面(/config/form)。
| 输入项 | 说明 |
|---|---|
| 配置键 | 仅可使用英文/数字/./_。例:engine.timeout.ms |
| 配置值 | 文本(数字、boolean、JSON 均可,取决于键定义) |
| 说明 | 自由文本(便于操作员识别的备注) |
保存后如需立即生效,请返回列表界面并点击 重新应用。部分配置可能需要重启服务器。
环境信息界面 (/env/view)
以分组标签页查看平台启动时读取的属性文件的只读界面。
顶部提示框
❓ 系统环境信息 按属性文件显示服务器系统中设置的环境信息。如需变更环境配置,请修改对应文件。
- 配置变更后需要重启服务器。
6 个标签页构成
| 标签页 | 显示 |
|---|---|
| 引擎 | 引擎核心运行配置(时间/线程/队列上限等) |
| 应用 | Web 应用通用配置 |
| 消息队列 | 消息通道连接配置(代理主机、认证、主题等) |
| 存储 | 时序、事件存储连接配置 |
| 邮件 | 邮件发送 SMTP 配置 |
| WebSocket | 实时推送通道配置 |
各标签页的表格(通用)
| 列 | 显示 |
|---|---|
| 键 | 属性键 |
| 配置值 | 当前值(已掩码的密码显示为 ***) |
环境信息界面无法修改值。如需变更,须由系统管理员直接修改服务器上的相应属性文件后重启服务器。
应用场景
| 场景 | 界面 | 步骤 |
|---|---|---|
| PPS 低于平常水平 | 监控 | PPS 面板图表 → 基础设施健康六分格 → 在数据管道示意图中识别瓶颈节点 |
| GC 时间过长 / 疑似内存泄漏 | 监控 | JVM 堆面板的 GC 时间趋势 → 通知系统管理员 |
| 确认服务器启动后是否正常运行 | 监控 | 顶部启动时间 + 基础设施健康 6 格全部正常 + 连接热力图为绿色 |
| 追踪特定类的 ERROR | 日志 | 级别=ERROR + 在消息搜索中输入类名关键词 → 分析含行号的日志 |
| 临时应用配置变更 | 配置 | 新增/修改配置 → 重新应用(无需重启) |
| 变更密码策略、会话时长 | 环境信息 | 在应用标签页确认当前值 → 系统管理员修改文件 → 重启服务器 |
| 在连接热力图中识别红色块 | 监控 | 点击红色块 → 在新窗口打开数据源详情界面 |
常见问题
Q. 监控界面与诊断界面有何不同? A. 监控 展示平台自身的实时运行指标(吞吐量、内存、健康状态),诊断 展示各模块的 INFO/WARN/ERROR 事件日志。两者都供系统管理员使用,但监控回答“现在怎么样?”,诊断回答“发生了什么?”。
Q. 监控的基础设施健康中有一格显示为红色。 A. 表示该组件无响应或健康检查失败。请立即在 诊断 界面查看 SERVER 或该组件的 ERROR 日志,并同时通知系统管理员。
Q. 数据管道示意图中的节点是灰色的。 A. 表示该阶段未启用或没有待处理数据。有些阶段平时为灰色属正常(例如备份、归档);若在数据接入时段仍为灰色,则可能存在问题。
Q. 连接热力图中某个块为红色。
A. 表示该数据源的连接处于异常状态。可点击色块进入详情界面(/connect/view),或在 连接管理 > 状态 界面查看左侧 24 小时历史。
Q. 日志界面和诊断界面该看哪个? A. 异常信号追踪看 诊断,代码级调试看日志。若诊断中捕获到 ERROR 但信息不足,可在同一时间点于日志界面进一步查看该类/方法的详细日志。
Q. 配置界面的“重新应用”按钮安全吗? A. 它仅刷新内存缓存,无需重启服务器。对大多数配置是安全的,但部分配置(线程池大小、DB 连接池等)需要重启。若重新应用后未达到预期效果,请咨询系统管理员。
Q. 我想在界面上修改环境信息的值。 A. 环境信息界面为只读。变更需修改服务器端属性文件后重启服务器。可在界面上修改的键值请在 配置 界面管理。
Q. 日志的“全部导出”CSV 文件过大。 A. 请缩短搜索条件的时间范围(1 小时以内),并将级别缩小至 ERROR/WARN 后重新下载。或下载 CSV 后使用外部分析工具处理。
Q. 监控界面会自动刷新吗? A. 监控通过实时推送自动刷新。若指标停滞不动,请先确认页头的实时连接状态是否为红色。