SEARCH THE LAB

你想了解什么?

技能审核信息未提供

把定时任务日志写成能追查结果的收据

审核信息未提供入库时间: 2026年11月19日

很多定时任务的日志只有两行:「开始执行」「执行完成」。任务正常时看不出问题,出问题时也问不出东西——昨天到底跑没跑、跑了哪批数据、结果落在哪、有没有少一条。这种日志只能证明进程活过,不能证明事情做成了。收据的思路是反过来:先想清楚事后要追问什么,再决定写什么。 一张能用的收据至少回答四件事:哪一次运行(唯一标识)…

入库时间
下载量
0
人审标记
审核信息未提供

很多定时任务的日志只有两行:「开始执行」「执行完成」。任务正常时看不出问题,出问题时也问不出东西——昨天到底跑没跑、跑了哪批数据、结果落在哪、有没有少一条。这种日志只能证明进程活过,不能证明事情做成了。收据的思路是反过来:先想清楚事后要追问什么,再决定写什么。

一张能用的收据至少回答四件事:哪一次运行(唯一标识)、做了什么(输入范围与参数)、产出在哪(可定位的地址)、怎么核对(数量、校验值或退出码)。四件事里最常被省略的是后两件,因为写日志的人自己知道文件在哪,就以为别人也知道。缺一件,追查就会退化成翻服务器。

举个具体例子。假设有个每晚两点生成对账报表的任务,可以写成这样一行结构化日志:

run_id=20261119-0200 job=billing_report window=2026-11-18T00:00/2026-11-19T00:00 input_rows=18432 output=oss://reports/2026-11-19/billing.csv rows=18432 sha256=9f2c… exit=0 dur=47s

这行字不多,事后能做的事却很多:拿到报表文件就能比对 sha256,确认没被改过;input_rows 与 rows 相等,说明没有静默丢行;window 明确了统计区间,避免「昨天的报表算到几点」这种扯皮;run_id 能把这一晚的日志、告警和下游任务串起来。若 exit 非 0、dur 又异常短,基本可以直接怀疑连接失败,而不是数据问题。

还有一种常见情况是部分成功:处理了一万条,失败了三条。收据里应该同时写 ok=9997 fail=3,并把失败样本的标识记下来,而不是简单写一句 exit=0 了事。否则「跑完了」和「跑对了」之间的缺口,永远要靠人肉补。

有两点容易忽略。第一,结果要写成指针,不要写成内容。把整张报表打进日志,既撑爆磁盘,又把敏感字段散落到各处;写路径、行数、校验值就够了,需要时按图索骥。第二,同一个 run_id 要贯穿上下游:上游写了 run_id,下游在日志里注明「消费了哪个 run_id」,跨任务的因果链才接得上。否则只能靠时间戳猜,而多台机器的时间戳并不可靠。

还要区分「活着」和「做成了」。心跳日志解决前者,收据解决后者。两者都要,但别混在一起:心跳应短、频繁、几乎无信息量;收据只在一次运行结束时写一条,字段稳定、可解析。混在一起的后果是,出问题时你得在几千行心跳里捞那一行关键记录。

局限也得说清楚。收据证明的是「这次运行按记录的方式发生了」,不等于结果正确。统计口径写错了,日志里 rows 依然对得上,错的是业务逻辑;校验值只能防篡改和传输损坏,防不了上游给错数据。日志轮转与保留期要提前定:收据只留七天,而月末对账要追溯三十天,就等于没有。时钟偏差会让跨机器的时间线错位,关键排序尽量靠 run_id 和序号,而不是墙上时间。日志里也别放令牌、证件号这类东西,收据是给很多人看的。

真正省事的做法,是把收据字段当成接口来设计:字段名定下来就别随意改,下游的核对脚本、告警规则、报表都依赖它。改字段等于改契约,要么加版本号,要么新旧并存一段时间。这样一年后回头看,日志仍是一笔可以查的账,而不是一堆需要考古的文本。