跳转到内容
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 密钥

免费计划足以运行提示、发送测试事件和查看第一个仪表板。

相关页面