ホーム画面
ゲートウェイ Web UI のメインページです。1つの画面にゲートウェイのすべての運用状態をカード形式で表示します。各カードは1秒周期でバックエンド(/monitor/bean)から値を取得して更新され、Sparkplug B カードのみ別途5秒周期(/api/v1/transfer)で更新されます。
左上の PlantPulse ロゴをクリックするか、直接 http://<gateway>/ui/main でアクセスしてください。
- MQTT / Sparkplug B / OPC UA サーバー カード:
app.propertiesの*.enable/host/port/userキーを直接ルックアップします。install.sh がボックスごとにランダムなパスワードを生成するため、user が空であるか、ボックスごとに異なる値が表示されます。 - Docker カード:
/var/run/docker.sockのマウントが必要です。plantpulse-edge自身は self-exclude されるため、リストに表示されません (start/stop/delete の操作を禁止し安全を確保)。 - ネットワーク カード (LAN1/LAN2/WiFi/GSM/VPN/管理):
edge.net.<role>.ifaceの値にマッピングされます。dev ボックスのようにenp1s0 / enp2s0 / tailscale0といった systemd predictable 名称である場合は、app.propertiesで直接設定してください (install.sh のNET1_IFACE=...env で自動反映可能です)。 - コンポーネントヘルスの1行確認:
curl http://localhost/api/v1/system/health(認証不要、8コンポーネントの status map + 503 分岐)。
カード概要 (計 約30個)
横6列のグリッド形式です。カードの種類は以下の3通りです。
| 種類 | 色 | 意味 |
|---|---|---|
| action_box (白背景、大きなアイコン) | グレー枠 | クリックすると該当メニューへ移動 |
| black_box (黒背景) | グレー文字 | 変更されないゲートウェイ情報 |
| gray_box (白背景、グレーヘッダー) | ライトグレー | リアルタイムモニタリング — 値が1秒ごとに更新 |
1. 上部アクション / 情報 (1行)
1.1 엣지 정보 (black_box)
表示内容: このゲートウェイの不変の識別情報です。起動時に一度だけ測定され、画面に固定されます。
| フィールド | 意味 | 出典 |
|---|---|---|
| HOST名 | OS の hostname (例: pe-edge-01) | EdgeContext.hostname |
| O/S | OS 名 + アーキテクチャ (例: Linux (amd64)) | os.name + os.arch |
| カーネル | カーネルバージョン (例: 5.14.0-...) | os.version |
| バージョン | ゲートウェイ SW バージョン (例: V2026.05.08) | app.properties |
| ビルド日 | 成果物のビルド日付 (例: 2026-05-08) | BUILD_DATE |
⚠ HOST名、O/S 情報は、ゲートウェイ再起動後に OS が変更された場合にのみ更新されます。
1.2 프로토콜 연결 하기 (action_box)
→ クリックすると /ui/connect/connect へ移動します。新しい PLC / OPC-UA / MQTT / シミュレーターの接続を追加する画面です。
1.3 연결된 목록 (N) (action_box)
→ クリックすると /ui/connect/list へ移動します。括弧内の N は現在登録されている OPC (接続) 数 (monitor.opc_count) です。
1.4 애플리케이션 (action_box)
→ /ui/apps へ移動します。Docker ベースのユーザーアプリケーションの起動・停止・管理を行います。
1.5 노-코드 플로우 (action_box)
→ /ui/flow (Node-RED 埋め込み) へ移動します。
詳細な使用方法: フロー (Node-RED)
1.6 환경 설정 (action_box)
→ /ui/system/config へ移動します。app.properties の直接編集、システム再起動、再起動、バックアップ、一時ファイル整理などを行います。
2. ゲートウェイ識別 (3 cards)
2.1 엣지 시작 시간 (gray_box)
表示内容: 最後にゲートウェイ (Tomcat) が起動した正確な時刻 — yyyy년 MM월 dd일 [a] HH시 mm분 ss초 (KST) です。再起動のタイミングを確認したい場合は、この値で「最終再起動」を確認してください。
2.2 엣지 ID (gray_box)
表示内容: このゲートウェイの固有 ID (例: EDGE_00303) です。Sparkplug, REST API, OPC-UA ノードツリーなど、すべての識別の基準となります。app.properties の edge.id から取得されます。
2.3 배포 사이트 ID (gray_box)
表示内容: このエッジがどのサイト (工場 / ライン) に配置されているか (例: SITE_00001) です。外部 SCADA / Sparkplug の Group ID 決定に使用されます。app.properties の site.id から取得されます。
3. ネットワーク状態 (6 cards)
各カードは リンク状態アイコン + IP または DISCONNECTED (グレー) を表示します。
3.1 인터넷 (gray_box)
ゲートウェイが外部インターネットに ping 可能かどうかを表示します。アイコンの色は以下の通りです。
- 緑色 globe: 正常な接続
- 赤色 globe: 接続失敗
ping 対象は app.properties の monitor.ping.targets (例: 8.8.8.8) です。
3.2 이더넷 (gray_box) — 2分割表示
- 左: 1 WAN (外部網 NIC,
net_1_ip) - 右: 2 PLC (PLC 網 NIC,
net_2_ip)
各枠の色は インターネット ping の結果 に応じて同期して変化します (簡略化された表示)。
3.3 WIFI (gray_box)
wifi-1 アイコン + IP、または wifi-slash グレー (DISCONNECTED) を表示します。
3.4 3G/4G/5G (gray_box)
GSM モデムの IP または DISCONNECTED を表示します。SIM カードアイコンが表示されます。
3.5 VPN (gray_box)
shield-check アイコンが表示されます。VPN 接続時は IP を表示し、切断されている場合は グレー + DISCONNECTED となります。
3.6 관리 포트 (gray_box)
wrench アイコンが表示されます。USB / 別途管理 NIC の IP を表示します。通常、サイトネットワークから分離された診断用チャネルとして使用されます。
4. システムリソース (5 cards)
4.1 온도 (gray_box)
CPU 温度を表示します。90°C 以上で赤色 + temperature-high アイコン (危険)、それ以下は 緑色 + temperature-low となります。産業環境におけるファン詰まり / 高温アラームの一次信号となります。
4.2 CPU (gray_box)
ゲージ (0–100%) + 総コア数を表示します。JustGage ライブラリを使用し、1秒ごとに更新されます。
継続的に 90% を超える場合は、PLC ポーリング周期やタグ数の検討が必要です。
4.3 물리 메모리 (gray_box)
ゲージ + 사용 / 전체 (KB/MB/GB 自動単位) を表示します。swap とは別に RSS 使用量を表示します。
4.4 가상 메모리 (gray_box)
スワップ (swap) 使用量を表示します。ゲージ + 사용 / 전체 で構成されます。通常 0–10% で正常であり、継続的に 30% を超える場合は RAM 不足の可能性があります。
4.5 디스크 (gray_box)
/data1 (またはゲートウェイホーム) の使用率を表示します。ゲージ + 사용 / 전체 で構成されます。
90% を超えた場合は、直ちに 整理 / 掃除 (clean.sh / node-cleanup.sh) 手順を実行してください。
5. ネットワークトラフィック (1 card)
5.1 네트워크 사용량 (gray_box)
- ダウンロード (RX) — 累積受信バイト
- アップロード (TX) — 累積送信バイト
KB/MB/GB の自動単位で表示され、起動後の累積値となります。
6. 収集 / 処理 (4 cards)
6.1 연결 | 태그 건수 (gray_box)
- 上部の大きな数字: 接続 (OPC) 数 (
opc_count) - 下部の大きな数字: タグ数 (
tag_count)
ゲートウェイが認識している OPC/タグの全カウントです。システムタグ (EDGE_*) も含まれます。
6.2 PLC 연결 및 수집 상태 (gray_box) — 2x4 マトリクス
| 左側 (接続) | 意味 |
|---|---|
| 🟢 接続 | TCP/UDP 接続が OK な OPC 数 (plc_con_connected_count) |
| 🔴 切断 | 接続に失敗した OPC 数 (plc_con_disconnected_count) |
| 右側 (収集) | 意味 |
|---|---|
| 🟢 正常 | 収集開始 ＋ read 成功中 (plc_scan_start_count) |
| 🟧 異常 | 収集は開始したが、一定時間 read 失敗 (plc_scan_not_collect_count) |
| ⬜ 停止 | ユーザーが停止操作を行った OPC (plc_scan_stop_count) |
接続と収集は異なります: TCP が維持されていても (接続 ✅)、何らかの理由で read が行われていない場合は 収集異常 として分類されます。
6.3 PLC 읽기/쓰기 결과 (gray_box)
収集機/REST API が累積した read/write カウンタです。K/M/B 単位で圧縮表示されます。
| 成功 | 失敗 | |
|---|---|---|
| 読み取り (R) | plc_value_read_success_count | plc_value_read_error_count |
| 書き込み (W) | plc_value_write_success_count | plc_value_write_error_count |
右上の ↻ 更新アイコンをクリック → /connect/reset-read-error を呼び出し → 失敗カウンタのみを 0 にリセットします。アラーム整理後、次のサイクルから改めてカウントしたい場合に利用します。
6.4 MPS (gray_box)
Messages Per Second — 1秒間に処理されるデータポイント数 (monitor.mps) です。
直下に sparkline (直近傾向のミニチャート) があり、負荷変動をひと目で確認できます。
通常サイトの mps が 100 であるところを、突然 0 に低下した場合は → PLC 接続または収集異常が疑われます。
7. 送信 / 保存 (5 cards)
7.1 대기 큐 (gray_box)
送信待機中のポイントキューサイズ (queue_size) です。
通常は 0–数十程度です。外部送信が遮断された場合 (Sparkplug 切断など)、急速に増加し → ディスクキュー (
queue_disk_size) へ溢れます。このカードの値が継続的に増加する場合は、外部通信の点検が必要です。
7.2 포인트 전송 건수 (gray_box)
起動後、外部へ正常に送信された累積ポイント数 (sended_point_count) です。
7.3 포인트 전송량 (gray_box)
起動後の累積送信バイト数 (sended_point_bytes) です。自動単位で表示され、データ利用料金の算定に参照されます。
7.4 데이터 저장량 (gray_box)
Cassandra の keyspace pe に保存された時系列データの総サイズです (MBytes 入力 → 自動単位変換)。ディスクの残容量と合わせて確認してください。
7.5 데이터 저장 기간 (gray_box)
tm_tag_point の TTL (Time-To-Live) 日数 (system_db_ttl, デフォルト 30日) です。この日数が経過すると自動的に消去されます。app.properties で変更可能です。
8. システムエラー (1 card)
8.1 시스템 오류 (오늘) (gray_box)
本日 (00:00–現在) 発生した ERROR レベルのシステムログ件数 (system_error_count) です。赤い大きな数字で表示されます。
数字をクリック → /system/log/list へ移動し、実際のログ本文を確認してください。
9. 外部サービス / 統合 (5 cards)
各カードは 状態帯 (緑/赤/グレー) ＋ 接続情報表で構成されています。
9.1 플랫폼 API 서버 (gray_box)
上位 PlantPulse プラットフォーム API との接続状態です。右上の外部リンクアイコンをクリックすると、別ウィンドウでそのサーバーへ接続します。
| 行 | 意味 |
|---|---|
| 帯 | 🟢 接続成功 / 🔴 接続失敗 (monitor.api) |
| HOST/IP | server.host |
| PORT | server.port |
| USER | server.username |
9.2 OPC-UA 서버 (gray_box)
ゲートウェイ 内蔵 OPC-UA サーバー情報です。外部 SCADA がここに接続してタグを購読します。
| 行 | 意味 |
|---|---|
| 帯 | 🟢 有効化 (サーバーは常時運用) |
| HOST/IP | opc.ua.server.host |
| PORT | opc.ua.server.tcp.port (デフォルト 12000) |
| USER | opc.ua.server.user |
詳細なノードツリー / 時系列チャート: OPC UA サーバー使用
9.3 MQTT 서버 (gray_box)
ゲートウェイ 内蔵 HiveMQ 情報 ＋ Sparkplug 等をパブリッシュするトピックです。
| 行 | 意味 |
|---|---|
| 帯 | 🟢 有効化 / ⬜ 無効化 (mqtt.enable) |
| HOST/IP | mqtt.server.host |
| PORT | mqtt.server.port (デフォルト 1883) |
| USER | mqtt.server.user |
| TOPIC | mqtt.server.topic (Sparkplug spBv1.0/... またはユーザー定義トピック) |
9.4 Sparkplug B (gray_box)
Sparkplug パブリッシュコンポーネントのリアルタイム状態 (5秒更新, /api/v1/transfer の Sparkplug 項目) です。
| 行 | 意味 |
|---|---|
| 帯 | 🟢 有効化 (接続済み) / 🔴 接続切れ (有効だが broker 接続切断) / ⬜ 無効化 (sparkplug.enable=false) |
| GROUP | Sparkplug Group ID (例: Plant1) |
| NODE | Edge Node ID (例: EDGE_00303) |
| セッション # | bdSeq (デバイス birth/death シーケンス — 再接続回数) |
| メッセージ # | seq (現在のパブリッシュメッセージ番号 — 0–255 循環) |
メッセージ # が停止している場合は送信中断。セッション # が頻繁に増加する場合は broker 接続が不安定です。
9.5 도커 (gray_box)
Docker デーモンの状態 ＋ ユーザーアプリケーションコンテナの統計です。
| 行 | 意味 |
|---|---|
| 帯 | 🟢 運用中 / 🔴 停止中 (monitor.docker_on) |
| カウント | [ 살아있는 / 전체 ] コンテナ数 (docker_container_up_count / docker_container_total_count) |
/ui/apps で登録したアプリケーションがすべて動作しているかをひと目で確認できます。
10. フッター (全ページ共通)
画面下部に以下が表示されます。
- PlantPulse Edge テキスト ＋ ライセンス
- ☁ ソフトウェアアップグレード アイコン — クリック時に
upgrade.shを呼び出し (確認ダイアログ後)- アイコン横のバッジ:
- 赤色 「アップグレード可能!」 → ダウンロードサーバーに新バージョンあり
- 灰色 「ダウンロードサーバー接続不可」 → 外部網 /
product.kopens.ioアクセス失敗 - (バッジなし) → 現在のバージョンが最新
- アイコン横のバッジ:
- 外部ポートショートカット — その他外部サービス (例: Grafana 3000) を別ウィンドウで開く
内部的に /config/upgrade/check が server-to-server で https://product.kopens.io/.../VERSION.JSON を取得して比較し、CORS エラーなく適切にバッジを表示します。
11. 更新周期 / データ出典まとめ
| 領域 | 更新周期 | エンドポイント |
|---|---|---|
| ゲージ / リソース / ネットワーク / カウンタ / キュー / 保存量 / エラー | 1秒 | GET /monitor/bean |
| Sparkplug B カード | 5秒 | GET /api/v1/transfer |
| アップグレードバッジ | ページロード時に1回 | GET /config/upgrade/check |
| 黒色情報カード (HOST名/OS/バージョン等) | 更新なし (ページロード時の値) | EdgeContext (サーバー起動時に決定) |
12. よくあるパターン
| 画面信号 | 疑われる原因 / 対策 |
|---|---|
| 温度 赤色 (90°C↑) | ファン詰まり / 環境温度 — 直ちに点検 |
| CPU 90%+ 持続 | ポーリング周期が速すぎる / タグ数が過多 |
| ディスク 90%+ | 整理および掃除 — clean.sh + node-cleanup.sh |
| PLC 切断 カウントが急増 | PLC 網ケーブル / スイッチ / PLC 電源 |
| 収集異常 > 0 | 接続は OK だが read 失敗 — アドレス形式 / PLC ファームウェア点検 |
| MPS が 0 に低下 | すべての PLC が read 失敗、または収集機が停止 |
| 待機キュー が継続的に増加 | 外部送信 (Sparkplug / MQTT) が遮断 — 9.3/9.4 カード確認 |
| システムエラー 赤色数字 | クリック → /system/log/list で本文確認 |
| Sparkplug メッセージ # が不変 | 送信中断 — app.properties の sparkplug.* 点検 |
| Docker 赤色 | systemctl status docker でデーモン状態確認 |
13. 詳細情報
- 接続追加: 新 PLC 接続追加
- 接続一覧 / タグ画面: リアルタイム値表示
- OPC UA サーバー: OPC UA サーバー使用
- フロー自動化: フロー (Node-RED) を始める
- システム環境設定 / 運用スクリプト: 運用概要