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

AI管理コンソール

AIスタックには管理コンソールがひとつついています。GPUがどのくらい忙しいか、LLMが遅くなっていないか、文書索引が正常に動いているかをサーバーにログインせずブラウザで確認できます。

このドキュメントはコンソールを初めて開く方向けです。まず10分間のツアーをそのまま進めてから、画面ごとの説明が必要になったときに参照してください。

誰が使うか

現場のオペレータとシステム管理者です。コンソールは読む画面がほとんどなので、誤ってボタンを押して何かが壊れることはほぼありません。値を変更する場所は文書のアップロード・削除とフィーチャーバックフィルの3ヶ所だけで、ドキュメント内に明記してあります。

アクセスとログイン​

アドレスはインストール形式によってふたつのうちどちらかです。管理者に確認してください。

形式アドレス
ドメイン付きインストールhttps://admin.<COMPANY_DOMAIN>
社内ネットワークからIPでアクセスhttp://<AI_SERVER_IP>:9080

ログイン画面でユーザーIDとパスワードを入力します。デフォルトのユーザーIDはadminで、パスワードはインストール時に管理者が設定します。

ユーザーIDはひとつだけです

コンソールはユーザーごとのアカウントを持ちません。運用チームが共有するアカウントひとつでアクセスします。誰が何を見たかは区別されないため、パスワードはチームの外に漏らさないよう管理してください。

1回ログインすると8時間有効

8時間経過したら再度ログインする必要があります。見ていた画面のURLは記憶されるため、ログインすればその場所に戻ります。サービスを再起動すると全員ログアウトされる可能性があります — セッションが何度もログアウトされる場合を参照してください。

画面のテキストは英語です

コンソールのメニューとボタンは英語で表示されます（ホーム画面のサービスカード説明だけは日本語で表示されます）。 以下の説明では、画面に実際に表示される英語名を太字で記し、日本語の意味を添えています。

10分間のツアー​

初めての方は、この順序で一通り見てください。何も変更しない、見るだけです。

ステップ1 — ログインしてホームを見る​

ログインするとすぐにホームが表示されます。最上部に状態サマリー1行があります。

정상 12   주의 0   중단 0   합계 12

この数字が今AIスタックの健康状態のすべてです。중단が0なら、とりあえず安心できます。この数字は20秒ごとに自動更新されるため、更新ボタンを押す必要はありません。

サマリー行の右側の展開アイコンをクリックすると、どのサービスがどの状態かがリスト表示されます。一度展開しておくと、次回アクセスしても展開された状態で表示されます。

黄色いインジケータが表示された場合

リストでそのサービスにマウスを合わせてください。なぜ黄色なのかがツールチップに表示されます。たとえば、サービス自体は動作していますがデータベース接続が失われている場合がここに表示されます。

ステップ2 — サービスカードを確認する​

サマリー行の下にサービスカードが並んでいます。カード1枚がサービス1つです。

  • 枠線の色と状態ドットで正常かどうかを表示します
  • クリックするとそのサービス画面に入ります
  • クリックできないカードもあります — ブラウザから直接アクセスできない内部サービスです。状態を見るだけのカードと思ってください

ステップ3 — GPUを確認する​

左側の縦帯（レール）でGPUをクリックします。GPU デバイスがテーブルで表示されます。

確認項目意味
Utilization今GPUがどのくらい忙しいか
Memoryモデルが使用しているメモリ量
Temperature高く保たれると性能が低下します
XIDNVIDIAハードウェア・ドライバエラーの件数
XIDが0以外なら無視しないでください

XIDはGPUハードウェアまたはドライバが発生させたエラーです。放置すると次の症状は通常サーバーダウンです。0以外の数字が表示されたら、その値をそのままシステム管理者に報告してください。

ステップ4 — LLM応答速度を確認する​

レールでLLMをクリックします。モデルごとに1行ずつ、応答速度とスループットが表示されます。

