跳到主要内容

plantpulse-timeseries (时序)

角色​

时序数据专用引擎(TSE)和 Grafana 仪表板。将标签值以行级 TTL 存储到 Cassandra 中，并提供聚合和查询 API。

项目值
模块名plantpulse-timeseries
安装路径/opt/kopens/plantpulse-platform/plantpulse-timeseries/
引擎端口7800 (HTTP) · 7801 (TLS)
UI 端口3000 (Grafana, TLS 专用)
pd 服务timeseries — 仅限主节点 (2026-09-05 起)。engine(tse) → dashboard(grafana)
账户PP_TSE_USER / PP_TSE_PASSWORD
工作节点上不运行 (2026-09-05)

工作节点上的引擎没有人读取，只是将主节点已写入的行重复复制到同一环中(实测 4.4G)。由于所有查询消费者都指向主节点的引擎，因此现已改为仅限主节点运行。

架构​

目录结构​

plantpulse-timeseries/
├── engine/                    # 시계열 엔진 (Java)
│   ├── bin/
│   ├── conf/plantpulse-timeseries-engine.conf     # 생성물 (옛 이름 timeseries-engine.conf 로도 한 벌)
│   └── logs/
└── dashboard/                 # Grafana
    ├── bin/
    ├── conf/custom.ini        # protocol = https · http_port = 3000
    ├── data/                  # Grafana DB — 이미지 트리 안 (볼륨 아님)
    └── logs/

时序引擎 (7800 · 7801)​

配置模板只有 /etc/kopens/conf/plantpulse-timeseries-engine.conf.template 一个，它被渲染成两个名字的文件。核心项目：

项目值
jetty.port · jetty.ssl.portPP_TSE_PORT(7800) · PP_TSE_TLS_PORT(7801)。TLS 使用平台公共 keystore
service.datastoreCassandra 模块 — 表 pp.ts_data_points 等，UnifiedCompactionStrategy
数据点 TTLPP_TSE_DATAPOINT_TTL — 默认 31536000 秒(365 天)。每次写入时刷新，新值从新行开始计时
认证PP_TSE_USER / PP_TSE_PASSWORD — 不适用于 passwd.sh，需通过 sidecar 更新 + 重启
curl -fsS http://127.0.0.1:7800/api/health          # 컨테이너 안
curl -kfsS https://<server-ip>:7801/api/health         # 밖에서 — 401 은 «로그인 필요» 이지 «없음» 이 아닙니다

管理控制台的工具界面中的«时序引擎»卡片(7801)是引擎本身的管理界面。查看时序数据的地方是 Grafana。

Grafana (3000)​

https://<server-ip>:3000/ — 仅通过 TLS 响应。http:// 打开会返回 400。

登录账户保存在 Grafana 自身的数据库中，数据湖不读取 PP_GRAFANA_* 这样的变量。修改密码的位置在 Grafana 界面中(个人资料 → Change password) → Web 界面登录账户 — Grafana

Grafana 数据在容器重建时不会保留

dashboard/data 已经在镜像树中，因此不是卷。在界面中修改的密码和创建的仪表板在重建容器时会恢复到镜像原始状态。这已被报告为产品缺陷。请将仪表板导出为 JSON 并单独保存。

运维命令​

docker exec plantpulse-datalake pd status timeseries
docker exec plantpulse-datalake pd restart timeseries        # 엔진 + Grafana
docker exec plantpulse-datalake pd logs --lines 100 timeseries
docker exec plantpulse-datalake pd retention                 # ts_data_points 의 크기 · 압축 전략

常见问题​

现象原因处理
Kafka lag 增加引擎处理不足 · Cassandra I/Opd flow, pd node compactionstats
数据几天后消失TTLPP_TSE_DATAPOINT_TTL — 旧镜像是 31 天固定值。已写入的行按旧值过期
Grafana 登录失败容器重建导致账户恢复见上述警告。使用默认值重新登录
http://…:3000 返回 400TLS 专用https://
仪表板响应缓慢时间范围过大缩小范围，增加聚合间隔

相关文档​