記録と指標
記録は成績表だと思うかもしれません。そうではありません。 記録は、1 回の実行を追うための材料です。それが業務としてうまくいったかどうかは、記録だけでは分かりません。
このページでは、実行記録をどう読むのかと、数字が何を表していないのかを説明します。見方の手順は記録ガイドにあります。
実行記録は、1 回の実行を追うための材料
実行記録の画面は、「依頼」「根拠」「実行したこと」「確認」「結果」の 5 つの見出しで、1 回の実行を起点から終わりまで追えます。依頼には、何がきっかけで始まったか(巡回・Webhook・外部 API・手動など)が出ます。
実行記録は、1 回の実行の詳細です。どの登録 Agent が、どの設定で動いたかを追えます。実行記録には「実行環境のイメージ」が出ます。その実行で動いた登録 Agent のコンテナのイメージです。ワークフローでは、管理者が認定した image digest が出ます。
実行中の実行記録の「依頼」の欄には、経過時間と操作の件数(「操作 N 件」)が出ます。連携先の件数の内訳は出ません。
ワークフローの実行は、案件の画面からもたどれます。設定と成果物のバージョンは、案件の画面で見ます(案件ガイド)。
結果は実行の終わり方を表す
結果の欄が示すのは、その実行がどう終わったかです。業務目標が達成されたかどうかではありません。
「完了」は、Agent が完遂として終えた(「完遂できなかった」という宣言も、実行ルールによる拒否・実行上限の超過・異常終了も無かった)という意味です。成果物が意図どおりかは、中身を見て確かめてください。
「実行終了 (完遂は未計測)」は成功でも失敗でもない
サイクルの登録 Agent は、処理を終えて正常に終了しても、仕事を果たしたかどうかを基盤は判断できません。 そのような実行の結果は「実行終了 (完遂は未計測)」になります。成功にも失敗にも数えず、完遂率などの指標の母数に入りません。Agent が完遂したかを報告する作りになっていれば、通常の結果で記録されます(記録ガイド)。
指標は実行記録を集計したもの
指標は、記録を数え上げたものです。だから記録を読むときの注意が、そのまま数字にも表れます。母数になるのは、ワークフローでは工程に置いた登録 Agent の実行(確認工程や通過した工程は除く)、サイクルでは登録 Agent の実行(周期の巡回と、Webhook での起動の両方)です。「実行終了 (完遂は未計測)」は母数に入りません。
完遂率が高くても、業務がうまくいったとは言えません。 「完了」が、Agent が完遂として終えたという意味にとどまるからです。
業務の成果は、記録と成果物で判断する
ここまでの話は 1 つに集まります。実行記録は成績表ではありません。 うまくいったかどうかを知りたいなら、数字を見るだけでは足りません。実行記録と、実際の成果物を合わせて判断してください。記録が答えるのは「何が起きたか」までで、「それでよかったか」を決めるのは利用者です。