---
{
  "id": "platform.cron.fire-events-and-debugging",
  "topic": "cron",
  "title": "Cron fire events 與除錯",
  "locale": "zh-TW",
  "version": "2026-09-06",
  "summary": "Cron 除錯要分開查看 schedule、dispatch 與每次 fire 的 execution result，不能把建立成功當成執行成功。",
  "content": "`get_job` 回傳最近 20 筆 fire events；`list_fires` 提供 keyset 分頁、status filter 與 `workflowRunId`/`messageId` 連結。建立排程不代表未來執行成功。result status 精確為 `success`、`partial`、`failed`、`skipped`、`timeout`、`unknown`；source 為 `agent`、`runtime_fallback` 或 `system`。\n\n依序檢查 status、`nextFireAt`、fire、delivery、result 與 source。reason 可區分 quota、權限、target unavailable/offline、timeout、排程耗盡與 invalid input；不能從沉默推定成功。\n\nmanual event 有 `manual: true`；`run_now` 不改排程、`runCount` 或 skip counters。以相同 idempotency key 重試會取得同一 event。skip 先持久化，replay 可補送 durable failure notification，且不重複 feed/push。`record_run_result` 只供 runtime bookkeeping。\n\nscheduler/outbox 間隔為 30/5 秒；outbox lock 75 分鐘，firing recovery 重驗已停滯 5 分鐘的 heartbeat。Agent missing result 在 300 秒 timeout，system target 不適用；fallback 是 unknown 而非 success，不重複 timeout 通知。system delivery 結算前維持 pending；action 使用 registry timeout 並更新 heartbeat。idempotency 保留 24 小時，completed job 保留 90 天。錯過多次 occurrence 時只 fire 一次再推進，尚無可設定 missed-run/overlap policy。delivered `workflow_run` 只代表已收單，需追蹤 linked run；沒有 Cron success callback/timeout，skip/failure 仍通知。排程訊息明文不得進 knowledge 或 routing telemetry。\n",
  "aliases": [
    "Cron fire event",
    "排程失敗",
    "錯過執行",
    "skipped execution",
    "timeout result",
    "近期 fires"
  ],
  "tags": [
    "cron",
    "debugging",
    "fire-event"
  ],
  "relatedActions": [
    "arinova.cron.get_job",
    "arinova.cron.list_fires",
    "arinova.cron.run_now",
    "arinova.cron.record_run_result"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/cron/fire-events-and-debugging/"
}
---

`get_job` 回傳最近 20 筆 fire events；`list_fires` 提供 keyset 分頁、status filter 與 `workflowRunId`/`messageId` 連結。建立排程不代表未來執行成功。result status 精確為 `success`、`partial`、`failed`、`skipped`、`timeout`、`unknown`；source 為 `agent`、`runtime_fallback` 或 `system`。

依序檢查 status、`nextFireAt`、fire、delivery、result 與 source。reason 可區分 quota、權限、target unavailable/offline、timeout、排程耗盡與 invalid input；不能從沉默推定成功。

manual event 有 `manual: true`；`run_now` 不改排程、`runCount` 或 skip counters。以相同 idempotency key 重試會取得同一 event。skip 先持久化，replay 可補送 durable failure notification，且不重複 feed/push。`record_run_result` 只供 runtime bookkeeping。

scheduler/outbox 間隔為 30/5 秒；outbox lock 75 分鐘，firing recovery 重驗已停滯 5 分鐘的 heartbeat。Agent missing result 在 300 秒 timeout，system target 不適用；fallback 是 unknown 而非 success，不重複 timeout 通知。system delivery 結算前維持 pending；action 使用 registry timeout 並更新 heartbeat。idempotency 保留 24 小時，completed job 保留 90 天。錯過多次 occurrence 時只 fire 一次再推進，尚無可設定 missed-run/overlap policy。delivered `workflow_run` 只代表已收單，需追蹤 linked run；沒有 Cron success callback/timeout，skip/failure 仍通知。排程訊息明文不得進 knowledge 或 routing telemetry。