Event Tracking Plan Template:实施到决策
将提示视为实施概要。有用的工件不仅仅是复制的代码,而是经过审查的事件契约,可以产生值得信赖的答案。
- 1
选择边界
Instrument the point where tracking_plan_reviewed becomes final.
- 2
创建合同
Start with tracking_plan_reviewed, event_contract_changed, instrumentation_verified and keep every field typed, bounded, and privacy-reviewed.
- 3
运行夹具
在依赖汇总结果之前,先练习已知的成功、失败、重试和空结果案例。
- 4
回答问题
一行代表什么,它支持哪一个决定?
模板
将其粘贴到您的编码代理中
更换 YOUR_API_KEY,在本地运行流程,然后验证生成的事件和仪表板。
事件跟踪计划模板
在添加 Telemetry 之前,为此代码库创建事件跟踪计划。
使用 /skill.md 并检查生产工作流程、现有分析调用、测试、部署配置、隐私控制和下游报告。
对于每个提议的活动,记录:
event_name、事件粒度、业务或运营 decision、owner、精确触发器、必填字段、可选字段、类型和单位、受控值、禁止内容、隐私分类、保留期望、schema_version、下游 SQL 或仪表板以及综合验证案例。
识别不明确的重试、重复交付、原始 URL、无限制的字符串、个人数据、秘密以及真实来源不明的字段。在这些边界得到解决之前,不要添加仪器。
然后实施最小的批准事件集,添加合同和故障路径测试,验证非生产环境中的摄取,并创建除了速率之外还计数的 SQL。
将跟踪计划作为提交的 Markdown 文档返回,并总结仍需要的任何审核决策。不要发明同意、保留、安全或合规政策。要捕获的事件
验证清单
完整的埋点通行证留下了什么
活动
综合事件以稳定的名称和字段类型到达预期的表。
查询
第一个 SQL 查询返回具有明确时间窗口的合理行。
意见
仪表板使用真实字段并包含足够的上下文来解释更改。
安全
检查提示、正文、凭据、签名和私人内容是否经过编辑。
事件架构起点
此工作流程的事件契约
在将查询或代码片段适应生产之前,请检查行粒度、发出边界、所需类型、隐私类、示例有效负载和验证清单。
相关产品功能
继续此工作流程 结构化事件
捕获稳定的事件名称、键入的字段和经过隐私审查的操作上下文。
相关 SQL 查询示例
用 SQL 回答下一个问题
针对此工作流程中的结构化字段运行查询,检查示例结果,并将有用的答案转换为仪表板或警报。
跟踪事件架构版本采用情况
哪些生产者仍然发布关键事件的旧版本?
打开查询示例测量必填字段空率
哪些事件名称的帐户标识符丢失率不可接受?
打开查询示例查找重复的事件 ID
哪些事件 ID 被多次接收?
打开查询示例测量事件摄取新鲜度
哪些生产事件源现在已过时或已延迟?
打开查询示例测量迟到事件
哪些事件生产者提供数据的时间足够晚以至于扭曲了分析?
打开查询示例按事件名称测量 Telemetry 音量
哪些事件合约创造了最大的摄取量?
打开查询示例更多模板