plantpulse-timeseries (時系列)

役割

時系列データ専用エンジン(TSE)と Grafana ダッシュボードです。タグ値を Cassandra に行単位の TTL で保存し、集計・照会 API を提供します。

項目	値
モジュール名	`plantpulse-timeseries`
インストール経路	`/opt/kopens/plantpulse-platform/plantpulse-timeseries/`
エンジンポート	7800 (HTTP) · 7801 (TLS)
UI ポート	3000 (Grafana, TLS のみ)
`pd` サービス	`timeseries` — MASTER のみ (2026-09-05 から)。engine(`tse`) → dashboard(`grafana`)
アカウント	`PP_TSE_USER` / `PP_TSE_PASSWORD`

ワーカーでは起動しません (2026-09-05)

ワーカーのエンジンは誰も読まず、マスターが既に書き込んだ行を同じリング上に再びコピーするだけでした(実測 4.4G)。すべての照会コンシューマーがマスターのエンジンを指しているため、MASTER 専用になりました。

構成

ディレクトリ構造

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 ひとつで、2つのファイル名でレンダリングされます。主要項目:

項目	値
`jetty.port` · `jetty.ssl.port`	`PP_TSE_PORT`(7800) · `PP_TSE_TLS_PORT`(7801)。TLS はプラットフォーム共用 keystore
`service.datastore`	Cassandra モジュール — テーブル `pp.ts_data_points` など、`UnifiedCompactionStrategy`
データポイント TTL	`PP_TSE_DATAPOINT_TTL` — デフォルト 31536000秒(365日)。書き込みごとに刻まれるため、新しい値は新しい行から
認証	`PP_TSE_USER` / `PP_TSE_PASSWORD` — `passwd.sh` 対象ではなく、サイドカー更新 + 再起動

curl -fsS http://127.0.0.1:7800/api/health          # 컨테이너 안
curl -kfsS https://<server-ip>:7801/api/health         # 밖에서 — 401 은 «로그인 필요» 이지 «없음» 이 아닙니다

管理コンソールのツール画面 «Timeseries Engine» カード(7801)は エンジン自体 の管理画面です。時系列 データ を見る場所は Grafana です。

Grafana (3000)

https://<server-ip>:3000/ — TLS のみで応答します。http:// で開くと 400。

ログインアカウントは Grafana 自身の DB にあり、データレイクは 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/O	`pd flow`, `pd node compactionstats`
データが数日で消える	TTL	`PP_TSE_DATAPOINT_TTL` — 古いイメージは 31日リテラルでした。既に書き込まれた行は古い値で満期になります
Grafana ログイン失敗	コンテナ再生成でアカウントが戻る	上記警告。デフォルト値で再ログイン
`http://…:3000` が 400	TLS のみ	`https://`
ダッシュボード応答が遅い	時間範囲過多	範囲短縮、集計間隔拡大

役割​

構成​

ディレクトリ構造​

時系列エンジン (7800 · 7801)​

Grafana (3000)​

運用コマンド​

よくある問題​

関連ドキュメント​

役割

構成

ディレクトリ構造

時系列エンジン (7800 · 7801)

Grafana (3000)

運用コマンド

よくある問題

関連ドキュメント