plantpulse-data-gateway (データゲートウェイ)
役割
外部システムとコンソールがデータを安全に照会する HTTP REST + JDBC ゲートウェイです。リポジトリに直接接続せず、このゲートウェイを経由してのみアクセスを許可する、セキュリティ・権限・監査レイヤーであり、2026-09-07 からは コンソールのSQL実行画面でもあります。
| 項目 | 値 |
|---|---|
| モジュール名 | plantpulse-data-gateway |
| インストールパス | /opt/kopens/plantpulse-platform/plantpulse-data-gateway/ |
| ポート | 5500 (HTTP) · 5501 (TLS) |
pd サービス | data-gateway — MASTER のみ |
| API 認証 | X-API-Key: <PP_DATA_GATEWAY_API_KEY> |
| コンソールログイン | PP_DATA_GATEWAY_WEB_USER / PP_DATA_GATEWAY_WEB_PASSWORD — 空の場合、コンソールのみ閉じられます |
構成
4つのバックエンドにJDBCで接続します — そのためコンソールの1画面で SQL · CQL · TQL · Spark SQL を使用します。
ディレクトリ構造
plantpulse-data-gateway/
├── config/ # 생성물
│ ├── plantpulse-jdbc.properties # ← plantpulse-jdbc.properties.template — 백엔드 접속과 계정
│ └── plantpulse-data-gateway.properties # ← plantpulse-data-gateway.properties.template — 제한 · 타임아웃
├── bin/start.sh stop.sh
└── server/ # 내장 Tomcat — webapps/ROOT.war · logs/
主要設定
plantpulse-jdbc.properties.template の核心 — バックエンド4つと資格情報がすべてここにレンダリングされます。
jdbc.postgres.url = jdbc:postgresql://${PP_POSTGRES_HOST}:${PP_POSTGRES_PORT}/${PP_DB_NAME}
jdbc.cassandra.url = jdbc:cassandra://${PP_CASSANDRA_HOST}:${PP_CASSANDRA_PORT}/${PP_SCHEME}
jdbc.tse.url = jdbc:ts://${PP_TSE_HOST}:${PP_TSE_PORT}/${PP_SCHEME}
jdbc.spark.url = jdbc:spark://${PP_SPARK_HOST}:${PP_KYUUBI_PORT}/default/${PP_SCHEME}
data.gateway.api.key = ${PP_DATA_GATEWAY_API_KEY} # X-API-Key
data.gateway.web.user = ${PP_DATA_GATEWAY_WEB_USER} # 콘솔 로그인
data.gateway.web.password = ${PP_DATA_GATEWAY_WEB_PASSWORD}
plantpulse-data-gateway.properties.template — 運用上の制限:
data.gateway.rate.limit=1000 # 초당 요청
data.gateway.slow.query.ms=10000 # 이보다 느리면 슬로우 로그
data.gateway.async.timeout.ms=60000
SQLコンソール
https://<server-ip>:5501/ で開き、PP_DATA_GATEWAY_WEB_USER / PP_DATA_GATEWAY_WEB_PASSWORD でログインします。管理コンソールのツール画面にData Gatewayカードがあります。
パスワードが空の場合、ログインフォームが拒否します。サイドカーに記載して再起動してください → ウェブ画面ログインアカウント
主要API
# 표준 헬스체크 (익명, readiness — DB · InMemory · QueryLog 정상 시에만 UP. 이 경로만 HTTPS 강제 제외)
curl -fsS http://127.0.0.1:5500/api/health
# 200 {"status":"UP","service":"plantpulse-data-gateway-web",…,"checks":{"database":true,"inmemory":true,"query_log":true}}
# 태그 시계열 조회 (API 키 필요)
curl -fsS -H "X-API-Key: ${PP_DATA_GATEWAY_API_KEY}" \
"http://127.0.0.1:5500/api/v1/tags/TAG_001/values?from=2026-05-30T00:00:00Z&to=2026-05-30T23:59:59Z&limit=10000"
# QPS · 지연 메트릭
curl -fsS -H "X-API-Key: ${PP_DATA_GATEWAY_API_KEY}" http://127.0.0.1:5500/api/v1/metrics
運用コマンド
docker exec plantpulse-datalake pd status data-gateway
docker exec plantpulse-datalake pd restart data-gateway
docker exec plantpulse-datalake pd logs --lines 100 data-gateway
頻繁に発生する問題
| 症状 | 原因 | 対処 |
|---|---|---|
| 403 / 401 | APIキー不一致 | passwd.sh PP_DATA_GATEWAY_API_KEY — サーバーとゲートウェイを一緒に |
| コンソールログイン拒否 | PP_DATA_GATEWAY_WEB_PASSWORD が空 | サイドカー + restart-datalake.sh |
| Spark SQL のみ動作しない | Kyuubi未起動 | pd status analytics — 起動直後なら1分後 |
| 応答遅延 | バックエンド負荷 | スローログ、クエリ時間範囲を短縮 |
| 504 | リバースプロキシtimeout | nginx proxy_read_timeout |