メインコンテンツへ移動
ドキュメント走る実行監視

実行の監視とログ記録

実行一覧、リアルタイムイベントストリーム、ログ / コスト / tokens、エラーの特定 —— 実行状態を明確に把握します。

ワークフローを実行した後、「それが実際に何をしたか、どれだけコストがかかったか」を把握できるかどうかが、それを本番に投入する決断につながります。このページでは、実行一覧、実行詳細、リアルタイムイベント、token とコストの記録、エクスポート、データダッシュボードについて説明します。

実行リストページ

左側ナビゲーションの「実行履歴」です。カードとテーブルの 2 つのビューに対応し、実行が動作中の場合は一覧が自動更新されます（一時停止可能）。フィルタリングと並べ替え:

  • キーワード検索 —— 実行 ID またはワークフロー名で検索します
  • ステータスフィルタ —— PENDING / RUNNING / COMPLETED / FAILED / CANCELLED / INTERRUPTED
  • ワークフローのフィルタリング - 特定のワークフローの履歴のみを表示します
  • 並べ替え —— 開始時刻 / 完了時刻 / 所要時間 / ワークフロー / ステータス / 進捗

一覧の上部には、件数付きのクイックフィルタ（実行中 / 失敗 / 完了 / 中断）が一列並んでおり、クリックで切り替えます。

各レコードに表示される情報

  • ステータスバッジ + 実行 ID + ワークフロー名
  • プログレスバーとステップ完了数（例: 5/7）
  • 開始時刻（相対時刻）と所要時間
  • RUNNING のレコードには、現在動作中のステップが追加で表示されます
  • 終了済みのレコードは、行内で直接 JSON / YAML にエクスポートできます

複数選択した後、動作中の実行を一括キャンセルしたり、終了済みのレコードを一括削除したりできます。

6 種類のステータスの意味
  • PENDING — 作成済みで、まだ実行を開始していません。並列数の上限を超えた実行は、まずこの状態でキューに入り、先行する実行が完了すると自動的に RUNNING に移行します。
  • RUNNING — 少なくとも 1 つのステップが実行中です。
  • COMPLETED — すべてのステップが実行完了しました（condition が満たされずに SKIPPED になったステップを含む）。
  • FAILED — あるステップでエラーが発生し、実行が失敗して終了しました。
  • CANCELLED — ユーザーが手動でキャンセルしました。
  • INTERRUPTED — サービス再起動などのシステム的な理由で中断されました。自動再開するかどうかは、下記の「次のステップ」にある自動再開ページを参照してください。

実行の詳細ページ

任意の実行をクリックして詳細ページに入ります。上から順に:

  • 上部バー —— キャンセル、更新、エクスポート（JSON / YAML）、対応するワークフローエディターへのジャンプ
  • ステータスカード —— ステータス、進捗、所要時間、および token のクイックビュー（送信 / 受信 / 合計）
  • メインエリアのタブ（下表を参照）
  • 下部の「実行ログ」ストリーム —— すべてのイベントのスクロールログで、レベル（debug / info / warn / error）でフィルタリング、キーワード検索、自動スクロールの一時停止ができます
タブコンテンツ
ステップ縦並びのタイムライン: 各ステップのステータス、所要時間、イテレーション進捗。クリックするとステップ詳細のサイドバーが開きます。実行終了後、指定したステップから再実行できます。
対話Agent の発言、LLM の出力、ツール呼び出し、システムメッセージを時刻順に 1 つのチャットストリームに統合します。
外部メッセージIM チャネルの送受信記録のみを表示します（Slack / Telegram など）。
DAG依存関係に従って描画されたステップ図で、実行状態がリアルタイムで色付けされます。
再生タイムラインに沿ってこの実行の過程を再生します。
推理の連鎖Agent の中間的な推論内容。
成果物すべての成果物ファイル: プレビュー、ダウンロード、単一ファイルの共有、またはディレクトリ全体を 1 つの公開リンクとして生成します。
パフォーマンス実行終了後の所要時間分析。
デバッグブレークポイントを設定したか、デバッグセッションがある場合に表示されます。

ステップ詳細サイドバー

タイムライン内のあるステップをクリックすると、右側にそのステップのすべての情報がスライドして表示されます: 出力、イベント、推論、成果物、対話などのタブ（イテレーション / インタラクション / オーケストレーション系のステップには対応する追加タブがあります）、加えて開始 / 終了時刻と「このステップから再実行」ボタンです。失敗したステップのエラー情報と再試行回数もここで確認できます。

リアルタイム更新（WebSocket）