「最近の回答が遅い」という話が出たら、ここのP95（遅い方の100件中5番目）列を確認してください。 通常よりも大きく上昇していれば、その体感は正確です。行の最後の小さい折れ線グラフは最近のトレンドです。

ステップ5 — 1つのサービスに入る​

レールでRAG APIをクリックします。左側にそのサービスのメニューが展開されます。 Documents（文書）をクリックしてください。索引された文書のリストが表示されます。

ここでは何もクリックしないで、何件が索引されているかだけ確認してください。チャットボットが「関連ドキュメントが見つかりません」と答えるときに、最初に見るべき場所はここです。

ステップ6 — ログを確認する​

同じサービスメニューでLogs（ログ）をクリックします。最近のログが**最新順（最上段が最新）**で表示されます。サーバーにSSHで接続してdocker logsを実行する必要はありません。

ステップ7 — 完了です​

ここまで来たら、コンソールでやることの90%を見たことになります。まとめると次のとおりです。

ホームで全体の状態を確認して → おかしいサービスに入って → ログを見る。

残りの画面は必要なときに以下の説明から参照してください。

画面マップ​

左側レール（常に表示）​

メニュー機能
Home全体の状態サマリー + サービスカード
GPUGPUデバイスごとの使用率・メモリ・温度・XID
LLMモデルごとの応答速度・スループット
RAG API文書検索エンジン — 索引・同期・検索テスト
Timeseries Insight設備データ異常検知・予測エンジン
Document Parsing文書から表・項目を抽出するサービス
Vision画像判読サービス（不良判定・計器読み取り）
Operations Manual ↗今見ているこの説明書（新しいウィンドウ）

GPUとLLMがサービスの上にあるのは意図的な順序です。何が遅いか、あるいは停止しているかは、多くの場合その下のインフラに起因するため、上から下への順序で確認することで問題を素早く発見できます。

閉域網では説明書へのリンクが開きません

Operations Manualは外部サイト（docs.plantpulse.io）へのリンクです。インターネットがない現場では開くことはできません。説明書のコピーがサーバー内にインストールされていますので、管理者に問い合わせてください。

4つのサービスが共通で持つメニュー​

RAG API · Timeseries Insight · Document Parsing · Visionは以下の4つのメニューを同じように持ちます。一度理解すれば、これら4つの場所で同じです。

メニュー機能
MCP Server InfoこのサービスがAIコパイロットに提供するツール一覧
API Endpointsこのサービスが持つAPI一覧（連携開発者向け）
Logs最近のログ（最新が最上段）
Settings現在適用されている設定値 — 表示のみです
Settingsは編集画面ではありません

値を表示するだけで、変更することはできません。パスワード・APIキーはマスクされた状態で表示されます。 設定を実際に変更するには、パスワード・APIキーの変更とサービス運用を参照してください。

RAG API — 文書検索​

チャットボットが社内文書に基づいて回答するようにするサービスです。**「チャットボットが文書を見つけられない」**という問い合わせがあったら、ここから確認します。

メニュー機能
Documents索引された文書のリスト。アップロード・削除ができます
Sync History同期がいつ実行され、成功したかの履歴
Query Test検索ワードを入力して何がヒットするか直接テスト
共通4種上記の表を参照

チャットボットが文書を見つけられない場合​

  1. Documentsでその文書がリストに存在するか確認します — なければ索引されていません
  2. あればQuery Testでユーザーが質問した内容に似た言葉で検索してみます
  3. ここでもヒットしなければ検索モード を変更してみます — hybrid · local · global · naive · mixから選択できます。デフォルトはhybridです
  4. Sync Historyで最後の同期が失敗で終わっていないか確認します
Documentsでの削除は取り消せません

削除された文書はチャットボットがもはや根拠として使用できません。再度追加するには、元のファイルを新たにアップロードする必要があります。元のファイルを持っていないなら、削除しないでください。

Timeseries Insight — 異常検知と予測​

