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

システム

目次​

시스템 설정 화면

概要​

システムメニューは、Platform自体の運用状態、セキュリティアカウント、設定、ログ、環境情報、クラスターをまとめた領域です。現在、左側メニューの System グループには以下の項目が含まれています。

サブメニュー内部URL / 外部ポート用途
ユーザー/user/indexユーザーアカウント管理
セキュリティポリシー/security/indexパスワード・アクセスセキュリティポリシー
APIトークン/token/index外部連携用APIトークン
モニタリング/monitoring/indexインフラヘルス・データパイプライン・エンジンメトリクス リアルタイムダッシュボード
診断/diagnostic/indexシステム診断イベントの照会
ログ/log/indexサーバーアプリケーションログ（クラス・メソッド・ライン単位）を時系列で照会
設定/config/indexシステム動作キー・値の設定管理 (再適用/再起動)
環境情報/env/viewプロパティファイル別の環境設定値をタブ別に照会
クラスター/cluster/indexクラスターノード状態
HA/ha/index高可用性構成状態
監査/audit/index監査ログ

本ドキュメントでは、そのうち モニタリング / ログ / 設定 / 環境情報 を中心に説明します。ユーザー・セキュリティ・トークンは セキュリティ管理、診断は 診断、外部ツールは 標準および外部ツール を併せて参照してください。

画面構成 — Systemグループ​

画面主なユーザー一行要約
モニタリングシステム管理者インフラヘルス 5枠 + パイプラインダイアグラム + エンジンメトリクス 9パネル + トラフィック・クラスター・診断
診断運用者/管理者システム診断イベントと INFO/WARN/ERROR のフロー
ログ運用者/管理者クラス・メソッド・ライン情報まで含まれる詳細なアプリケーションログ
設定システム管理者システムキー・値の設定追加・修正・キャッシュ再適用
環境情報システム管理者プロパティファイル（エンジン/アプリケーション/メッセージキュー/ストレージ/メール/WebSocket）の照会 (読み取り専用)
クラスターシステム管理者クラスターノード、モード、遅延、リソース状態
HAシステム管理者高可用性構成状態
監査システム管理者監査ログ

モニタリング画面 (/monitoring/index)​

Platform自体のリアルタイム運用メトリクスをダッシュボード形式で表示します。 副題に サーバーが開始された時刻 が表示されます — 再起動直後であるかを一目で確認できます。

모니터링 화면 — 번호는 읽는 순서

番号位置内容
①左上インフラヘルス — 5枠
②左中データパイプライン ダイアグラム
③左下エンジンメトリクス 9パネル
④右上データトラフィック — 秒間バイト + スパークライン
⑤右中クラスター — ノード別状態・読み取り/書き込み遅延・ストレージ
⑥右下システム診断 — ヘルスタイムライン + 最新診断

① インフラヘルス — 5枠​

枠ラベル
1キャッシュ
2MQTT
3KAFKA
4イベントストア
5時系列エンジン

各枠に正常/異常が表示されます。すべて正常であれば、運用は安定状態です。

パネル副題にはまだ「WebSocket」と表示されていますが、枠はありません

副題の文言には「キャッシュ・WebSocket・MQTT・Kafka・イベントストア・時系列エンジン」の6つが並んでいますが、実際に描画される枠は 5つ です。WebSocket/STOMP は 2026-07 に廃止され、（ブラウザプッシュは SSE に変更されました）枠だけが先に削除された状態であり、副題に残っている名残です。

② データパイプラインダイアグラム​

データソース → メッセージバス → エンジン → 分析 → ストレージ の5段にノードを配置し、ノード間を流れる線で実際の経路を示します。

段配置されるノード(例)
データソースEdge/ファイル/API · DB · Modbus · PLC · OPC — 各ノードに 登録数
メッセージバスメッセージングハブ — MSG/S
エンジンパイプライン(処理数・待機) · CEP(タスク数) · インジェクション
分析スケジューラー · バッチ · ストリーム(MPS)
ストレージキャッシュ · イベントストア · TSE(WPS)

ノード下の小さな文字がそのノードの現在の指標です。停滞箇所を探す際はここから確認してください — 前段の数値は上昇しているのに後段が停止していれば、その間がボトルネックです。

③ エンジンメトリクス — 9パネル​

3列 × 3行です。各パネルは数行のキー・値 + 小さなチャートで構成されています。

パネル表示される値
PPS現在 PPS · 最大 PPS (秒間収集 · 直近1分)
JVM 힙使用量 · 全体
パイプライン処理完了 · キュー待機
ストレージバッファ待機 · アクティブバッチ
メッセジングKAFKA · MQTT
ストリーミング処理件数 · タイムアウト
非同期エグゼキュータアクティブ · 待機
診断警告 · 重大
キャッシュHIT · MISS

④ データトラフィック​

秒間バイトを大きな数字で表示し、その下にスパークラインが表示されます。

⑤ クラスター​

