メインコンテンツまでスキップ

管理コンソール

データレイク ノードの運用コンソールです。ブラウザで状態・指標・ログ・診断・設定・バックアップ・ワーカーを1画面で確認でき、許可された pd コマンドを実行でき、同じアドレスで外部モニタリング システム(Grafana・Prometheus・Zabbix)に対してヘルス API を提供します。

項目値
バックエンド モジュールplantpulse-datalake-admin-api (2026-09-03 までは plantpulse-monitor)
どこで動くかplantpulse-datalake コンテナ内 — マスター・ワーカー ノード両方
アドレス (TLS)https://<server-ip>:4950/
アドレス (平文)http://<server-ip>:4949/ — 同じコンソール・同じ API
ログインPP_DATALAKE_ADMIN_USER(デフォルト admin) / PP_DATALAKE_ADMIN_PASSWORD
デフォルト言語英文。?lang=ko を付けると日本語

アクセス​

ブラウザからどちらかのアドレスで開きます。同じコンソールでスキームだけが異なります。

https://<server-ip>:4950/?lang=ko      # TLS  — 권장
http://<server-ip>:4949/?lang=ko       # 평문 — 4950 으로 리다이렉트하지 않습니다
4949 は平文です

ログイン パスワードとセッション クッキーがそのまま流れます。 信頼できないネットワークでは必ず 4950 を使ってください。4949 を残しているのは誤りではなく選択肢です — 自己署名証明書の警告が実際にオペレータの作業を止めるボックスが存在するからです。

TLS でアクセスすると、自己署名証明書の警告が表示される場合があります。実際の証明書に変更する方法はセキュリティ設定にあります。

ログイン​

ログイン画面には、このノードの名前とロール(マスター/ワーカー) が一緒に表示されます。複数のノードを開いて作業する場合、どのボックスかを確認してください。

変数デフォルト値説明
PP_DATALAKE_ADMIN_USERadminログイン名
PP_DATALAKE_ADMIN_PASSWORD2026-09-05 以降のインストール版は開発用デフォルト値、それ以前は空空の場合コンソールは開きません
PP_DATALAKE_ADMIN_API_KEYなしログ エンドポイントを機械が呼び出すときの X-API-Key

パスワードを変更または初回入力する方法は、ウェブ画面ログイン アカウント — 管理コンソールにあります。

「このノードのコンソールが設定されていません」と表示された場合

PP_DATALAKE_ADMIN_PASSWORD が空だということです。コンソールだけが起動せず、データレイクは正常に起動します。障害ではなく、コミッショニング時の漏れなので、値を入力して再起動してください。

画面構成 — レールとサイドバー​

左側の狭い縦帯がレールで、8つのグループがアイコンで配置されます。レールはアイコンのみを表示します — 名前はマウスを乗せるとツールチップで表示されます。

グループを選択すると、そのグループの画面がサイドバーとして展開されます。ただし、画面が1つだけのグループはサイドバーがありません — 選ぶものがないのに枠だけ取るからです。

レールの順序は、障害のときに人が尋ねる順序です — 「今、異常があるか」→「どこが」→「何が真か」→「誰に知らせるか」→「何を変えるか」→「コマンド」→「別の画面へ」→「何があったか」。

グループエリア画面何に答えるか
概要—ダッシュボード今、異常があるか
トポロジー—トポロジー (タブ: データ フロー・ノード)パイプラインのどこが詰まっているか、残りにはデータが流れているか
観測状態状態・メトリック現在の判定と、過去1時間～1週間の推移
リソースストレージボリューム・WAL・レプリケーション スロット・ストレージ サイズ
アクティビティイベント・ログ・診断・ジョブ何があったか — イベント ジャーナル、サービス ログ、pd doctor、バックアップ・アーカイブ ジョブ 履歴
アラーム—アラーム誰に、いつ知らせるか
運用設定設定テンプレートとレンダ 結果の diff、テンプレート 編集とロールバック
メンテナンスアップグレード・ワーカーモジュール別バージョン、クラスタ ワーカーについて何を変える必要があるか
バックアップバックアップバックアップ セット・スケジュール 編集・実行・復元
コマンド—コマンド許可された pd 動詞をスクリーンから実行
ツール—ツール他の製品の Web UI へ遷移するカード
記録—監査このコンソールで誰が何を変更したか

レールのドットの読み方​

レール上のグループ アイコンの横に付いているドットは、そのグループに属する画面の「最悪」状態です。

測定できないものはドットを描きません — 緑ではありません

ポーリングが停止したか、応答が空か、状態が UNKNOWN のコンポーネントはドット自体がありません。 緑に塗りません。つまりドットがないことと緑いドットは異なります。 「何も色がないから大丈夫だろう」と読まないでください — 測定できなかったという意味です。

アラーム グループのドットは、ヘルスではなくアラーム リスト自体を見ます。

ドット意味
FAIL音を出しているアラームが1つ以上ある
WARNアクティブなアラームがあるが、全てミュートされている
OKアクティブなアラームが全くない
ドットなしアラーム ポーリングが停止している — 静かなのではなく見ることができない

