回到服務圖鑑Workers Logs
收集 Workers 的 invocation、console、例外與錯誤日誌。 快速找出 Worker 的請求錯誤、例外與執行脈絡。 查核 2026-10-19。查看官方額度、使用步驟與適合搭配的服務。
方案數據
- 日誌寫入
- 200,000 events / 日
- 保留時間
- 3 天（當前 Free 方案）
怎麼開始使用
確認 observability 設定
檢查 Worker 是否啟用日誌保存，依需要調整抽樣。
加入有用的紀錄
記錄任務 ID、階段與錯誤資訊，避免輸出 token、密碼或完整敏感內容。
重現問題並查詢
依時間、錯誤與識別碼過濾日誌；使用 source maps 協助定位原始程式。
注意保留期與變更
依查核日的額度規劃保存需求，並留意已公告的 Observability 新制。
和什麼搭配
- Workers：追查 API 的例外、驗證失敗與外部請求錯誤。
- Queues：以任務 ID 串起 Producer 與 Consumer 的紀錄。
- AI Gateway：新 Gateway 帳號的日誌政策與 Workers Logs 相關。
官方設定指南