Admin 定时任务：Cron 运行记录

确认后台任务跑没跑、跑了多久、有没有失败：在 Admin → 定时任务按任务、状态、日期筛本组织的 cron 运行记录。

Docklify 里有些活是定时在后台干的——没人点按钮，到点它自己跑。Admin → 定时任务就是事后查这些运行的地方：每跑一次留一行，写着开始时间、跑了多久、成功还是失败、这趟干了什么的结果摘要，失败的还有报错信息。这一页只显示您自己组织的运行记录，只有 Owner 和 Admin 角色能打开。

第一步：打开运行记录，读懂一行#

1. 打开 Admin → 定时任务（/admin/cron-runs），运行列表会自动加载——这里没有要启动或配置的东西。
2. 随便挑一行，从左到右读：开始时间、任务名、耗时、状态、结果摘要、报错。
3. 列表很长时，用表格底部的翻页往后翻——默认每页显示 50 条。

• 「开始时间」是这趟运行开始的那一刻，精确到秒——用它把某次运行和「本该在那个时间发生的事」对上。
• 「任务」是定时任务的名字，按系统里叫的名字原样显示。
• 「结果摘要」是这趟运行产出的简短清单——用键值形式写的数量和结果。摘要太长时表格里会截断，所以把这一行当标题看，不要当完整报告。
• 没失败的运行，「报错」列是空的（横杠）。失败的运行会显示报错信息，表格里会截断——把鼠标悬停在上面可以看全文。

一行是一次运行——不是一个任务。同一个任务每跑一次就多一行，健康的任务会在几天里攒下长长一串行。看 Admin → 定时任务这张表时，您其实是在读这条轨迹：找到您关心的那段时间附近的行，再按筛选后的顺序读下去。

第二步：按任务、状态、日期筛选#

1. 在表格上方的筛选卡里选「任务」——或留「全部」，把所有任务放一起看。
2. 只关心某一种结果时选「状态」——比如选 Failed（失败），就只看跑出问题的那些次。
3. 设好开始日期和结束日期，把列表收窄到一段时间——某个晚上、某一周，哪段时间发现的问题就查哪段。
4. 点「搜索」。列表会带着您的筛选条件从第一页重新加载。

Admin → 定时任务的任务下拉里，列着会给本组织上报运行记录的定时任务——employee-term-sweep、abc-analysis 和 sequence-runner。想回答「这个任务最近到底跑没跑」，选它是最快的办法：它的行按节奏不断出现、状态都是 Success（成功），就是一直在跑。

第三步：读懂状态与耗时#

• success（绿）——这趟跑完了，活干完了。
• failed（红）——这趟带着错误停了。先读同一行的「报错」列，再做别的。
• running（黄）——这趟已经开始、还没跑完。过一会儿再来看；跑完后它会变成 success 或 failed。
• 「耗时」以秒显示，跑得久的会写成分钟加秒（比如 2m5s）。显示横杠表示这趟还没有记下耗时——还在跑的时候常见。

状态和耗时要连着读。一次 success 如果突然比平时慢了十倍，虽然跑过了也值得记下；一次 failed 如果耗时特别短，多半是刚开始就停了——同一行的报错会写停在哪。把一次运行和这个任务在 Admin → 定时任务里的更早几行对比，是发现这两种情况最快的办法。

第四步：排查一个怀疑没跑的任务#

1. 按那个任务筛选，日期范围设成它本该运行的那段时间，点「搜索」。
2. 那个时间段里一行都没有，说明那段时间没有记下任何运行——任务没跑，或者跑了但没有上报。
3. 有一行是 failed，说明它跑了但撞上了问题：把任务名、开始时间、报错全文（悬停看全）记下来——找支持时要的就是这三样。
4. 有一行开始很久了还停在 running，值得过一会儿再看一次——重新搜索，看它有没有变成 success 或 failed。

本文用到的 Docklify 功能#

• 本组织的 cron 运行记录（开始时间 / 任务 / 耗时 / 状态 / 结果摘要 / 报错）——Admin → 定时任务（/admin/cron-runs）
• 按任务、状态、日期范围筛选运行记录（带搜索按钮）——Admin → 定时任务（/admin/cron-runs）
• 一眼读懂状态（running / success / failed，按颜色区分）——Admin → 定时任务（/admin/cron-runs）
• 失败运行的报错全文（悬停「报错」单元格查看）——Admin → 定时任务（/admin/cron-runs）