管理控制台
这是数据湖节点的运营控制台。通过浏览器可以在一个画面中查看状态、指标、日志、诊断、设置、备份和 Worker，执行允许的 pd 命令，并向外部监控系统（Grafana · Prometheus · Zabbix）提供同一地址的健康 API。
| 项目 | 值 |
|---|---|
| 后端模块 | plantpulse-datalake-admin-api |
| 运行位置 | plantpulse-datalake 容器内 — Master · Worker 节点均适用 |
| 地址 (TLS) | https://<server-ip>:4950/ |
| 地址 (明文) | http://<server-ip>:4949/ — 相同控制台 · 相同 API |
| 登录 | PP_DATALAKE_ADMIN_USER(默认 admin) / PP_DATALAKE_ADMIN_PASSWORD |
| 默认语言 | 英文。加上 ?lang=ko 则为韩文 |
本节文档
| 画面 | 功能 |
|---|---|
| 本页 | 控制台概览 — 访问 · 登录 · 画面构成 |
| 批处理 | 批处理作业的状态与历史 |
| 仓库 | 仓库加载状态 |
| 助手 | 当前问题及原因分析、应对方案 — 自然语言问答与审批卡片 |
访问
在浏览器中通过两个地址之一进入。两者为同一个控制台，仅方案（scheme）不同。
https://<server-ip>:4950/?lang=ko # TLS — 권장
http://<server-ip>:4949/?lang=ko # 평문 — 4950 으로 리다이렉트하지 않습니다
登录密码和会话 Cookie 将以明文形式传输。在不可信网络中请务必使用 4950。保留 4949 并非失误而是刻意选择 — 因为自签名证书警告有时会成为阻止运营商操作的障碍。
通过 TLS 访问时可能会出现自签名证书警告。更换为正式证书的方法请参阅 安全设置。
登录
登录画面将同时显示该节点名称和角色 (Master / Worker)。在打开多个节点进行操作时，请确认当前操作的是哪个节点。
| 变量 | 默认值 | 说明 |
|---|---|---|
PP_DATALAKE_ADMIN_USER | admin | 登录名称 |
PP_DATALAKE_ADMIN_PASSWORD | 2026-09-05 后安装版本为开发默认值，此前版本为空 | 若为空则控制台无法打开 |
PP_DATALAKE_ADMIN_API_KEY | 无 | 机器调用日志端点时的 X-API-Key |
更改密码或首次设置方法请参阅 Web 画面登录账户 — 管理控制台。
这意味着 PP_DATALAKE_ADMIN_PASSWORD 为空。此时仅控制台无法开启，数据湖仍正常运行。这并非故障而是委任（commissioning）时的遗漏，请填写值后重启。
画面构成 — 导轨与侧边栏
| 编号 | 内容 |
|---|---|
| ① | 图标导轨 — 在不同组之间切换。仪表盘图标中的一个小点即为此节点的综合判定（详见下方） |
| ② | 单行概览 — 「N 个组件全部正常 · 服务 N/N · 无报警」. 此行若为绿色则无需进一步查看。下方行为此节点的名称 · 角色 · 地址 · 节点数，[节点列表] 可跳转至拓扑结构的节点页签 |
| ③ | 数据路径 — 按启动顺序排列的阶段（Messaging → CEP → 时序 → Storage → Workflow → 分析 → 数据网关）以及每个阶段的 «运行中 / 总数» 服务数量。箭头表示声明的路径而非实际吞吐量 — 实际处理率请见下方的流入流量卡片 |
| ④ | 服务 — 按顺序展开 ③ 中阶段所属的服务。对于像 «Messaging 3/4» 这样有空缺的阶段，在此查找具体是哪个服务 |
| ⑤ | 组件健康 — 全部 · 异常 · 注意 · 未测量 · 正常 · 停止。未测量不等于 «正常» |
| ⑥ | 时间线 — 将各组件状态绘制在时间轴上（24小时 / 48小时）。斜线表示无记录区间 |
| ⑦ | 语言切换 — EN / KO. 在地址中加上 ?lang=ko 效果相同 |
报警卡片仅在有触发报警时出现在 ② 和 ③ 之间（仅限连续三次超过阈值的情况）。若无报警则不绘制卡片，因此图中未显示。⑥ 下方依次为系统量程 · 流入流量 · 负载 · 存储 · 最近事件。
左侧的窄纵向条为导轨，包含 9 个组的图标。导轨仅显示图标 — 悬停鼠标时通过工具提示显示名称。
选择某个组后，该组的画面将在侧边栏中展开。但仅有一个画面的组没有侧边栏 — 因为没有可选项，仅会占用空间。
导轨的顺序是故障排除时人员询问的顺序 — «现在是否有异常» → «哪里异常» → «什么是真实的» → «通知谁» → «更改什么» → «命令» → «跳转其他画面» → «发生了什么».
共有 22 个画面，分为 9 个组。
| 组 | 区域 | 画面 | 解决的问题 |
|---|---|---|---|
| 概览 | — | 仪表盘 | 现在是否有异常 |
| 拓扑 | — | 拓扑 (页签: 数据流 · 节点) | 流水线的哪里堵塞了，其他部分数据是否流动 |
| 观测 | 状态 | 状态 · 指标 | 当前判定及过去一小时至一周的趋势 |
| 资源 | 存储 · 保留 | 卷 · WAL · 复制槽 · 存储大小 / 什么时间删除什么 | |
| 活动 | 工作流 · 事件 · 日志 · 诊断 · 作业 | 夜间作业是否运行，发生了什么 — 事件日志, 服务日志, pd doctor, 作业历史 | |
| 报警 | — | 报警 | 通知谁, 何时通知 |
| 运营 | 设置 | 设置 · API 密钥 · 证书 | 模板与渲染结果的 diff, 模板编辑与回滚 · 控制台颁发的 API 密钥 · 证书 |
| 维护 | 升级 · Worker | 各模块版本, 针对集群 Worker 需更改的内容 | |
| 备份 | 备份 | 备份集 · 计划编辑 · 执行 · 还原 | |
| 命令 | — | 命令 | 在画面中执行允许的 pd 谓词 |
| 工具 | — | 工具 | 跳转至其他产品 Web UI 的卡片 |
| 记录 | — | 审计 | 在此控制台中谁更改了什么 |
| 助手 | — | 助手 | 当前问题及原因分析、应对方案 — 直至网关设置与审批卡片 |
导轨的点读取方法
导轨上的点仅在仪表盘图标上出现。无论在哪个画面，它都显示 「此节点是否有异常」，其值为 /api/health 的 status，即服务器对组件的综合判定。详细内容请在仪表盘中查看。
| 点 | 含义 |
|---|---|
| OK | 服务器综合判定为正常 |
| WARN | 服务器综合判定为警告 |
| FAIL | 服务器综合判定为失败 |
| UNKNOWN (灰色) | 判定不可信 — 轮询停止、服务器采集器停止、无响应或未知判定 |
灰色点表示**「未测量」而非 «正常»**。其他组的图标没有点，这不意味着该组正常，而是表示不在导轨上绘制该组的状态。
静默并不代表正常。 静音 · 规则关闭 · 低于最小严重级别 · 抑制区间 · 无通道 — 报警不发出声音有五种原因，控制台将这五种原因分别用不同的句子告知。
各画面注意事项
| 画面 | 注意事项 |
|---|---|
| 拓扑 | 两个页签是一个系统的两种视图 — 数据流 (MQTT → Kafka → 消费者) 和节点 (Master · Worker)。当仪表盘显示 «有异常» 时，在此确认哪个区间有问题 |
| 状态及信息 → 组件 | 点击行可进入组件详情。与 pd status 表为同一行，每 15 秒更新一次。启动后前几十秒的 STOPPED 为窗口期 |
| 日志 | 仅显示 pd logs --list 声明的文件。此处不含 App 容器 (服务器 · 批处理 · 仓库) 的日志 — 请使用宿主机的 logs.sh |
| 诊断 | pd doctor 的结果。«执行检查» 按钮可立即再次运行。一次仅接收一个请求，若出现 «busy» 请稍后重试 |
| 作业 | 在一处查看备份 · 归档 · 维护作业的历史。备份画面仅查看备份相关 |
| 设置 | 「现在渲染会改变什么」(pd config diff) 和 「我的模板是否与镜像默认值不同」(pd config diff --templates)。在画面中修改模板会保留版本记录，可回滚。值的正本（密码 · 地址）仍在宿主机 → 更改设置方法 |
| 升级 | 镜像标签 (/etc/plantpulse-image.env) 和各模块版本/修订版本 (/etc/plantpulse-modules.json)。仅供查看，不执行升级 → 下方 |
| Worker | 仅显示针对集群 Worker 应执行什么命令，不实际执行。 执行在宿主机中完成 → 集群安装 |
| 备份 | 集合列表 · 计划 · 当前运行项。«Schedule editor» 调用 pd backup schedule set。日程并非由 systemd timer 决定，而是 backup_schedule 表 + Quartz → 备份 · 还原 |
| 命令 | 仅执行服务器定义的允许列表中的 pd 谓词（列表直接显示在画面右侧）。其他命令在容器 Shell 中执行 → pd CLI · 下方 |
| 工具 | 将其他产品的 Web UI 汇总为卡片并在新页签中打开。 地址中的主机名随当前访问的主机而变，因此在任何节点打开均会进入该节点的工具。不存在的服务不绘制卡片 |
| 工作流 | 同时查看 Temporal 和 Kestra 两者。只读 — 此画面不执行触发 · 暂停 · 终止操作。「不适用» 意味着尚无执行记录，无需判定 |
| 保留 | 将表 TTL · 主题保留 · 冷层 · 归档作业汇总在一处。「无» 表示无过期时间的表（计数器 · 当前值） |
| 凭据 | 无独立画面。在 状态及信息 → 组件 详情卡片中逐条查看并更改该组件的值 → 下方 |
| 助手 | 对此节点进行口语询问，并通过审批卡片执行。需直接连接 LLM 网关 → 助手 |
| 审计 | 记录在此控制台中谁更改了什么。Worker 节点无审计存储，始终显示 «无法读取» — 这并非一个安静的星期 |
主要画面
拓扑 — 查看流水线哪里堵塞。包含数据流和节点两个页签。
状态及信息 — 各组件判定。与 pd status 为同一行，每 15 秒更新一次。最下方的 组件版本 表显示的是当前版本的构成而非此节点 — 官方版本 · 内部版本 · 端口 · 许可证 · 来源 · 模块。- 表示不适用（直接使用的组件无内部版本，部分组件无监听端口）。组件详情中显示相同值。
工作流 — 查看夜间归档和批处理流是否按时运行。同时查看两个引擎： Temporal (Aster TSDB → Iceberg 归档) 和 Kestra (批处理流)。
执行由引擎完成。此画面不执行触发 · 暂停 · 终止操作 — 仅供查看。更改计划的位置在备份画面 (或 pd backup schedule set)。
保留 — 什么时间删除什么。将 Aster TSDB 表 TTL 和大小、Kafka 主题保留、冷层及其填充归档作业汇总在一个画面。
pp.tm_tag_point 的 TTL 显示为 3650天。更改方法请参阅 数据保留周期。
设置 — 「现在渲染会改变什么」和 「我的模板是否与镜像默认值不同」。
备份 — 集合列表 · 计划 · 当前运行项。
工具 — 将其他产品 Web UI 汇总为卡片并在新页签中打开。
审计 — 记录在此控制台中谁更改了什么。
尚未提供数据的画面会告知为空，并同时注明这并不意味着 «无异常»。请勿将空白画面解读为正常。
观测组的四个画面
之前的「主要画面» 处理 «哪里错了」，而观测组的四个画面回答 «为什么». 这四个画面均来自 观测 → 状态 / 资源 / 活动 侧边栏。
指标 — 单个组件的测量历史
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 侧边栏 | 观测组的画面 — 状态及信息 · 指标 / 存储 · 保留 / 工作流 · 事件 · 日志 · 诊断 · 作业 |
| ② | 左侧 | 组件列表 — 选择其中一个 |
| ③ | 列表下方 | 灰色组件的含义，以及一次仅查询一个的指南 |
| ④ | 右上 | 区间 — 1小时 · 6小时 · 24小时 · 48小时 · 7天 |
| ⑤ | 正文 | 按单位分组的图表 (% · B/S · BYTES · LOAD …) |
仪表盘是无需选择即可阅读的分类画面，因此没有超过一天的区间。 此画面相反，是选择单个组件 · 单个区间进行深度挖掘。
超过 7 天的区间，以及非数据湖自身的 «工厂数据» 属于 PlantPulse Dashboard 的职责。 此画面故意未提供 「在 PlantPulse Dashboard 中打开」的链接 — 因为链接到未确认是否存在的仪表盘还不如没有链接。
组件被涂灰仅在收到该组件响应且响应为 「未采集» 时。对于尚未有人打开的组件不作标记 — 因为凭猜测涂色将成为另一种 «编造的判定».
一次仅查询一个组件。选择其他组件时，请求将转移而非增加。
存储 — 磁盘中有什么，保留多久
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 侧边栏 | 资源区域 — 存储 · 保留 |
| ② | 最上方 | 卷 — 运行时树 · 数据 · 临时 · 备份各自的使用率与判定 |
| ③ | 下方 | PostgreSQL WAL 与复制槽 — PG_WAL · MAX_SLOT_WAL_KEEP_SIZE · MAX_WAL_SIZE · 角色, 以及槽表 |
| ④ | 左下 | Aster TSDB 磁盘 — 数据 · 提交日志 · 快照及按键空间(keyspace)划分的大小 |
| ⑤ | 右下 | Kafka 磁盘 — 配置文件 · 日志目录 · 大小 · 保留 · 最早段(segment) · 下次清理预计 |
2026-09-03 曾发生实际事件。复制槽 replica_worker_1 在非活动状态下占用 1.4 GB 的 WAL，且 max_slot_wal_keep_size 为 -1 (无限制)。
产品中没有任何画面告知此事，运营商察觉该问题的唯一方法是磁盘被填满。
因此画面顺序设计如下 — 卷(是否填满) → WAL·槽(谁在占用) → 存储大小与保留(是否在减少)。请结合查看槽表的 «活动» 与 «占用 WAL»。
事件 — 此节点发生的事
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 上方 | 范围 — 24小时 / 7天 |
| ② | 旁边 | 种类筛选 — 报警发生·解除 · 启动·已启动 · 停止·已停止 · 重启 · 备份启动·结束 · 作业启动·结束 · 引导 · 部署 · 运营商 · PD |
| ③ | 卡片头 | 事件 (N) — 当前范围内的数量 |
| ④ | 表头 | 时间 · 种类 · 组件 · 严重等级 · 消息 |
| ⑤ | 正文 | 像失败备份这样的 ERROR 行将被涂为红色 |
审计记录附在同一画面下方。 「发生了什么» 与 「我们做了什么» 在故障期间是同一个问题，若分在两画，则需查看两次时钟。通过在同一时间范围内下方续接，使 01:25 的重启操作与其执行的运营商并列显示。
存储为 memory 的节点仅在 RAM 中持有最近几百条记录，重启后丢失。 画面将通过一行文字告知此情况 — 请勿将半截历史视为完整历史。
无法读取的事件存储不会被绘制成 «安静之夜»。 加载中 · 有事件 · 范围为空 · 尚未提供的端点 · 未测量 (含理由) 这五种情况分别以不同方式绘制。
报警 — 定义什么为报警，以及如何通知
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 最上方 | 活动报警 — 当前触发项。若无则显示 「无活动报警」 |
| ② | 中间 | 规则 卡片 |
| ③ | 表头 | 组件 · 通知 · 连续 · 抑制(秒) · 异常时 · 来源 · 动作 |
| ④ | 行 | 单个组件的规则。通过 [修改] 仅更改该行 |
| ⑤ | 下方 | 通道 卡片 + [添加通道] — 「已开启通道 N 个」 |
| ⑥ | 更下方 | 若无通道则明确告知 |
将三张卡片放在一个画面中，是因为这在询问一个问题三次 — 现在是否有异常 (活动) · 将什么定义为异常 (规则) · 谁在接收通知 (通道)。若将三者分开，处于静默状态的第三项将无人查看。
活动报警不发出声音有五种原因，画面将分别用不同的句子标注。
| 画面文字 | 含义 |
|---|---|
| 已静音 | 由人员关闭了该报警 |
| 规则已关闭 | 规则表的 «通知» 状态为关闭 |
| 低于最小严重等级 | 未达到规则的 «异常时» 标准 |
| 处于抑制区间内 | 在规则的 «抑制(秒)» 窗口内 |
| 无通道 | 无发送目标 |
头部将同时显示 「其中 N 个为静默」。不使用单一 «静音» 徽章是因为五种情况的应对措施各不相同。
此外，无法读取设置的情况不会被绘制为 «无设置»。 服务器提供 store: "NA" 及其理由，则在表上方标注该句子 — 不会像刚安装一样绘制空白画面。在无法保存设置的节点中，编辑按钮将消失。因为可点击的灰色按钮会答复 «已保存» 但实际上不更改任何内容。
活动组的四个画面 — 发生了什么
作业 — 将所有耗时任务记录在一个账本中
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 最上方 | 当前运行中 — 若无则告知 |
| ② | 下方 | 种类 · 状态筛选 — 备份 · 还原 · 还原计划 · Dump · 诊断 · 启动 · 停止 · 重启 · 设置渲染 · PD / 运行中 · 成功 · 失败 · 未知 |
| ③ | 卡片头 | 历史 (N) |
| ④ | 表头 | 状态 · 种类 · 目标 · 开始 · 耗时 · 主体 · 来源 · 消息 |
| ⑤ | 失败行 | 失败原因显示在同一行 — 例：「exit 0 但存储未增长 — 无任何写入」 |
| ⑥ | 未知行 | 「pd restart 不写入完成行 — 结果不在日志中」 |
| ⑦ | 来源列 | 备份账本 / pd 日志 — 标明来自哪个账本 |
备份 · 还原 · Dump · pd doctor · 服务操作均需数分钟，结束后的记录分别留在不同地方 — 控制台作业账本、备份账本，以及针对非浏览器启动执行的 pd 自身日志。之前每个画面仅显示自身部分，导致 «今日该节点运行了什么且是否成功» 只能通过审计日志回答，但审计日志记录 HTTP 调用，不记录结果。
采用独立结果绘制。例如 pd restart 不留下完成行，因此结果不在日志中 — 将其涂为成功或失败均属谎言。
此处不执行任何启动 · 取消 · 重试操作。 这些操作在已注明确认步骤和影响范围的画面（备份 · 诊断）中进行。没有取消按钮是因为此服务器没有执行取消的端点。
日志 — 此节点 «拥有» 的日志
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 左侧头 | 日志列表 |
| ② | 第一行 | 带有 引导 徽标的启动日志 |
| ③ | 列表 | 组件 · 文件名 · 大小 · 最后更新 |
| ④ | 右侧头 | 日志内容 |
| ⑤ | 查找 | 字符串 — 字面量而非正则表达式 · 级别芯片 (TRACE · DEBUG · INFO · WARN · ERROR) |
| ⑥ | 期间 | 从 ~ 到 · [搜索] · [清除] |
| ⑦ | 右上 | 换行 开关 |
客户端不传递路径。 发送服务器颁发的 id，路径由服务器持有 — 完全不存在可用于逸出的 ?path= 等参数。
日志正文仅以文本形式绘制。由于日志单行内可能包含 <script>，执行该日志查看器的环境是运营控制台打开的孔径。
结果分为三种而非两种 — 已读取 / 服务器无法询问 pd / 已声明但文件不存在。后两者不绘制为 «此节点无日志» 或 «空文件»，而绘制为未测量。
列表中仅显示 pd logs --list 声明的文件。App 容器 (服务器 · 批处理 · 仓库) 的日志不在其中 — 请使用宿主机的 logs.sh。
诊断 — pd doctor 测量的内容
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 标题旁 | 模式 — MASTER / Worker |
| ② | 指南 | «最后执行» 说明与 [执行检查] 按钮 |
| ③ | 下方 | 诊断结果 (测量时间) |
| ④ | 摘要 | 失败 · 不适用 · 通过 · 检查数 |
| ⑤ | 组卡片 | 按 inputs · tools … 分组排列 |
| ⑥ | 表头 | 判定 · 检查 · 内容 |
pd doctor 运行全部检查约需 3秒，因此不周期性运行。画面的结果是此节点持有的最后一次执行记录，③ 的时间标明了测量时刻。如需再次测量，请点击 [执行检查] — 一次仅运行一项，若出现 «busy» 请稍后重试。
答案有五种且分别绘制 — 端点尚未提供 / 会话断开 / 请求失败 / 命令根本未运行(必须含理由) / 命令已运行但检查数为 0.
尤其是后两者至关重要。文档状态为 na 的情况并非 «全部通过» — 而是未测量任何内容，且必须附带理由。检查列表为空是另一种情况。若将两者绘制为相同空白面板，则会导致用户在未测量任何内容的画面中解读出 «无异常»。
«不适用» 项的每一行均附带理由 — 画面将对此进行引导。
Worker — 仅 «显示» 命令
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 卡片头 | Worker (测量时间) |
| ② | 表头 | Worker · 地址 · 名簿 · Ring · PostgreSQL · 槽 · Redis · 健康 · 状态 |
| ③ | 行 | 单个 Worker。复制槽名称与滞后量显示在同一行 |
| ④ | 下方 | Worker 健康 — 展开后显示详情 |
| ⑤ | 下一张卡片 | 测量了什么 |
| ⑥ | 通过项 | Worker 名簿 (/etc/kopens/workers.roster) · Aster TSDB Ring · PostgreSQL · Redis 副本 · Worker 健康代理 · 此节点自身地址 |
| ⑦ | 不适用 | Worker 容器 · Worker 卷 — 直接记录理由 |
增删 Worker 的命令 (worker-add.sh · worker-decommission.sh · worker-remove.sh) 涉及 Docker 守护进程 · 名簿文件 · compose 覆盖层，这三者均在宿主机中。此画面背后的 API 运行在数据湖容器内，无 Docker Socket。
因此通过四项措施维持区分 —
- 无动词形式的控件。 画面唯一的按钮是复制
- 所有命令均带有 「在宿主机执行」 标题和工作目录
- 命令显示期间，始终附带只读指南，且该文字来自服务器 — 确保画面不会与 API 主张冲突
- 若上述三项被破坏，构建将失败
若无变更项，则不出现命令卡片 — 如上图所示。
上图中的 Worker 容器 · Worker 卷 便是如此。理由直接写明 — 意味着 Docker Socket 未挂载至此容器，因此此处无法查看，而非没有问题。
运营·命令两个画面与凭据
这些功能偏向更改侧，因此 «不做什么» 比 «显示什么» 更重要。
升级 — 仅供查看
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 侧边栏 | 运营组 — 设置 / 升级 · Worker / 备份 |
| ② | 卡片头 | 当前此节点 |
| ③ | 镜像标签 | 构建名称 · build.version · 烧录提交 · 构建日期 · 读取位置 (/etc/plantpulse-image.env) · 判定 |
| ④ | 下方 | 说明镜像摘要需在宿主机确认 — 镜像内部无法得知 |
| ⑤ | 下一张卡片 | 构成此镜像的项目 — 「N 个项目中有 M 个在此标明修订版」 |
| ⑥ | 表 | 项目 · 判定 · 版本 · 修订版 · 读取位置 (MANIFEST · build-info.json · dist.env … 按项目而异) |
发往服务器的唯一按钮是预检查，且该操作为只读诊断 (pd doctor)。命令块中的控件仅有复制一个，且该按钮在任何语言中均称为 «复制» — 而非 «执行» 或 «应用».
且 «已是最新» 类的句子完全不在 Bundle 中。 此节点既无法查看自身运行的镜像标签，也无法查询已发布的版本。安抚性文字将变成谎言，导致运营商停止进一步寻找 — 这是该画面最危险的欺骗，故完全不予创建。
pd doctor测量约需 3 秒，因此不周期性运行。 点击按钮后作为作业运行并对该作业进行轮询。
命令 — 非 Shell
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 最上方 | 常驻指南 — 「仅执行指定命令」 |
| ② | 终端头 | 控制台名称与状态点 — 准备 · 发送中 · 流式传输 · 断开 |
| ③ | 正文 | 输出 (回滚 · ANSI 颜色) |
| ④ | 最底行 | 提示符 — Tab 补全 · ↑↓ 记录 · Ctrl+L 清除 |
| ⑤ | 右侧头 | 「只读 N 个, 更改节点 M 个」 |
| ⑥ | 右侧 | 只读 谓词 (help version status storage flow env doctor config list config diff node status logs --list backup list backup status backup schedule) |
| ⑦ | 下方 | 更改节点 — 用红框区分 (config render) |
仅在体感上像终端 — 记录 · 回滚 · ANSI 颜色 · Tab 补全。实际运行的仅为服务器强制执行的 pd 允许列表。
误将其视为 Shell 的人会将拒绝行为解读为 «Bug»。因此指南并非回滚中的彩色单行，而是始终悬浮在画面的元素 — 被滚动条顶上去的警告不再是警告。
允许列表在每次打开画面时从服务器获取。 不在文档或代码中保留副本 — 副本终会过期，且运营商倾向于阅读过期的副本。若无法获取列表，则自动补全关闭并明确告知 — 不使用猜测的列表代替。
更改节点的命令在获得确认后才执行。 若被拒绝，服务器提供的拒绝理由将原样显示在画面上 — 若笼统地显示为 «失败»，则会将产品的安全机制误认为原因不明的错误。
遵循画面指南 — 「此输出的凭据在离开服务器前已被屏蔽». 并非由浏览器接收后隐藏，而是压根没有发送。
凭据 — 组件详情卡片
凭据在使用该值的组件页面中查看并更改。没有独立的凭据画面。在 状态及信息 画面中点击组件行进入详情，即可看到 凭据 卡片；若服务器未为此组件提供凭据，则不显示卡片。
| 列 | 内容 |
|---|---|
| 项目 | 该值为什 — 管理员账户 · 内部 API 密钥等 |
| 环境变量 | 变量名称 |
| 账户 | 账户名称。只读 |
| 密码 / 密钥 | 以点屏蔽，通过 查看值 仅显示单条记录 |
| 连接确认 | 连接已确认 · 值不匹配 · 无法确认 (未连接) · 非连接确认目标 |
| 最后变更 | 最后一次变更时间 |
| 末尾 | [变更], 或无法变更理由 (锁定) |
卡片下方显示该组件的最近三项变更请求，失败的请求可通过 [重新执行] 尝试。完整记录在审计画面中。
列表中不包含敏感值。 点击 查看值 将仅以该变量名为参数单独发送请求并获取单个值。此请求为 POST，故记录在审计中，且变量名不出现在地址栏中。
[变更] 不会立即更改值。面板首先显示执行顺序，选择 生成 (32位) 或 输入值 后，再次输入 控制台密码 和 变量名称 才能进入队列。
- 加密存储新值并将变更放入队列
- 在数据湖内部，将其应用于所有确认或读取该值的位置
- 以新值重新启动数据湖的所有服务 — 将中断数分钟。 接收此值的其他产品将在重建自身容器时接收新值
- 确认各组件是否能以新值连接。若阶段失败，请求状态为失败，并以相同值重新执行
控制台仅有一个账户且无角色划分，登录者可更改所有凭据。再次要求输入密码和变量名是替代性安全机制。由于涉及密码和新值，请在 4950(TLS) 中操作。
生成的值在请求时仅显示一次，无法再次显示。
值栏的空白表示确实为空，而 此处无法读取 表示此控制台无法读取该值。锁定行附带理由 — 账户名称不予更改, 由其他值计算得出, 无可变更的当前值, 尚无变更工具。
在宿主机中更改的步骤请参阅 更改密码。
工具画面的卡片
| 卡片 | 地址 | 内容 |
|---|---|---|
| CEP | https://<호스트>:7401/ | EQL 规则及其匹配的事件 |
| PlantPulse Dashboard | https://<호스트>:3000/ | 时序数据仪表盘 |
| Timeseries Engine | https://<호스트>:7801/ | 引擎本身的管理画面，而非时序数据 |
| Spark | http://<호스트>:4440/ | Spark Master · Worker · 运行中的应用程序 |
| Temporal | http://<호스트>:8233/ | 工作流执行与历史 |
| Kestra | https://<호스트>:8380/ | 数据流水线 — 流 · 执行 · 日志 |
| RustFS | http://<호스트>:9001/ | 对象存储 — 存储桶 · 对象 · 访问密钥 |
| Data Gateway | https://<호스트>:5501/ | SQL 执行控制台。 旧版 SQL 工具卡片已合并至此 (2026-09-07) |
卡片打开的工具中有三项另有单独的使用指南 — 数据网关控制台 · 时序分析器 · CEP 控制台。
具有 TLS 孪生端口的画面将链接至 TLS 端。因为此控制台为 TLS (4950)，故避免传递明文地址。
控制台调用 pd 的频率
控制台画面不会在每次请求时运行 pd。后端采集循环一次处理一个并缓存最后一份文档，画面仅读取该缓存。
| 谓词 | 周期 |
|---|---|
pd status --json · pd logs --list | 15秒 |
pd node status --json · pd storage --json | 30秒 |
pd flow --json · pd config diff --json · pd env --json | 60秒 |
pd doctor --json · pd retention --json · pd config diff --templates --json | 300秒 |
按周期计算，60秒中约有 46 秒用于运行 pd。因此，在运行控制台的节点上，pd status 偶尔响应缓慢属于正常现象。
健康 API
控制台绘制的所有画面均基于 /api/*，完整列表和方案由控制台读取 /api/openapi.json 并以 API 表 形式显示。
curl -kfsS https://<server-ip>:4950/api/health | jq # TLS
curl -fsS http://<server-ip>:4949/api/health | jq # 평문 — 같은 API
docker exec plantpulse-datalake curl -kfsS https://127.0.0.1:4950/api/health | jq # 컨테이너 안 — 어떤 구성에서도
curl -kfsS https://<server-ip>:4950/api/services | jq # 서비스 목록과 상태
宿主机的 status.sh · ops-check.sh · doctor.sh · stack-verify-boot.sh 均读取此 /api/health。/api/health 无需认证即可响应，其余 API 需要登录会话或 X-API-Key (日志端点)。
Prometheus 联动
采集 https://<server-ip>:4950/metrics。若为自签名 CA 则开启 insecure_skip_verify。在随平台附带的 PlantPulse Dashboard (3000) 或外部 Grafana 中将其连接为数据源。
常见问题
| 症状 | 原因 | 措施 |
|---|---|---|
| 控制台无法打开 · «未设置» | PP_DATALAKE_ADMIN_PASSWORD 为空 | Web 画面登录账户 |
| 4949 可用但 4950 不可用 | 证书问题 | 确认浏览器警告或在 安全设置 中更换证书 |
| 健康端点无响应 | 数据湖容器异常 | 宿主机执行 status.sh → logs.sh plantpulse-datalake |
| 整个画面显示 «Not measured» | 轮询停止或镜像版本过旧 | 查看 pd env 的 IMAGE_BUILT_AT。2026-09-04 之前的 admin-api 经常报 «Another job is already running» |
| 工具卡片不显示 | 该服务不在本节点 (Worker) 或轮询无响应 | 跳转至 Master 节点控制台 |
| Prometheus 采集 5xx | 后端模块挂起 | 通过 status.sh 确认依赖模块 |
| 审计画面 «无法读取» | Worker 节点 | 正常 — 请在 Master 节点查看 |
相关文档
- Web 画面登录账户
pdCLI — 控制台显示内容的原始来源- 系统监控 — 各 WebApp 的 readiness 健康检查
- 端口与服务管理