7分で読了

スケジューラーエージェント管理ガイド

プロジェクト（CSN）ごとに登録された自動化ランナー（gissue スケジューラーなどのバックグラウンドエージェント）のオンライン/オフライン状態、実行状態・履歴、リアルタイムログを1つの画面で管理します。

🕐 スケジューラーエージェント管理ページへ →

📋 概要

スケジューラーエージェント管理は、現在選択中のプロジェクト（CSN）に登録されているすべての自動化エージェント — 例えば gissue の毎時スケジューラーや対話型 Claude Code セッションなど — を表示します。giip の イシュー を猫で可視化する /admin/catquest とは異なり、この画面は 自動化ジョブを実行するエージェント自体 を管理する運用ダッシュボードです。各エージェントが生きているか、現在の実行が正常か、ログはどこで確認できるかを把握します。

🎨 ステータスカラー

エージェントごとに、互いに独立した2つのステータス信号が表示されます — 混同しないでください。

Identity ステータス（エージェント名の横の小さなドット）

個々の実行（run）とは無関係に、エージェントプロセス自体に到達可能かどうかを示します（tSchedulerAgent.status）。

色	ステータス	意味
🟢 緑	online	エージェントに到達可能で正常に報告中
🔴 赤	error	エージェントがエラー状態を報告
⚪ グレー（slate-400）	offline	現在エージェントに到達できない
⚪ 薄いグレー（slate-300）	unknown	まだステータスが報告されていない

実行ステータス（Status 列のバッジ）

直近のスケジューラー 実行（run） の状態（currentStatus）と stale（停滞）検出結果を反映します。

色	表示ラベル	条件	意味
🟢 緑	RUNNING	`currentStatus = RUNNING` かつ stale でない	正常に実行中
🔴 赤	STALE	`currentStatus = RUNNING` かつ `isStale = true`	実行中と表示されているが heartbeat が長時間途絶えている — 停止/ゾンビ実行の可能性
🟠 オレンジ	STALE	`currentStatus = STALE`（明示的な値）	バックエンドが実行自体を stale と判定
⚪ グレー	ENDED	`currentStatus = ENDED`	終了（正常完了または正常な停止）
⚪ グレー	（元の値）	それ以外 / 実行履歴なし	不明 / データなし

下記の実行履歴モーダルでは、完了した実行が赤色の FAILED として表示されることもあります — ENDED（正常終了）や stale/タイムアウトとは区別される、エラーで終了した実行です。

🔍 画面構成

1. ヘッダー

/admin/catquest に戻る矢印（←）。
Refresh: 現在の CSN のエージェント一覧を再読み込みします。

2. Open Interactive Sessions

アクティブな claude_interactive_session エージェント — つまり現在ホスト上で実行中として登録されている対話型 Claude Code セッション — が1つ以上ある場合のみ、別カードとして表示されます。各行にはセッション名、ホスト、最終通信時刻、そしてエージェントの capabilities にセッション URL が登録されている場合の 「Open session」 リンクが表示されます。

3. エージェント一覧（テーブル）

スケジューラーエージェントごとに1行表示され、以下の情報を含みます。

Name — identity ステータスドット、エージェント名、OS/エージェントタイプ/バージョンバッジ、lssn（連携サーバー）、省略された capabilities 要約、最後のエラー（あれば）。
Host — hostIdentifier。
Windows Task — 該当する場合、このエージェントを実行する Windows タスクスケジューラのタスク名。
Project — プロジェクト名。
Active — ON/OFF バッジ（isActive）。
Last Comm — 最終 heartbeat/通信時刻。
Status — 上記の実行ステータスバッジと、報告されていれば現在のフェーズ（phase）テキスト。

下部の統計フッターには、表示中の全エージェントの 処理（Processed）/ スキップ（Skipped）/ 失敗（Failed） 件数の合計が表示されます。

4. 実行履歴（Run History）

テーブルの下にある「View History」カードに全エージェントが再度一覧され、行の History ボタンをクリックするとそのエージェントの直近の実行一覧がモーダルで表示されます — 実行モード、ステータス（FAILED を含む）、開始/終了時刻、所要時間、処理/スキップ/失敗件数、フェーズ、サマリー。

5. リアルタイムログビューア（Live Log Viewer）

2ペイン構成のリアルタイム tailing 画面です。

左（エージェント→ストリームツリー）: エージェントごとにグループ化され、展開すると既知のログストリーム一覧が表示されます（ストリームは streamKey で識別され、streamType とローテーション世代番号を持ちます）。エージェントは最終通信時刻に基づいて online/offline が表示されます。
右（ログストリームカード）: ストリームを選択すると直近のログ行が表示され、リアルタイム tailing のために継続的に更新されます。

💡 注意事項

この画面は 管理者専用 です。AdminGuard（uLevel ≥ 70）の権限が必要です。
エージェント一覧、実行履歴、ログカタログはすべてセッションの現在の CSN を基準に取得されます — 別プロジェクトのエージェントを確認するには、上部ナビゲーションでプロジェクトを切り替えてください。
データ取得には認証済みセッション（AK トークン）が必要です。リクエストが認証エラーで失敗し始めた場合は、再度ログインしてから Refresh を押してください。
このページは /admin/catquest とは別のツールです — CatQuest 画面のナビゲーション経由で到達したからといって、CatQuest の猫可視化データや対象ユーザーを共有しているわけではありません。

トラブルシューティング

症状	原因	解決方法
「Authentication required」エラー	AK/セッショントークンが見つからない	再ログイン後、ページを再読み込みしてください。
エージェント一覧が空	この CSN に登録されたスケジューラーエージェントがない、またはプロジェクトの選択が誤っている	上部ナビゲーションで正しいプロジェクト（CSN）が選択されているか確認してください。
ジョブがアイドル状態のはずなのに行が赤い STALE と表示される	エージェントが ENDED に遷移せず実行中に heartbeat 送信が停止（`isStale = true`） — プロセスがクラッシュまたは強制終了された可能性	エージェントのホストを直接確認してください。再起動して再度報告が始まればバッジは更新されます。
Live Log Viewer に「No streams yet.」と表示される	エージェントがまだログストリームを登録していない、またはカタログの最終更新以降に出力がない	エージェントの次回実行を待つか、エージェントプロセスが実際にログを書き込んでいるか確認してください。
Open Interactive Sessions に「Open session」リンクがない	該当エージェントの登録済み capabilities に `sessionUrl` が含まれていない	開ける項目はありません — その対話型セッションが到達可能な URL を登録していません。

バージョン: 1.0 最終更新: 2026-08-29 ソースファイル: giipv3/public/help/catquest-schedulers.ja.md