列表示
状態ノード状態ドット
ノード IP
読み取り読み取り | 書き込み 遅延 (ops/s)
ストレージノードが書き込んでいる容量

上部に 総クラスター N ノード、下部に最終更新時刻が表示されます。

⑥ システム診断​

ヘルスタイムライン（正常 · 情報 · 警告 · 重大 の4つの凡例）と 最新 診断リストが併せて表示されます。 各行に発生時刻・相対時刻とソースバッジ（SERVER / EDGE）が付与されており、Platform内で発生したものか現場の Edge から上がってきたものかが即座に判別できます。詳細な照会は 診断 画面で行います。

«接続ヒートマップ» パネルは廃止されました

以前はこの画面にデータソース別の色ブロックを格子状に並べた 接続ヒートマップ がありましたが、現在は描画されません（メッセージ文言のみ残っています）。接続別の状態を格子状に確認したい場合は、接続状態画面 のデータソースカードグリッドを使用してください。

ログ画面 (/log/index)​

サーバーアプリケーションのコードレベルログ（クラス・メソッド・ライン）を時系列で照会します。/diagnostic/index の診断ログとは異なり、開発者/管理者がデバッグに使用 する詳細ログです。

上部検索領域​

📋 로그                  [기간 ▭▭▭▭] [레벨 ▼] [건수 ▼] [조회] [전체 출력] [↻]
コントロール幅説明
期間 (search_time)280px開始~終了 (中央揃え, 太字)
レベル (level)100px全レベル/INFO/WARN/ERROR
メッセージ (message)250px (デフォルト非表示)キーワード検索。運用環境に応じて表示
件数 (limit)130px50/100/200/300/500/1,000
照会赤 + 🔍search()
全出力赤 + 📄downloadCSV() — 検索条件に合致する全ログを CSV 出力
更新 (realtime_icon)赤 + ↻refresh()

hidden フィールド app_name のデフォルト値は SERVER です。つまり、この画面はサーバーアプリケーションログのみを照会します。

タイムライン + クイック時間範囲​

診断画面と同じ6つのボタンによるクイック時間範囲（10M/30M/1H/6H/12H/ALL）とタイムライン（alarm_timeline）。

ログテーブル (6列)​

診断画面よりも一段深いコードレベル情報を表示します。

列幅説明
レベル80pxINFO/WARN/ERROR 色付きバッジ
時刻160pxログ発生時刻
ログクラス200pxJava クラスフルネーム
メソッド名120px呼び出されたメソッド
ライン番号80pxソースコードのライン番号
メッセージ自動ログ本文 + stack trace (存在する場合)

ログクラス/メソッド/ライン情報は、システム管理者がコード位置を正確に特定してデバッグする際に有用です。一般的な運用の異常信号追跡には 診断 画面が適しています。

設定画面 (/config/index)​

システム動作に必要なキー・値の設定を追加・修正・削除し、キャッシュを再適用する画面です。

アドレス設定​

ユーザーがブラウザに入力するアドレスはPlatform自身では認識できないため、ここで設定します。空欄のまま保存可能です。

設定キー用途空欄の場合
PP_UI_CONSOLE_URLコンソールアドレス。アラームメールの «アラーム確認へ» リンクと QRラベル に使用されますメールにはリンクが付かず、QRラベルはコードを描画しません
PP_UI_FRONTLINE_URL現場アプリアドレス。QR公開ページの «frontline で開く» ボタンの遷移先となりますボタンを非表示にします

値は https://plantpulse.example.com のように http(s) で始まる絶対アドレスである必要があります。末尾の / は切り捨てて保存され、クエリや # が付いている場合は拒否されます。

メールサーバー設定（MAIL_*）もこの画面で行います — メール設定。

上部ツール​

