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 和序號,而不是牆上時間。日誌裡也別放令牌、證件號這類東西,收據是給很多人看的。

真正省事的做法,是把收據欄位當成介面來設計:欄位名定下來就別隨意改,下游的核對指令碼、告警規則、報表都依賴它。改欄位等於改契約,要麼加版本號,要麼新舊並存一段時間。這樣一年後回頭看,日誌仍是一筆可以查的賬,而不是一堆需要考古的文字。