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

記録リファレンス

プロジェクト内の操作の記録(記録 (証跡))と、実行記録のエクスポートについて、マーケットプレイス版で SaaS 版と違う点をまとめます。記録の見方は記録ガイド、SaaS 版と共通の出来事の一覧はSaaS 版の記録リファレンスにあります。

加わる出来事​

出来事残るとき
案件設定の変更案件の設定を新しいバージョンにしたとき
外部条件の成立で進行外部条件待ちの確認で、条件が成立して基盤が次の工程へ進めたとき(人の承認とは区別されます)
条件分岐の判定/条件分岐で人に確認SaaS 版と同じに残ります

共通の出来事(記録に残るもの)​

SaaS 版と同じ名前で、マーケットプレイス版でも記録に残る出来事です(記録を書く処理から確認できたもの)。

種別CSV の event_type
確認の依頼・確認結果・期限の催促・期限超過・期限延長・担当の付け替えgate.requested・gate.resolved・gate.due_soon・gate.overdue・gate.extended・gate.reassigned
案件の担当の付け替え(案件ごと)run.approvers_reassigned
案件の開始・開始できなかった・締め切りの設定・締め切り超過・停滞run.started・run.start_failed・run.deadline_set・run.deadline_overdue・run.stalled
通知の送信(送信待ち・送信完了・送信できなかった・送信できたか不明)delivery.accepted・delivery.acked・delivery.failed・delivery.unconfirmed
本文の閲覧・実行記録のエクスポートforensic.viewed・forensic.exported
定義の変更・承認の提出・承認・差し戻し・取り下げproject.definition_changed・project.definition_submitted・project.definition_approved・project.definition_rejected・project.definition_withdrawn
実行ルール・メンバー・役割の変更policy.changed
条件分岐の判定・条件分岐で人に確認branch.decided・branch.asked_human
完了の報告が、すでに閉じた案件や古い試行へのものだったため、受け付けずに無視したcompletion.stale
定義の書き出し・取り込み・ひな形・外部公開・持ち主の変更・削除project.exported・project.imported・project.template_published・project.template_unpublished・project.created_from_template・project.exposure_changed・project.ownership_transferred・project.deleted

マーケットプレイス版にだけある出来事は次のとおりです。登録 Agent が SDK で報告する操作(tool.invoked・tool.effect・tool.denied)も、記録に残ります。context.manifest は保存されますが、記録の画面と記録の CSV には出ません。基盤が 1 つずつ止める操作の記録ではなく、Agent が自分で報告した内容です。

event_type何が起きたとき
case.config.changed案件の設定を新しいバージョンにした(案件設定の変更)
artifact.created成果物が作られた(Agent の出力、または人の編集版)
gate.observed_external外部条件待ちの確認で、連携先の状態を読んだ

記録 (証跡) の CSV​

「CSV出力」で、いま選んでいる種別の記録を、5000 件まで出力します。理由の入力が必要で、本文の閲覧と同じく記録に残ります。列は次のとおりです。

列内容
occurred_at時刻(UTC)
event_type出来事の種類
actor利用者なら名前。それ以外は、記録した仕組みの名前か、実行者の区分
decision決定や判定の値
reason理由
step工程名
workitem確認依頼の題名
run_id案件(実行)の ID
root_execution_id実行の ID
metadata記録に付いた参照の情報(JSON)

ない出来事​

次の出来事は、記録に出ません。

  • 接続の確認の失効(gate.cancelled)
  • 実行の再開(run.resumed)と、並列のレーンの合流(run.lane_joined)
  • メールでの起動の拒否(mail.rejected)
  • 外部の自動化の呼び出し(automation.called)
  • 巡回再実行要求(sweep.rerun_requested)
  • 改善案の相談と実施(consult.*・improvement.applied)
  • ライブラリのファイルの登録・新しいバージョンの追加(library.*)

実行記録とエクスポートに出る項目​

実行記録には「実行環境のイメージ」が出ます。実行記録のエクスポートにも、動いたイメージのタグが出ます。ワークフローでは管理者が認定した image digest(sha256:…)が、サイクルではレジストリ・イメージ名・タグが出ます。