Cloudflare Workers 新增 Issues 功能:檢測並直接將生產問題傳送給 Agent
Detect and send production issues straight to your agent
Cloudflare Workers 新增了 Issues 功能,可自動檢測生產錯誤並將完整上下文傳送給 Agent,幫助快速定位並修復問題。
Issues 能將重複異常、5xx 響應和錯誤日誌聚合為單一問題,並通過 Automations 將錯誤摘要、堆疊、日誌、跟蹤及 Worker 版本推送給配置好的 Agent。
AI 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:
隨著AI 助理(agent)協助我們構建更復雜的應用程式,人類和AI 助理都需要更好的方式來掌控生產環境中出現的問題。編碼AI 助理已經能夠查詢可觀測性資料、瀏覽程式碼庫、修改程式碼、編寫測試並提交拉取請求(pull request)。目前仍然需要人工手動完成的是將這些步驟串聯起來:識別出重複的故障源自同一個 Bug、收集相關的日誌與鏈路追蹤、將這些上下文傳送給AI 助理,並檢查修復是否生效。如果沒有這種結構化的交接,AI 助理在調查之前就必須搜尋原始遙測資料來重建故障的範圍和上下文。
今天,我們推出 Cloudflare Workers 內建錯誤監控功能 Issues(現已開放公測!),以簡化這一工作流程。Issues 可以:
- 將重複的異常、5xx 響應和錯誤日誌歸類到一個問題中。
- 將錯誤、堆疊追蹤、日誌、鏈路追蹤和 Worker 版本傳送給配置好的編碼AI 助理。
- 觸發AI 助理配置的工作流程——從分類問題到查詢更多資料再到開啟拉取請求。
使用以下針對AI 助理的提示詞以及 CF CLI 修復你的第一個問題,或者檢視 文件 以開始使用:
複製提示詞:為 cf 設定
Set up cf: https://developers.cloudflare.com/cf/. Enable Issues for this Worker in cloudflare.config.ts; show the diff and ask before deploying. After approved deployment, wait 1 minute, then find the most frequent issue and retrieve an occurrence using its returned ID:
cf observability issues list --order-by count --order desc --per-page 1
cf observability issues occurrences <ISSUE_ID> --per-page 1
If no issues exist, report that. Otherwise, diagnose from the details, fix locally, run relevant checks, and show the diff and results. Ask before deploying the fix.自動捕獲故障
只需一行配置,你就可以開始接收 Worker 上檢測到的 Issues,無需額外的程式碼埋點。Issues 內置於 Workers 執行時中,因此無需安裝 SDK 或新增應用程式包裝器。
一旦啟用,Issues 會記錄未捕獲的異常、失敗的呼叫、HTTP 5xx 響應、console.log() 和 console.error() 的輸出,以及包含堆疊追蹤的日誌。它還會標記失控的定時器條件以及在迴圈內部寫入大量日誌的程式碼。
設想有一個 Worker,其處理程序在部署後開始丟擲錯誤。每次失敗的請求都有不同的請求 ID,但它們都源自同一個 Bug。Issues 會將它們歸類在一起,並顯示錯誤首次出現的時間、發生的次數以及它是否變得更加頻繁。
當你開啟一個問題時,你可以看到錯誤、可用的堆疊追蹤、導致該錯誤的日誌和鏈路追蹤、Worker 版本、請求詳情以及該問題隨時間變化的趨勢,如下所示:
為你的AI 助理提供錯誤上下文
Cloudflare 可以捕獲 Worker 內部發生的情況,但它並不知道哪些使用者、賬戶或會話對你的應用程式至關重要。使用 Worker 執行時內建的 OpenTelemetry API 來新增這些識別符號,無需安裝其他包:
這些識別符號會隨著每一次發生而顯示。在這個問題中,你現在可以在將問題傳送給AI 助理之前,檢視故障是否集中在某個賬戶或會話中。
將檢測到的問題傳送給你的AI 助理
問題不再需要一直停留在儀表板中,等待某人複製堆疊追蹤並將其貼上到提示詞中。只需配置一次自動化,當問題跨越發生閾值或在平靜期後再次出現時,Issues 就會通過 Automations 直接將它傳送給你的AI 助理。你可以選擇自動化何時執行以及問題應該去往何處。
這可以通過以下方式實現:
- 內建編碼代理: 將 Claude Code 與例程 ID 和令牌連線,Cursor 與自動化 webhook URL 連線,或 Devin 與 API 令牌和組織 ID 連線。
- 通用 Webhook:將問題上下文傳送到您自己的代理或 HTTPS 端點。
- 聊天與事件管理:通過聊天或值班工作流通知您的團隊。
當自動化執行時,Issues 會發送與問題一起捕獲的失敗摘要和診斷上下文——異常、錯誤、源對映堆疊跟蹤、前後日誌和跟蹤、Worker 版本,以及您新增的應用程式上下文。若需更深入調查,您可以單獨將代理連線到 Cloudflare MCP ,讓代理查詢相關日誌和跟蹤,從而提出程式碼和測試更改並開啟拉取請求。
您可以控制哪些內容進入生產環境:審查拉取請求,部署修復,並標記問題已解決。
Issues 如何在一天內發現並解決兩個 Workflows 錯誤
Cloudflare Workflows,一種驅動長時間執行、多步驟應用的原語,完全構建在 Workers 平臺上。
在後臺,其服務跟蹤步驟、重試和已儲存狀態。這使得 Workflows 成為在我們自己的生產系統上測試 Issues 的有用場所。在開啟後的一天內,團隊發現了隱藏在大量流量中的兩個異常問題。
- 遷移卡在重試迴圈中: Workflows 控制平面遷移在嘗試在邊緣案例中應用遷移時反覆遇到 SQLite 外部索引鍵錯誤。Issues 使 Workflows 團隊能夠識別問題並修復。
- 刪除過程從未完成: Workflows 發現,在刪除 Workflow 實例時,存在一個邊緣案例,可能超出 Workers 子請求限制並導致刪除未完成。Issues 幫助 Workflows 團隊識別問題並修復。
與其讓團隊連線數千個獨立的遙測和使用者報告,不如讓他們的自動化設定將這些問題直接傳送到 Cloudflare OS,後者將錯誤追蹤到 Workflows 程式碼併為兩個問題提出修復方案。
開始使用
準備好看看 Issues 在您的應用中發現了什麼嗎?開始使用:
- 在您的
wrangler.jsonc檔案中將observability.issues.enabled設定為true - 在 Cloudflare 儀表盤 設定您的第一個自動化,以將問題傳送到您選擇的目標,無論是代理、Webhook、事件管理工具還是聊天平臺。