跳至主要內容
Telemetry
對於依賴 Stripe、GitHub、客戶或提供商 Webhook 的團隊

Webhook 除錯

追蹤 Webhook 交付、處理、重試、重複資料刪除、下游作業和故障,而無需儲存原始負載。

審閱者 Telemetry產品團隊 . 我們檢查了事件欄位、建議查詢和要排除的資料. 誰負責審查此頁面

為什麼這有效
  • 按提供程式、事件型別、端點和下游作業檢視失敗。
  • 測量真實 Webhook 處理事件的重試率和重複率。
  • 建立有助於除錯收入和整合問題的稽核追蹤。
用例證據路徑

Webhook debugging:從實施到決策

完整的 webhook debugging 測量迴圈連線一個擁有的工作流程、一個有界事件契約、一個受控裝置和一個有人可以採取行動的問題。

  1. 1

    設定邊界

    記錄 webhook_received、webhook_processed、webhook_failed 和 webhook_retried。

  2. 2

    捕捉結果

    Begin with webhook_received, webhook_processed, webhook_failed and document the grain of each event.

  3. 3

    證明行數

    針對重複失敗、重試峰值和處理延遲建立警示。

  4. 4

    做出決定

    哪些 Webhook 事件型別最常失敗?

用例與範本

選擇要衡量的內容

使用用例指南來選擇結果、事件邊界和分析問題。當您準備好接受較短的複製貼上實施簡介時,請開啟匹配的範本。

開啟 Webhook 除錯範本

代理提示

將其貼上到您的編碼代理中

更換 YOUR_API_KEY 註冊後,然後要求代理執行產品流程並驗證第一個事件。

代理提示

Webhook debugging 設定提示

text
使用 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。

按提供商建立卷、按事件型別失敗、重試率、重複率、p95 處理時間和最新失敗的 webhook 的查詢。

請勿記錄原始 Webhook 正文、簽名、機密、付款詳細資訊或個人資料。

設定步驟

  1. 1記錄 webhook_received、webhook_processed、webhook_failed 和 webhook_retried。
  2. 2捕獲提供者、事件型別、狀態、延遲、嘗試和冪等性結果。
  3. 3連線每個 Webhook 觸發的下游作業或計費同步。
  4. 4針對重複失敗、重試峰值和處理延遲建立警示。

要捕獲的事件

webhook_receivedwebhook_processedwebhook_failedwebhook_retriedwebhook_deduplicatedbilling_sync_failed

由此解鎖的問題

  • 哪些 Webhook 事件型別最常失敗?
  • 重試是修復失敗還是建立重複項?
  • 哪些下游系統受到提供商延遲的影響?

事件結構描述範例

在將查詢或程式碼片段適應生產之前,請檢查行粒度、發出邊界、所需型別、隱私類、範例有效負載和驗證清單。

相關產品功能

繼續此工作流程 警示

將經過審查的可靠性查詢提升到擁有的閾值和回應工作流程中。

相關 SQL 查詢範例

更多 SQL 範例

針對此工作流程中的結構化欄位執行查詢,檢查範例結果,並將有用的答案轉換為儀表板或警示。

瀏覽所有查詢範例
查詢範例集網路鉤子 SQL

客戶案例

相關客戶案例

下一步

建立您的代理將使用的 API 金鑰

免費計劃足以執行提示、傳送測試事件和檢視第一個儀表板。

相關頁面