跳转到内容
Telemetry
复制粘贴仪表模板

事件跟踪计划模板

创建可审查的事件目录,涵盖粒度、所有权、字段、隐私、保留、验证和下游 SQL 依赖项。

审阅者 Telemetry产品团队 . 事件名称、推荐字段、分析问题和隐私边界. 审查标准和所有权

由此解锁的问题
  • 一行代表什么,它支持哪一个决定?
  • 哪些字段是必填字段、敏感字段、受限字段或禁止字段?
  • 哪些查询、仪表板、警报和所有者依赖于该合同?
模板证据路径

Event Tracking Plan Template:实施到决策

将提示视为实施概要。有用的工件不仅仅是复制的代码,而是经过审查的事件契约,可以产生值得信赖的答案。

  1. 1

    选择边界

    Instrument the point where tracking_plan_reviewed becomes final.

  2. 2

    创建合同

    Start with tracking_plan_reviewed, event_contract_changed, instrumentation_verified and keep every field typed, bounded, and privacy-reviewed.

  3. 3

    运行夹具

    在依赖汇总结果之前,先练习已知的成功、失败、重试和空结果案例。

  4. 4

    回答问题

    一行代表什么,它支持哪一个决定?

模板

将其粘贴到您的编码代理中

更换 YOUR_API_KEY,在本地运行流程,然后验证生成的事件和仪表板。

event-tracking-plan

事件跟踪计划模板

text
在添加 Telemetry 之前,为此代码库创建事件跟踪计划。

使用 /skill.md 并检查生产工作流程、现有分析调用、测试、部署配置、隐私控制和下游报告。

对于每个提议的活动,记录:
event_name、事件粒度、业务或运营 decision、owner、精确触发器、必填字段、可选字段、类型和单位、受控值、禁止内容、隐私分类、保留期望、schema_version、下游 SQL 或仪表板以及综合验证案例。

识别不明确的重试、重复交付、原始 URL、无限制的字符串、个人数据、秘密以及真实来源不明的字段。在这些边界得到解决之前,不要添加仪器。

然后实施最小的批准事件集,添加合同和故障路径测试,验证非生产环境中的摄取,并创建除了速率之外还计数的 SQL。

将跟踪计划作为提交的 Markdown 文档返回,并总结仍需要的任何审核决策。不要发明同意、保留、安全或合规政策。

要捕获的事件

tracking_plan_reviewedevent_contract_changedinstrumentation_verifiedschema_drift_detectedevent_contract_retired

验证清单

完整的埋点通行证留下了什么

活动

综合事件以稳定的名称和字段类型到达预期的表。

查询

第一个 SQL 查询返回具有明确时间窗口的合理行。

意见

仪表板使用真实字段并包含足够的上下文来解释更改。

安全

检查提示、正文、凭据、签名和私人内容是否经过编辑。

事件架构起点

在将查询或代码片段适应生产之前,请检查行粒度、发出边界、所需类型、隐私类、示例有效负载和验证清单。

相关产品功能

继续此工作流程 结构化事件

捕获稳定的事件名称、键入的字段和经过隐私审查的操作上下文。

相关 SQL 查询示例

用 SQL 回答下一个问题

针对此工作流程中的结构化字段运行查询,检查示例结果,并将有用的答案转换为仪表板或警报。

浏览所有查询示例
完整系列数据质量 SQL

更多模板