同步失敗若只記「error」,三週後幾乎無法還原。以「能否重現單次同步嘗試」為標準,欄位優先級會變清楚。
建議至少保留:裝置識別、本機佇列項目 ID、業務物件 ID、嘗試序號、請求關聯 ID、伺服端回應碼、衝突裁決結果、時間戳(含時區)。
較少被重視的是「觸發原因」:前景開啟、背景排程、手動下拉或推播喚醒。少了它,很難判斷尖峰是產品行為還是錯誤重試風暴。
大型 payload 不必全文入日誌,保留雜湊與欄位變更摘要即可。
若現有系統不足,可先在閘道補關聯 ID,再逐步回填客戶端佇列狀態,避免一次大改。