保存的查询、历史记录、收藏夹和协作
保存的查询将调查转变为可重用的团队工件。 Telemetry 在团队工作空间内组织查询，保留查询历史记录，并让每个人收藏他们最常返回的查询。
保存 SQL 不会使度量正确。在其他人或自动化工作流程依赖事件粒度、过滤器、分母、单位和时间边界之前对其进行检查。
选择一个工作空间
使用工作区按服务、产品领域、操作工作流程或团队对相关分析进行分组。工作区可以嵌套，这样可以让一个广阔的区域包含更集中的集合，而无需将每个查询强制放入一个平面列表中。
保持结构足够浅以便扫描。一个实际的安排可能是：
reliability
api
background-jobs
product
activation
retention
ai
model-cost
agent-quality
团队成员资格控制谁可以看到工作区和保存的查询。工作空间名称（例如“个人”）描述了组织或所有权；它不会使该工作空间成为私有的。每个团队成员都可以访问团队的工作区分析，因此当查询包含针对较小受众的标识符或操作详细信息时，请使用单独的团队。
保存并命名查询
从草稿开始，针对代表性时间范围运行查询，然后检查结果。当准备好保留时：
- 将其保存在拥有该决策的工作区中。
- 如果有用的话，用结果、范围和单位重命名它。
- 除了比率和百分位数之外，还应保留数量。
- 仅在审核保存的版本后才将结果添加到仪表板。
优先选择 API error rate by route — production 而不是 query 14 或 incident query。名称应该帮助人们找到并解释查询，而无需打开每个结果。
了解查询历史记录
保存更改会创建查询历史记录。使用历史记录条目可以回顾 SQL 的演变过程，并在编辑意外更改结果时恢复之前的逻辑。
在对共享查询进行重大更改之前：
- 注意新旧指标定义；
- 在同一固定窗口上比较两个版本；
- 识别使用查询的仪表板、告警或报告；
- 保留以前的版本，直到消费者审查更改；
- 当含义发生变化时更新说明性仪表板文本。
当查询支持受监管的报告、访问决策或精确的财务对账时，历史记录并不能替代更广泛的审计跟踪或代码审查流程。
使用收藏夹作为个人快捷方式
最喜欢的是个人导航辅助工具。收藏查询不会更改其工作空间、权限、SQL 或其他团队成员的状态。使用收藏夹来查看活动事件视图、每周回顾或重复出现的产品问题，而无需重复共享查询。
促进稳定结果
保存的查询可以变成：
- 仪表板图表或结果表；
- 具有明确阈值和所有者的告警；
- 可重复导出；
- 更深入调查的起点。
将保存的查询保留为可检查的分析定义。将响应说明和所有权放在仪表板或告警旁边，以便在移交过程中工件仍然易于理解。
协作清单
在广泛共享已保存的查询之前，请确认：
- 每个团队成员都是工作区和查询的目标受众。
- 标题描述了结果和单位。
- SQL 使用记录字段和计数规则。
- 已检查代表性固定装置或已知间隔。
- 广泛的仪表板中省略了敏感的原始标识符。
- 重大变化与之前的历史条目进行比较。
- 每个告警都有一个所有者、评估窗口和响应操作。