実行が RUNNING 状態のとき、詳細ページは WebSocket を通じて差分更新を受け取り、手動での更新は不要です。接続が切断されると自動的に再接続します（指数バックオフ、最大 5 回）。それでも失敗した場合は、自動的に 2 秒ごとのポーリングに切り替わり、その旨が通知されます。

プッシュメッセージのタイプ

タイプ意味
full_status実行状態の全量スナップショット
status_change実行状態 / 進捗の変化
step_update個々のステップの状態更新
new_event新しい実行イベント（下記のイベントタイプを参照）
artifact_found新しい成果物ファイルの生成
user_interaction_requestステップが手動入力を要求すると、対話ページに返信欄が表示されます

イベントタイプの一覧

各ステップのイベントストリームは type フィールドでイベントの種類を区別します。よくあるタイプをファミリー別に挙げます。

イベントの種類意味
agent_starting / agent_completed / agent_failedAgent ステップのライフサイクル
llm_call_starting / llm_call_completed1 回の LLM 呼び出し。completed イベントにはこの呼び出しの token 数が含まれます
llm_streaming_starting / llm_streaming_completed / llm_streaming_failedストリーミングの LLM 出力
tool_call_starting / tool_call_completed / tool_call_failedAgent のツール呼び出し。引数と結果の要約を含みます
external_message / im_message / telegram_messageIM チャネルのメッセージ送受信
group_chat_started / group_chat_message / group_chat_summarizing / group_chat_completedgroup_chat ステップにおける複数 Agent の議論プロセス
state_machine_started / state_machine_transition / state_machine_state_completedstate_machine ステップの状態遷移
agent_based_started / agent_based_completedagent_based オーケストレーションステップの委譲プロセス
user_interaction_request / user_interaction_message / user_interaction_timeout実行中にユーザーへ質問し、返信を受け取り、タイムアウトを待ちます
claude_code_*Claude Code 実行時のストリーミング進捗イベント

イベントには同時に category フィールド（agent / llm / tool / message / strategy / user_interaction）が付き、対話ページのカテゴリフィルタはこれに基づいてグループ化します。

対話ビューのフィルタリング

  • キーワード検索 —— メッセージ内容と発言者の中から検索します
  • Agent でフィルタリング —— 特定の Agent またはステップのメッセージのみを表示します
  • カテゴリフィルタ —— Agent / LLM / ツール / 外部メッセージ / 戦略 / インタラクション
  • 自動スクロールの切り替え —— 新しいメッセージが届いたときに末尾まで追従してスクロールするかどうか

token とコスト

  • LLM 関連のイベントは input / output の token を都度記録し、ステータスカードは送信 / 受信 / 合計をリアルタイムに累積して表示します。
  • 実行終了後、GET /api/executions/{executionId}/cost 使用したモデルの価格に基づいてこの実行のコストを推定し、総額と各ステップの明細を返します。
  • コストは事後に token 使用量に基づいて推定されるものです。プラットフォームは実行前の見積もりを提供しません。

エクスポート実行処理

詳細ページの上部バーまたは一覧の行にある「エクスポート」は、1 回の実行を JSON または YAML ファイルとしてエクスポートします。内容には実行状態、結果、パフォーマンス指標、およびエクスポート時点のワークフロー定義のスナップショットと YAML ソースコードが含まれます。パスワード、API Key、webhook アドレスなどの機密フィールドは自動的に [REDACTED] に置き換えられます。ファイル名は以下のような形式です execution-process-79621f70-completed.json。

エクスポート内のワークフロー定義は、エクスポート時に取得された現在のバージョンです。この実行の後にワークフローが変更されている場合、実行時点の定義と異なる可能性があります。

データダッシュボード

実行をまたいだ集約ビューは以下にあります 分析 ダッシュボード: 総実行回数、成功率、平均所要時間、token 総使用量に加え、実行トレンド、ステータス分布、Top ワークフローランキングを表示します。時間範囲は 24 時間 / 7 日 / 30 日から選択できます。

エラー箇所

実行が FAILED になったときは、まずタイムラインで赤いステップを見つけ、ステップ詳細を開きます。エラー情報は「出力」タブに、プロセスの詳細は「イベント」タブにあります（code ステップの stderr もここにあります）。再試行したステップには再試行回数が表示されます。

よくあるエラーの対処方法は以下を参照してください トラブルシューティング。

保存期間

実行記録（状態、結果、イベント、パフォーマンスデータ）と成果物ファイルはデフォルトで 90 日間保持され、期限が来るとプラットフォームが定期的に削除します。具体的な期間はあなたのプランまたは展開設定を基準とします。実行がまだ動作中の場合は削除されません。

次のステップ