跳到主要内容

系统

目录


概述

系统菜单集中管理平台自身的运行状态、安全账户、配置、日志、环境信息与集群。当前左侧菜单的 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🔌 (插头)WebSocketside_jmx_h_stomp
3📡 (卫星天线)MQTTside_jmx_h_mqtt
4🌊 (流)KAFKAside_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说明
当前 PPSside_pps_current每秒采集点数 (p/s)
最大 PPSside_pps_max最近 1 分钟最大值 (p/s)
图表side_realtime_chart (220px)1 分钟折线图

2) JVM 堆

项目ID
已用side_jmx_heap_used
总量side_jmx_heap_total
GCside_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)
KAFKAside_jmx_msg_kafka
MQTTside_jmx_msg_mqtt
图表mon_msg_chart (100px)

6) 流式处理、异步、诊断

界面其他区域连续显示流式处理、异步执行器、诊断计数(仪表板 — 右侧健康栏 中的同一系列运行指标)。


日志界面 (/log/index)

按时间顺序查询服务器应用的代码级日志(类、方法、行号)。与 /diagnostic/index 的诊断日志不同,这是供开发者/管理员用于调试的详细日志。

顶部搜索区域

📋 로그 [기간 ▭▭▭▭] [레벨 ▼] [건수 ▼] [조회] [전체 출력] [↻]
控件宽度说明
期间 (search_time)280px起始~结束(居中对齐,粗体)
级别 (level)100px全部级别/INFO/WARN/ERROR
消息 (message)250px(默认隐藏)关键词搜索。依运行环境决定是否显示
条数 (limit)130px50/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 列)

显示比诊断界面更深一层的代码级信息。

宽度说明
级别80pxINFO/WARN/ERROR 彩色徽章
时间160px日志发生时间
日志类200pxJava 类全名
方法名120px被调用的方法
行号80px源代码行号
消息自动日志正文 + stack trace(如有)

日志类/方法/行号信息便于系统管理员精确定位代码位置进行调试。常规运行异常信号的追踪更适合使用 诊断 界面。


配置界面 (/config/index)

用于新增、修改、删除系统运行所需的键值配置,并重新应用缓存的界面。

顶部工具

🎚️ 시스템 설정 [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
控件宽度说明
配置键搜索 (search_keyword)200pxplaceholder: “配置键搜索 ...”
查询红色 + 🔍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. 监控通过实时推送自动刷新。若指标停滞不动,请先确认页头的实时连接状态是否为红色。


相关界面