設備データから異常の兆候を発見し、将来を予測するエンジンです。メニューが最も多いサービスです。

分析画面​

対象ごとに**異常検知(Anomaly Detection)と予測(Forecast)**がペアを成します。

グループ画面
Asset（設備）Anomaly Detection · Forecast · Health Index（設備健全性スコア）
Production（生産）Anomaly Detection · Quality Forecast（品質予測）
Alarm（アラーム）Frequency Anomaly（発生頻度異常） · Failure Forecast（故障予測） · Duration Analysis（継続時間分析） · Sensor Correlation（センサー相関） · Statistics（統計）
System（システム）Anomaly Detection · Forecast
ProfilingAsset Profiling — 設備をつぶさに調査します

Feature Store — 分析の原料​

上記の分析はフィーチャーストアに蓄積された加工データを使用して機能します。分析結果が空か古い場合、通常ここが原因です。

メニュー機能
Pipeline Statusデータ加工が現在正常に実行されているか
Run History過去の実行履歴と成功・失敗
Feature Data実際に蓄積された値を照会
Backfill不足している期間を再度入力します
Backfillはサーバーに負荷をかけます

過去期間を再計算する処理であり、範囲が広いと時間がかかり、サーバー負荷が上昇します。 生産が少ない時間に、必要な期間だけに絞って実行してください。初めての場合は、管理者と相談することをお勧めします。

Document Parsing · Vision​

これら2つのサービスは共通メニュー4種のみを持ちます。コンソールでは正常に動作しているか確認し、問題が発生したときにログを確認する用途です。

  • Document Parsing — 文書からレイアウト・表・項目を抽出します
  • Vision — 画像から不良を判定したり、計器盤を読み取ります

どちらもブラウザから直接アクセスできない内部サービスなので、ホーム画面のカードはクリックできません。 コンソールが代わりに状態を問い合わせて表示しているのです。

こんな場合はこうしてください​

症状最初に確認する場所次に
チャットボットが文書を見つけられないRAG API → DocumentsQuery Testで直接検索 → Sync History
チャットボットの回答が遅いLLMのP95GPUの使用率・温度
分析結果が空であるInsight → Pipeline StatusRun Historyの失敗件
ホームに黄色いインジケータが表示されている状態リストを展開してツールチップを確認該当サービス → Logs
ホームに赤色のインジケータが表示されている該当サービス → Logsサービス運用の再起動手順
画面が空で、エラーバーが表示されているそのサービスがまだ起動していない可能性がありますホームで状態確認
「空である」と「ロードできない」は異なります

コンソールはデータを取得できないとき、空のテーブルに見せかけず、エラーバーを表示します。エラーバーが見える場合、データがないのではなく接続できていません。

アカウントとセッション​

コンソールのアカウントはデータベースではなく環境変数で設定します。

環境変数意味デフォルト値
ADMIN_AUTH_USERNAMEログインユーザーIDadmin
ADMIN_AUTH_PASSWORDログインパスワードなし — 必ず指定
ADMIN_SESSION_SECRETセッション署名キー空の場合、起動するたびに新規生成
ADMIN_SESSION_MAX_AGEログイン維持時間（分）480（8時間）
パスワードがなければ起動しません

ADMIN_AUTH_PASSWORDが空の場合、コンソールは起動を拒否します。認証のない管理ポータルが静かに開いているのを防ぐためなので、正常な動作です。

セッションが何度もログアウトされる場合

ADMIN_SESSION_SECRETが空の場合、サービスの再起動のたびに署名キーが新しく生成されるため、全員ログアウトされます。値を指定しておくと、再起動してもログイン状態が保持されます。

コンソールパスワードはbin/passwd.shで変更できません

bin/passwd.shが管理するキー一覧にコンソールアカウントは含まれていません。 (パスワード・APIキーの変更の表を参照) 変更するには環境ファイルで直接編集してサービスを再起動する必要があります。管理者にリクエストしてください。

関連ドキュメント​