静かなのは正常ではありません。 ミュート・ルール オフ・最小重要度未満・抑制期間・チャネルなし — アラームが音を出さない理由は5つあり、コンソールはその5つをそれぞれ異なる文で知らせます。

画面別に知っておくこと​

画面知っておくこと
トポロジー2つのタブは同じシステムの2つの図です — データ フロー(MQTT → Kafka → コンシューマー)とノード(マスター・ワーカー)。ダッシュボードが「異常がある」と言ったら、ここでどの区間かを見ます
状態 → コンポーネント行をクリックするとコンポーネント 詳細に入ります。pd status テーブルと同じ行で、15秒ごとに更新されます。起動直後の数十秒の STOPPED は ウィンドウです
ログpd logs --list が宣言したファイルのみを表示します。アプリ コンテナ(サーバー・バッチ・ウェアハウス)のログはここにありません — ホストの logs.sh を使ってください
診断pd doctor の結果。「検査を実行」ボタンで即座に1度再度実行されます。一度に1つだけ受け取るので、「busy」が表示されたら少し待ってからもう一度クリックします
ジョブバックアップ・アーカイブ・メンテナンス ジョブの履歴を1ヶ所で見ます。バックアップ 画面はバックアップだけを別途見ます
設定「今レンダリングすると何が変わるか」(pd config diff)と「私のテンプレートがイメージ デフォルトと異なるか」(pd config diff --templates)。画面からテンプレートを編集するとリビジョンが記録され、ロールバックできます。値(パスワード・アドレス)の正本は依然としてホストにあります → 設定を変える方法
アップグレードモジュール別の PlantPulse バージョンとコミット。イメージが焼き込む /etc/plantpulse-modules.json を読みます
ワーカークラスタ ワーカーについて何を変える必要があるかコマンドを表示するだけで、実行はしません。 実行はホストで行います → クラスタ インストール
バックアップセット リスト・タイマー スケジュール・実行中のもの。「Schedule editor」が pd backup schedule set を呼び出します → バックアップ・復元
コマンドサーバーが定めた許可リストの pd 動詞だけを実行します(リストは画面に表示されます)。それ以外のコマンドはコンテナ シェルで → pd CLI
ツール他の製品の Web UI をカードにまとめて新しいタブで開きます。 アドレスのホストは現在アクセスしているホストに従うので、どのボックスから開いてもそのボックスのツールになります。このノードにないサービスのカードは描画されません
監査このコンソールで誰が何を変更したか。ワーカー ノードには監査 ストレージがないため、常に「読み込み不可」と表示されます — 静かな1週間ではありません
空の画面が「異常なし」ではありません

まだデータを提供していない画面は空だと知らせながら、それが「異常なし」という意味ではないと同時に説明します。空の画面を正常と読まないでください。

ツール画面のカード​

カードアドレス内容
CEPhttps://<호스트>:7401/EQL ルールとそれがマッチしたイベント
Grafanahttps://<호스트>:3000/時系列 データのダッシュボード
Timeseries Enginehttps://<호스트>:7801/時系列 データではなくエンジン自体の管理画面
Sparkhttp://<호스트>:4440/Spark マスター・ワーカー・実行中のアプリケーション
Temporalhttp://<호스트>:8233/ワークフロー 実行と履歴
Kestrahttps://<호스트>:8380/データ パイプライン — フロー・実行・ログ
MinIOhttp://<호스트>:9001/オブジェクト ストレージ — バケット・オブジェクト・アクセス キー
Data Gatewayhttps://<호스트>:5501/SQL 実行コンソール。 旧 SQL ツール カードはこれに統合されました(2026-09-07)

TLS 双方向ポートがある画面は TLS 側へのリンクです。このコンソールが TLS(4950)なので、平文アドレスを渡さないためです。

コンソールが pd をどのくらい頻繁に呼ぶか​

コンソール画面は、リクエストのたびに pd を実行しません。バックエンドの収集 ループが一度に1つ実行して最後のドキュメントをキャッシュし、画面がそのキャッシュを読みます。

動詞周期
pd status --json・pd logs --list15秒
pd node status --json・pd storage --json30秒
pd flow --json・pd config diff --json・pd env --json60秒
pd doctor --json・pd retention --json・pd config diff --templates --json300秒

周期通りなら、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 を有効にします。プラットフォーム 同梱の Grafana(3000)または外部 Grafana でデータ ソースとして接続してください。

よくある問題​

症状原因対処
コンソールが開かない・「設定されていません」PP_DATALAKE_ADMIN_PASSWORD が空ウェブ画面ログイン アカウント
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」を返しました
ツール カードが描画されないそのサービスがこのノードにない(ワーカー)またはポーリング 無応答マスター ノードのコンソールで
Prometheus スクレイプ 5xxバックエンド モジュール ダウンstatus.sh で依存 モジュールを確認
監査 画面が「読み込み不可」ワーカー ノード正常 — マスターで見ください

関連文書​