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

トラブルシューティング

症状ごとに素早く探して解決できるように整理しました。

コンテナモードボックス

systemctl is-active plantpulse-edge.service が active ならコンテナモード — 一部の症状は コンテナモード運用ガイド の「障害対応」節、またはボックス内の /opt/kopens/install/RUNBOOK.md のシナリオマトリクス (A〜E) のほうが素早い診断を提供します。診断情報の一括収集:

sudo bash /opt/kopens/install/bin/doctor.sh
# → /tmp/pe-doctor-`<host>`-`<ts>`.tar.zst (support 전달)

クイックインデックス​

症状参照先
ゲートウェイ画面が開きません画面が開きません
ログインできませんログインできません
接続できません (PLC)接続できません
接続はできるが値が入ってきません値が入ってきません
値は入ってくるがおかしいです値がおかしいです
値が突然入ってこなくなりました値が突然途切れました
画面が遅いです画面が遅いです
メモリ/ディスクが赤くなっていますリソースが不足しています
クラウド / SCADA へのデータ送信ができません送信できません
タグの [書き込み] ができません値を書き込めません

画面が開きません​

ブラウザでゲートウェイの IP を入力したのにページが表示されない場合。

ステップ1 — PC からゲートウェイが見えるか確認​

コマンドプロンプトで:

ping <gateway-ip>

応答がなければネットワーク / ケーブル / VPN の問題です。システム管理者に「ゲートウェイが見えない」と伝えてください。

ステップ2 — 別のブラウザ / ユーザーで試す​

別の PC でも同じ症状であれば、ゲートウェイ自体が停止しているか、ハングしている可能性があります。システム管理者がゲートウェイ PC を再起動する必要があります。

