運用監視

運用モジュールは、プラットフォームの稼働指標、システム情報、ログ、バックグラウンドタスク、エクスポート履歴、WebRTC セッションの状態を集約し、日常の点検と障害の切り分けに使用します。ページとデータ API はいずれも管理者ロールを必要とします。

前提条件

項目	内容
メニュー入口	管理 → 運用
ルート	/monitor、既定では /monitor/overview に入ります
ページ権限	「運用監視を表示」
表示ロール	管理者
データ API	監視、キュー、ログの各 API は管理者ロールを検証します
依存	Redis（運用指標ストリームとタスクキュー）、データベース

サブページ

サブページ	ルート	表示内容	データソース
モニタリング概要	/monitor/overview	データベース遅延、Redis 遅延、キュー滞留の現在値と推移	Redis 運用指標ストリーム
システム情報	/monitor/status	バージョン、ビルド日時、Node.js バージョン、稼働時間、ホスト名、オペレーティングシステム、アーキテクチャ、CPU コア数、総メモリ	サーバー側のビルド情報とホスト情報
システムログ	/monitor/logs	アクセス、アクティブユーザー、ログイン、操作、ワークフローの5種類のログ	アクセスと監査データ
バックグラウンドタスク	/monitor/jobs	システムキューとエクスポートキューのタスク一覧と操作	タスクキュー
エクスポート履歴	/monitor/exports	エクスポートタスクの履歴と成果物	エクスポート履歴
WebRTC	/monitor/webrtc	アクティブなルーム、パブリッシャー、オブザーバー、トラック数	WebRTC サービスのルーム一覧

稼働指標

モニタリング概要

/monitor/overview の上部に3枚の指標カード、下部に対応する推移グラフを表示します。

指標	意味	しきい値
データベース遅延	データベースの疎通確認にかかった時間	50ミリ秒未満は正常、50～200ミリ秒は警告、200ミリ秒以上は重大
Redis 遅延	Redis PING にかかった時間	10ミリ秒未満は正常、10～50ミリ秒は警告、50ミリ秒以上は重大
キュー滞留	各キューの待機タスク数の合計	100より大きいと警告、1000より大きいと重大

時間範囲	用途
1時間	リアルタイムの切り分け
24時間	日常点検
7日間	傾向分析

概要は30秒ごとに自動更新されます。「今すぐ収集」ボタンは指標の収集を1回手動で実行し、概要と推移を更新します。

システム情報

/monitor/status はアプリケーションとホストの情報を一覧で表示します。

項目	説明
バージョン、ビルド日付、ビルド時間	アプリケーションのビルド情報
Node.js バージョン	ランタイムのバージョン
稼働時間	プロセスの稼働時間
ホスト名、オペレーティングシステム、アーキテクチャ	ホスト情報
CPU コア数、総メモリ	ホストリソース

バックグラウンドタスク

/monitor/jobs は2つのキューのタスクを管理します。

キュー	名前	処理するタスク
システムキュー	iojobs	データ前処理などのシステムレベルのタスク
エクスポートキュー	ioexports	データエクスポートタスク

タスクのステータス	説明
waiting	待機中
active	実行中
completed	完了
failed	失敗
delayed	遅延
paused	一時停止

操作	作用	制約
キューを一時停止	そのキューの処理を停止します	新規タスクの実行に影響します
キューを再開	そのキューの処理を再開します	なし
待機中をクリア	そのキューの待機タスクをすべて削除します	削除後は復元できません
履歴をクリア	24時間より前に完了・失敗したタスクを削除します	なし
失敗を再試行	失敗したタスクを一括で再試行します	1回あたり最大1000件
再試行	失敗したタスクを1件再実行します	失敗したタスクのみ
停止	実行中のタスクを停止します	実行中のタスクのみ
削除	待機中のタスクを削除します	待機中のタスクのみ

警告

キューの一時停止は新規タスクの実行に影響し、待機中のクリアは待機タスクを削除します。

WebRTC 監視

/monitor/webrtc は現在アクティブなルームを一覧表示します。

列	説明
Agent ID	ルームに対応するデバイス Agent ID とパブリッシャー IP
ステータス	オンライン、切断
開始時間	セッションの開始時間
トラック数	ルームのメディアトラック数
オブザーバー	オブザーバー数と IP
操作	強制切断

強制切断は確認と、再接続を禁止する時間（時間単位）の設定が必要です。0 を設定すると禁止しません。

履歴の照会

システムログ

サブページ	ルート	記録内容	絞り込み項目
ログ概要	/monitor/logs	本日のログイン失敗、本日のアクティブユーザー、本日の重要操作、本日のデータ閲覧。直近のログイン失敗とロックされたユーザー	なし
アクセスログ	/monitor/logs/visit	データ、アカウント、閲覧 IP、閲覧時間	データ、アカウント、IP、時間
現在のアクティブユーザー	/monitor/logs/active	ユーザー名、アクティブ時間、IP アドレス	時間範囲 1日、7日、30日
ログインログ	/monitor/logs/login	ユーザー名、結果、IP アドレス、ログイン種別、エラーメッセージ、時間	ユーザー、ユーザー名、IP、時間範囲、結果
操作ログ	/monitor/logs/operation	ユーザー名、操作内容、IP アドレス、時間	ユーザー、IP、時間範囲
ワークフロー履歴	/monitor/logs/workflow	ルール ID、時間、説明	ワークフロー、データセット、一致ルール、アクションルール、時間範囲

ログ概要には、ロックされたユーザーを即時に解除する入口があります。現在のアクティブユーザーのページでは、管理者がアカウントを無効化します。モジュール権限の変更は独立した監査記録に書き込まれ、運用モジュールにはその記録を表示するページはありません。

エクスポート履歴

/monitor/exports は「エクスポート一覧を表示」権限が必要で、再エクスポートには「エクスポートタスクを作成」権限が必要です。

項目	説明
ID、ファイル名、タイプ	エクスポートタスクの識別子と成果物
エクスポートパラメータ、ステータス、ユーザー、データセット、作成日時、完了日時	タスク情報
ステータス	待機中、処理中、実行中、完了、失敗
タイプの絞り込み	lerobot、hdf5、mcap
操作	再エクスポート。タスクを再度キューに入れます。完了した記録は成果物をダウンロードできます

トラブルシューティング

現象	考えられる原因	対処	責任者
概要にデータがない	まだ収集していない、Redis が利用できない	「今すぐ収集」をクリックします。Redis 接続を確認します	運用
データベースまたは Redis の指標が重大になる	対象サービスの応答が遅い、コネクションプールの枯渇、ネットワークの揺らぎ	対象サービスの負荷と接続を確認します	運用
キューの滞留が続く	タスク量が処理能力を超えている、Worker が稼働していない、1件のタスクに時間がかかりすぎている	Worker の状態を確認し、必要に応じてキューを一時停止して待機タスクをクリアします	運用
タスクが長時間実行中のままになる	Worker の異常、タスクのブロック	そのタスクを停止して再試行します	運用
ログページにデータがない	時間範囲に記録がない、絞り込み条件が狭すぎる	時間範囲を広げるか、絞り込みを解除します	管理者
WebRTC ルームを強制切断できない	リクエストに失敗した	操作を再試行し、WebRTC サービスの状態を確認します	運用

関連ページ

ページ	用途
システム設定	システムパラメータとログ関連の設定
データエクスポート	エクスポートタスクの作成と割り当て
モジュール権限	モジュール権限の設定
データ管理	特定のデータセットの特定
ゴミ箱	削除済みデータの復元