Webhook debugging template:實施到決策
將提示視為實施概要。有用的工件不僅僅是複製的程式碼,而是經過審查的事件契約,可以產生值得信賴的答案。
- 1
設定邊界
Instrument the point where webhook_received becomes final.
- 2
建立合約
Start with webhook_received, webhook_processed, webhook_failed and keep every field typed, bounded, and privacy-reviewed.
- 3
執行夾具
在依賴彙總結果之前,先練習已知的成功、失敗、重試和空結果案例。
- 4
回答問題
哪些提供商事件最常失敗?
範本與用例
使用此範本加入事件
當測量目標已經明確時,複製此範本。使用匹配的用例指南來檢視事件邊界、成功定義以及生成的 SQL 應支援的決策。
範本
將其貼上到您的編碼代理中
更換 YOUR_API_KEY,在本地執行流程,然後驗證生成的事件和儀表板。
Webhook 除錯範本
使用 Telemetry 處理儀器 Webhook。
使用 /skill.md 和此 Telemetry API 金鑰:YOUR_API_KEY
記錄 webhook_received、webhook_processed、webhook_failed、webhook_retried 和 webhook_deduplicated:
provider、event_type、route_template、status、status_code、latency_ms、attempt、idempotency_outcome、downstream_job_count、team_id 和 error_type。
按 provider 建立卷查詢、按 event_type 查詢失敗、重試率、重複率、p95 處理時間和最新失敗的 Webhook。
請勿記錄原始 Webhook 正文、簽名、機密、付款詳細資訊或個人資料。要捕獲的事件
驗證清單
完整的埋點通行證留下了什麼
活動
綜合事件以穩定的名稱和欄位型別到達預期的資料表。
查詢
第一個 SQL 查詢返回具有明確時間視窗的合理行。
意見
儀表板使用真實欄位幷包含足夠的上下文來解釋更改。
安全
檢查提示、正文、憑據、簽名和私人內容是否經過編輯。
事件結構描述範例
此工作流程的事件結構描述
在將查詢或程式碼片段適應生產之前,請檢查行粒度、發出邊界、所需型別、隱私類、範例有效負載和驗證清單。
相關產品功能
繼續此工作流程 警示
將經過審查的可靠性查詢提升到擁有的閾值和回應工作流程中。
相關 SQL 查詢範例
更多 SQL 範例
針對此工作流程中的結構化欄位執行查詢,檢查範例結果,並將有用的答案轉換為儀表板或警示。
測量 Webhook 重試恢復
Webhook 重試是恢復失敗還是創造更多工作?
開啟查詢範例測量 Webhook 延遲和重複率
哪些 Webhook 源速度慢、重複或不可靠?
開啟查詢範例衡量 Webhook 端到端完成情況
哪些 Webhook 型別會在五分鐘內完成下游工作?
開啟查詢範例更多範本