跳至主要內容
Telemetry
事件追蹤範本

Webhook 除錯範本

追蹤關鍵 Webhook 的交付、處理、重試、提供程式狀態、冪等性和下游影響。

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

由此解鎖的問題
  • 哪些提供商事件最常失敗?
  • 重試是修復失敗還是建立重複項?
  • 每種 Webhook 型別會觸發哪些下游作業?
範本證據路徑

Webhook debugging template:實施到決策

將提示視為實施概要。有用的工件不僅僅是複製的程式碼,而是經過審查的事件契約,可以產生值得信賴的答案。

  1. 1

    設定邊界

    Instrument the point where webhook_received becomes final.

  2. 2

    建立合約

    Start with webhook_received, webhook_processed, webhook_failed and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    執行夾具

    在依賴彙總結果之前,先練習已知的成功、失敗、重試和空結果案例。

  4. 4

    回答問題

    哪些提供商事件最常失敗?

範本與用例

使用此範本加入事件

當測量目標已經明確時,複製此範本。使用匹配的用例指南來檢視事件邊界、成功定義以及生成的 SQL 應支援的決策。

讀取 Webhook 除錯

範本

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

更換 YOUR_API_KEY,在本地執行流程,然後驗證生成的事件和儀表板。

webhook-debugging

Webhook 除錯範本

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。

按 provider 建立卷查詢、按 event_type 查詢失敗、重試率、重複率、p95 處理時間和最新失敗的 Webhook。

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

要捕獲的事件

webhook_receivedwebhook_processedwebhook_failedwebhook_retriedwebhook_deduplicated

驗證清單

完整的埋點通行證留下了什麼

活動

綜合事件以穩定的名稱和欄位型別到達預期的資料表。

查詢

第一個 SQL 查詢返回具有明確時間視窗的合理行。

意見

儀表板使用真實欄位幷包含足夠的上下文來解釋更改。

安全

檢查提示、正文、憑據、簽名和私人內容是否經過編輯。

事件結構描述範例

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

相關產品功能

繼續此工作流程 警示

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

相關 SQL 查詢範例

更多 SQL 範例

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

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

更多範本