🎚️ 시스템 설정       [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
コントロール幅説明
設定キー検索 (search_keyword)200pxプレースホルダー: "設定キー検索 ..."
照会赤 + 🔍search() — キーワードフィルタ適用
更新赤 + ↻refresh()
設定追加赤 + ➕addConfig() — 新規設定追加フォームを開く
再適用青 + 🔄refreshCache() — サーバー再起動なしで設定キャッシュを再適用 (ツールチップ: "サーバー再起動なしで設定キャッシュを再適用します。")

設定リストテーブル​

列幅説明
設定キー300pxシステムが認識するキー (例: engine.timeout.ms)
設定値600pxキーの現在の値
説明自動キー用途のメモ
修正日150px最終修正時刻
アクション80px修正・削除ボタン

ページ下部に案内ボックスが表示されます。

ℹ️ システム設定案内 システム動作に必要なキー・値の設定を管理します。設定変更後、一部の項目はサーバーの再起動が必要になる場合があります。

設定追加/修正フォーム​

上部の 設定追加 またはリストのアクションから設定フォーム画面（/config/form）へ移動します。

入力項目説明
設定キー英数字/./_ のみ使用可能。例: engine.timeout.ms
設定値テキスト (数値・boolean・JSONすべて可能、キー定義により異なる)
説明自由テキスト (運用者が識別しやすいようにメモを記載)

保存後、即座に反映させるにはリスト画面に戻り 再適用 をクリックしてください。一部の設定はサーバーの再起動が必要な場合があります。

環境情報画面 (/env/view)​

Platformが起動時に読み込むプロパティファイルをグループ別タブで照会する 読み取り専用 画面です。

上部案内ボックス​

❓ システム環境情報 サーバーシステムに設定された環境情報をプロパティファイル別に表示します。環境設定の変更は各ファイルを修正してください。

  • 設定を変更した場合は、サーバーを再起動する必要があります。

6タブ構成​

タブ表示内容
エンジンエンジンコア動作設定 (時間/スレッド/キュー上限など)
アプリケーションWebアプリケーション一般設定
メッセージキューメッセージチャネル接続設定 (ブローカーホスト・認証・トピックなど)
ストレージ時系列・イベントストレージ接続設定
メールメール送信 SMTP 設定
WebSocketリアルタイムプッシュチャネル設定

各タブの表 (共通)​

列表示内容
キープロパティキー
設定値現在の値 (マスキングされたパスワードは *** と表示)

環境情報画面では値を 修正することはできません。変更が必要な場合は、システム管理者がサーバーの該当プロパティファイルを直接修正した後、サーバーを再起動する必要があります。

活用シナリオ​

シナリオ画面手順
PPSが通常より低下しているモニタリングPPS パネルチャート → インフラヘルス 5枠 → データパイプラインダイアグラムのボトルネックノードを識別
GCが長い / メモリリークが疑われるモニタリングJVM 힙 パネルの GC 時間推移 → システム管理者に通知
サーバー起動直後の正常稼働確認モニタリング副題の開始時刻 + インフラヘルス 5枠すべて正常 + パイプラインノードの数値上昇を確認
特定のクラスで ERROR を追跡するログレベル=ERROR + メッセージ検索にクラス名キーワード → ライン番号を含むログを分析
一時的に設定変更を適用する設定設定追加/修正 → 再適用 (再起動なし)
パスワードポリシー・セッション時間変更環境情報アプリケーションタブで現在値を確認 → システム管理者がファイルを修正 → サーバー再起動
どの接続が停止しているか探す接続管理状態画面 のデータソースカードグリッド → カードクリック → 詳細

よくある質問​

Q. モニタリング画面と診断画面は何が違うのですか？ A. モニタリング はPlatform自体のリアルタイム運用メトリクス（スループット・メモリ・ヘルス）を表示し、診断 はモジュール別の INFO/WARN/ERROR イベントログを表示します。どちらもシステム管理者が使用しますが、モニタリングは「今どうなっているか？」、診断は「何が起きたのか？」に答えるためのものです。

Q. モニタリングのインフラヘルスが1枠でも赤色になっています。 A. 該当コンポーネントが応答していないか、ヘルスチェック失敗状態です。直ちに 診断 画面で SERVER または該当コンポーネントの ERROR ログを確認し、同時にシステム管理者に通知してください。

Q. データパイプラインダイアグラムのノードが灰色です。 A. その段階がアクティブになっていないか、処理データがない状態です。平常時に灰色が正常な段階（例：バックアップ・アーカイブ）もありますが、データ流入時間帯に灰色である場合は問題の可能性があります。

Q. 以前あった «接続ヒートマップ» が見当たりません。 A. モニタリング画面から除外されました。接続別の状態は 接続管理 > 状態 画面のデータソースカードグリッドで確認し、カードをクリックすると詳細画面（/connect/view）へ移動します。

Q. ログ画面と診断画面、どちらを見るべきですか？ A. 異常信号の追跡 は 診断、コードレベルのデバッグ はログを使用してください。診断で ERROR が検出されたがメッセージが不十分な場合は、同時刻のログ画面でそのクラス/メソッドの詳細ログをあわせて確認してください。

Q. 設定画面の 「再適用」 ボタンは安全ですか？ A. サーバーの再起動なしにメモリキャッシュのみをリフレッシュします。ほとんどの設定において安全ですが、一部の設定（スレッドプールサイズ・DB接続プールなど）は再起動が必要です。再適用後に意図した動作にならない場合は、システム管理者に問い合わせてください。

Q. 環境情報の値を画面から変更したいです。 A. 環境情報画面は読み取り専用です。変更はサーバー側のプロパティファイルを修正した後、サーバーを再起動する必要があります。画面から変更可能なキー・値は 設定 画面で管理してください。

Q. ログの 「全出力」 CSV が大きすぎます。 A. 検索条件の期間を短く（1時間以内）、レベルを ERROR/WARN に絞って再度ダウンロードしてください。または、CSV ダウンロード後に外部分析ツールで処理してください。

Q. モニタリング画面は自動的に更新されますか？ A. モニタリングはリアルタイムプッシュにより自動更新されます。メトリクスが停止している場合は、まずヘッダーのリアルタイム接続状態が赤色になっていないか確認してください。

関連画面​