ステップ3 — URL の確認​

  • http://게이트웨이IP/ が通常の形式です。
  • ポート番号が付いている場合 (例: http://게이트웨이IP:8080/) もあります。
  • 社内標準の URL が分からない場合は同僚に確認してください。

ログインできません​

パスワードを忘れました​

初期パスワードで試してください。

  • ID: admin
  • パスワード: admin123!

すでに変更済みの環境であれば、システム管理者にパスワードの初期化を依頼してください。

ログイン直後にログアウトされます​

セッション / Cookie の問題である可能性があります。ブラウザの Cookie を削除して再試行してください。

接続できません​

[接続] 画面で赤色の「接続失敗」が表示される状況。

ステップ1 — 同じ PC から PLC が見えますか​

ゲートウェイ PC から PLC の IP へ ping が通るか、システム管理者に依頼して確認してください。

ステップ2 — ポートは合っていますか​

PLC 種類別の既定ポート:

PLCポート
OPC-UA (Kepware)49320
Modbus TCP502
三菱 (Q/L)5000 または 1029 (PLC 設定値)
三菱 (iQ-R)1500
シーメンス S7102
LS2004
AB EtherNet/IP44818

PLC 側の通信モジュールが有効になっている必要があります。

ステップ3 — PLC 側のセキュリティ設定​

PLC追加設定が必要
シーメンス S7TIA Portal で「PUT/GET 通信の許可」を有効化 + DB の Optimized モードを OFF
三菱GX Works で「MC プロトコル / TCP / ポート」を有効化
OPC-UAユーザー / パスワード、または匿名接続の許可
LSICMP (ping) がブロックされていないこと

ステップ4 — ユーザー / パスワード​

OPC-UA のように認証がある PLC は ID / パスワードが正確でなければなりません。PLC の [修正] フォームで再入力して試してください。

値が入ってきません​

接続は「正常接続」なのに、タグの [現在値] 欄が空の場合。

ステップ1 — PLC アドレス表記の確認​

最も多い原因です。PLC の種類ごとに表記が異なります。

  • 三菱: D100, M50 (先頭に % なし)
  • シーメンス: %DB1.DBW0 (先頭に %、DB 番号 + DBW/DBD)
  • LS: D00309 (5 桁の数字)
  • OPC-UA: ns=2;s=경로 形式

ご使用の PLC ページの [PLC アドレス表記] 節を再度確認してください。

ステップ2 — データ形式 / 形式補助の確認​

32-bit 以上の値なのに [形式補助] が空だと、16-bit として誤って読み取られ、値が表示されないことがあります。

  • 32-bit 整数: 形式補助 = DW
  • 32-bit 実数: 形式補助 = REAL
  • 64-bit 実数: 形式補助 = LREAL

ステップ3 — 他のツールで同じアドレスを検証​

PLC 作成ツール (GX Works / TIA Portal / XG5000 / UA Expert) のモニタ / Watch 画面で、同じアドレスが実際に動作するか確認してください。

値がおかしいです​

値は入ってくるが、数値が大きすぎる / 小さすぎる、あるいは符号が逆の場合。

32-bit なのに 16-bit として読まれている​

値がランダムに見えたり、片方が切れて見えるパターンです。[形式補助] に DW (整数) または REAL (実数) を明示してください。

符号なしの値を符号付きとして読んでいる​

例: 65535 が -1 に見える場合。[形式補助] に UI (16-bit 符号なし) または UDW (32-bit 符号なし) を明示します。

byte / word 順序 (endian) が逆​

特定のスレーブ (Modbus スレーブでよくあります) が little-endian で値を送ると、32-bit 実数が崩れて見えます。

  • Modbus であれば、データ型表記を :UDINT_LSWORD_FIRST のような変形で試す
  • 他の PLC では 計算式の適用 による後処理が難しい場合があるため、システム管理者に問い合わせ

単位が異なる​

PLC が整数の raw 値 (例: 1638) を送るが、実際の意味は 163.8 のような場合。計算式の適用 で ${VALUE}*0.1 を入力して単位変換します。

値が突然途切れました​

正常に入ってきていた値が、ある時点から入ってこなくなる場合。

ステップ1 — 接続状態の確認​

[接続] メニューで、その PLC の接続状態はどうなっていますか?

状態意味 / 次の対応
赤「接続失敗」PLC 側に問題。PLC を再起動するか、ケーブル / ネットワークを点検
グレー「停止」誰かが [停止] を押した、または自動停止。[開始] ボタンで再開
緑「正常接続」+ 値のみ来ないPLC のそのアドレスが無効化された可能性

ステップ2 — PLC 自体の点検​

  • PLC が RUN モードか (STOP に落ちている場合は値が止まります)
  • そのアドレス領域のメモリ保護設定が変更されていないか
  • PLC のファームウェア更新 / 再起動の直後であれば、しばらく待つと自動的に再接続されます

ステップ3 — ゲートウェイの再起動​

[設定] → [アプリケーション再起動] でゲートウェイ自体を起動し直します。1 分以内に復旧します。

画面が遅いです​

PLC が多すぎる、またはタグが多い場合、初回ロードに 1〜2 秒程度の遅延が発生することがあります。

  • 通常は大きな問題ではありません。
  • メイン画面の CPU ゲージが赤い場合は、ゲートウェイ PC のリソース不足の可能性があります。システム管理者に問い合わせてください。

リソースが不足しています​

メイン画面の CPU / メモリ / ディスクゲージが赤く表示される場合。

ゲージ対処
CPU収集周期が短すぎる PLC がないか確認。1 秒以上に延ばしてください
メモリ[設定] → [アプリケーション再起動] で一時的に解消可能。繰り返す場合はシステム管理者にメモリ増設を依頼
ディスク[設定] → [一時ファイル削除]。時系列の保存期間が長すぎる可能性もあります

送信できません​

値は正常に収集されているが、クラウド / SCADA / MQTT へ転送されない場合。

MQTT / Sparkplug が未発行​

  • システム管理者に「MQTT の有効化状態」の確認を依頼
  • 同じゲートウェイ PC で MQTT ブローカー (HiveMQ など) が稼働中か確認

Platform API の応答なし​

  • PlantPulse Platform 自体に接続できない → 本社 / 運用チームに問い合わせ
  • ゲートウェイ自体はキューに蓄積するため、一時的な断絶は自動復旧します。

システム管理者向けの詳細なログキーワード / ログの場所は、高度な設定 — 開発者ノートを参照してください。

最後の手段​

  • [設定] → [ログのダウンロード] で診断ログを一括ダウンロード
  • [設定] → [アプリケーション再起動] でゲートウェイのみ再起動 (1 分)
  • [設定] → [システムリブート] で PC 自体を再起動 (3〜5 分)

それでも解決しない場合は、ダウンロードしたログを添付して KOPENS または PlantPulse 運用チームに問い合わせてください。

値を書き込めません​

タグ行の末尾にある [書き込み] アイコンを押したときに、「書き込み失敗」/「driver returned false」などのメッセージが出る場合。

プロトコル別の書き込みサポート​

書き込みは PLC の種類によってサポート状況が異なります。

ご使用の PLC書き込みサポート備考
三菱 (MELSEC)✅ 可能Q/L/iQ-R すべて対応
シーメンス (S7)✅ 可能DB/M/I/Q 領域
OPC-UA (Kepware など)✅ 可能対象ノードの Write 権限が必要
Modbus TCP✅ 可能Holding Register / Coil
HTTP プッシュ✅ 可能 (キャッシュ)—
LS ELECTRIC (XGI/XBC/XBM)✅ 可能Bit/Byte/Word/DWord/Float/Double
AB EtherNet/IP✅ 可能PLC のファームウェア/パッチによって一部の型が拒否される場合があります

よく見られるメッセージ​

メッセージ意味 / 対処
쓰기 실패 (opc_type=...)ドライバが false を返しました。アドレス形式、データ型 (format)、PLC の Write 権限を点検
tag not found: ...不正なタグ ID。更新後に再試行
scheduler not running for opc_id=...該当 PLC が [停止] 状態。[開始] ボタンを押して再試行
OPC ... 가 PLC 와 연결되어 있지 않습니다DISCONNECTED 状態で write を試行 — IP/ポート/ファイアウォールを確認後に再起動

それでも解決しない場合​

  • システム管理者に [PLC の種類 + タグ ID + メッセージ全文] を伝えてください。
  • ゲートウェイのログでより詳しい原因を確認できます。