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 类型会在五分钟内完成下游工作?
打开查询示例更多模板