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

更多模板