plantpulse-data-gateway (Daten-Gateway)
Rolle
Ein HTTP REST + JDBC Gateway für den sicheren Datenzugriff durch externe Systeme und die Konsole. Es fungiert als Sicherheits-, Berechtigungs- und Audit-Schicht, die den direkten Zugriff auf die Speicher verhindert und ab 2026-09-07 auch als SQL-Ausführungsbildschirm der Konsole.
| Element | Wert |
|---|---|
| Modulname | plantpulse-data-gateway |
| Installationspfad | /opt/kopens/plantpulse-platform/plantpulse-data-gateway/ |
| Port | 5500 (HTTP) · 5501 (TLS) |
pd Service | data-gateway — nur MASTER |
| API-Authentifizierung | X-API-Key: <PP_DATA_GATEWAY_API_KEY> |
| Konsolen-Login | PP_DATA_GATEWAY_WEB_USER / PP_DATA_GATEWAY_WEB_PASSWORD — leer → Konsole wird blockiert |
Architektur
Verbindung zu vier Backends über JDBC — daher können Sie in einer Konsole SQL, CQL, TQL und Spark SQL verwenden.
Verzeichnisstruktur
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/
Wichtigste Konfiguration
Kern von plantpulse-jdbc.properties.template — alle Backend-Netzwerke und Anmeldedaten werden hier aufgelöst.
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 — Betriebsgrenzen:
data.gateway.rate.limit=1000 # 초당 요청
data.gateway.slow.query.ms=10000 # 이보다 느리면 슬로우 로그
data.gateway.async.timeout.ms=60000
SQL-Konsole
Öffnen Sie sie über https://<server-ip>:5501/ und melden Sie sich mit PP_DATA_GATEWAY_WEB_USER / PP_DATA_GATEWAY_WEB_PASSWORD an. Sie finden sie in der Verwaltungskonsole auf dem Bildschirm Tools als Data-Gateway-Karte. Das ältere SQL-Tool von plantpulse-sql ist hierin aufgegangen → plantpulse-sql (veraltet)
Wenn das Passwort leer ist, lehnt das Login-Formular ab. Tragen Sie es in den Sidecar ein und starten Sie neu → Web-Interface-Login-Konten
Wichtigste APIs
# 표준 헬스체크 (익명, 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
Betriebsbefehle
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
Häufige Probleme
| Symptom | Ursache | Abhilfe |
|---|---|---|
| 403 / 401 | API-Schlüssel stimmt nicht überein | passwd.sh PP_DATA_GATEWAY_API_KEY — Server und Gateway zusammen |
| Konsolen-Login abgelehnt | PP_DATA_GATEWAY_WEB_PASSWORD leer | Sidecar + restart-datalake.sh |
| Nur Spark SQL funktioniert nicht | Kyuubi nicht gestartet | pd status analytics — bei Start warten Sie 1 Minute |
| Langsame Antwort | Backend-Last | Slow Log, Abfragezeitbereich verkürzen |
| 504 | Reverse-Proxy-Timeout | nginx proxy_read_timeout |