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

トラブルシューティング

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

コンテナモードのボックス

systemctl is-active plantpulse-edge.service が active の場合はコンテナモード — 一部の症状は コンテナモード運用 の「障害対応」節 のシナリオマトリックス (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!

既に変更されている環境なら、システム管理者にパスワード初期化を依頼。

ログイン後すぐに弾かれる​

セッション / クッキーの問題の可能性があります。ブラウザのクッキーを消去して再試行してください。

接続できない​

[接続] 画面でカードの接続アイコンが**赤く(ワイファイ斜線、ツールチップ「切断」)**表示される状況。

手順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 など) が稼働しているか確認

プラットフォーム API 応答なし​

  • PlantPulse プラットフォーム自体に接続不可 → 本社 / 運用チームに問い合わせ
  • ゲートウェイ自体はキューに蓄積するので、一時的な切断は自動復旧されます。

詳細なシステム管理者向けログキーワード / ログの場所は 上級 — 開発者ノート参照。

最後の手段​

  • [設定] → [ログダウンロード] で診断ログを一括ダウンロード
  • [設定] → [アプリケーション再起動] でゲートウェイのみ再起動 (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 + メッセージ全体] を伝えてください。
  • ゲートウェイログでより詳細な原因を確認できます。