Skip to content
功能模块

日志管理

日志管理记录执行状态、耗时、异常与补偿链,支持异常筛选、详情查看、中断重跑与自动清理。

更新于 2026-11-17MIT 开源

日志管理 ​

日志页记录每次执行的完整过程,是排查失败、识别中断与优化耗时的主要入口。

日志管理

1. 日志内容 ​

字段说明
作业名称 / 分组归属
状态运行中、成功、失败、已跳过、中断
开始时间 / 结束时间执行区间
执行时长列表按秒展示,详情展示完整时长
触发来源定时、手动、补偿重跑
执行消息作业写入的结果说明
错误信息 / 异常失败时的错误码与堆栈
作业数据执行参数快照,支持格式化与复制
恢复信息最后心跳、补偿状态、跳过原因等

2. 五种状态 ​

状态含义常见原因
运行中已开始、尚未结束正在执行,或崩溃后尚未判定
成功正常结束—
失败抛出异常或返回失败业务异常、接口报错、超时
已跳过本次未执行前置依赖未满足
中断未正常收尾进程崩溃、强杀、停机超时

「中断」不是「失败」:失败由作业自身报错,中断是执行过程被外部终止,记录停在运行中,由心跳超时判定。

3. 查询与筛选 ​

  • 按作业名称、分组搜索;
  • 按状态筛选;
  • 分别按「开始时间范围」与「结束时间范围」筛选;
  • 仅看异常:只显示失败与中断,开启后忽略状态筛选;
  • 服务端分页与排序;
  • 搜索条件、排序状态与列设置持久化。

「触发来源」用于区分问题来源:

来源说明
定时Cron 正常触发
手动「立即执行」
补偿重跑中断恢复或手动重新执行,可追溯到源记录

4. 日志详情 ​

日志详情

  • 顶部状态色条标识结果;
  • 元数据区展示作业、分组、时间、耗时与触发来源;
  • 执行信息与执行结果;
  • 错误信息与异常堆栈,可折叠查看;
  • 作业数据支持 JSON 格式化与复制;
  • 中断记录额外展示最后心跳、补偿状态与跳过原因。

5. 已跳过 ​

依赖不满足时写入「已跳过」日志,并在消息中说明原因:

text
前置依赖未满足,本次执行已跳过:
demo.job-a 最近一次执行状态为 Failed

可在状态筛选中单独查看,用于定位被依赖卡住的任务。详见 作业依赖。

6. 中断与重新执行 ​

中断记录来自进程崩溃、强杀或停机超时:

  • 展示最后心跳与补偿状态;
  • 若已自动补偿,「触发来源」显示「补偿重跑」,可回看原执行;
  • 仅中断行提供「重新执行」,提交前提示会整段重跑。

重新执行前会校验:

  • 记录必须是中断状态且未补偿;
  • 作业必须启用且未暂停;
  • 调度器必须处于运行状态。

不满足时直接拒绝并提示原因。补偿规则与语义边界见 中断恢复与排水调度。

7. 日志配置 ​

点击「日志配置」直接修改保留策略:

配置项默认值说明
启用自动清理开启关闭后置零两条限制,只能手动清理
保留天数30超过天数自动清理,0 = 不限制
最大保留条数0总数超过后删除最旧日志,0 = 不限
清理间隔(小时)6后台任务周期,1–168

后台服务在应用启动 60 秒后开始工作,按间隔循环执行;按天数与按条数可以同时生效。

text
[作业日志自动清理] 清理完成,共清理 153 条日志,下次清理间隔 6 小时

待补偿的中断记录(未补偿或补偿待处理)不会被按天数或按条数清理,避免丢失恢复依据。

8. 排查建议 ​

  1. 开启「仅看异常」,筛出失败与中断;
  2. 看时间分布:集中爆发还是零散失败;
  3. 打开详情阅读错误信息与异常堆栈;
  4. 对照作业数据确认入参;
  5. 中断记录先看最后心跳与补偿状态,再决定是否重新执行;
  6. 修复后手动执行一次,确认新日志为成功。
现象可能原因
同时段多条失败依赖服务不可用、连接数不足
耗时接近调度间隔任务过重,考虑拆分或开启禁止并发
大量「已跳过」前置依赖失败或未执行
长时间运行中任务卡住、外部接口无超时
中断集中出现发布重启、容器回收、强杀进程

9. 页面边界 ​

  • 不支持导出 Excel / CSV;
  • 不支持日志内容全文搜索;
  • 不提供按作业维度的统计报表;
  • 日志清理没有「立即执行一次」按钮,由后台任务按间隔执行。

让 Quartz.Net 调度,从未如此简单