記録リファレンス
プロジェクト内の操作の記録(記録 (証跡))と、実行記録のエクスポートについて、マーケットプレイス版で 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:…)が、サイクルではレジストリ・イメージ名・タグが出ます。