无需从 SQL 开始即可探索结构化事件
使用 Explore 查看行、分组事件或根据单张表绘制图表。在界面中选择筛选条件和聚合方式,然后运行查询。可以用结果检查新添加的埋点,或创建仪表板或告警。
生成的 SQL 仍然可见。将控件视为查询生成器,而不是单独的分析语言:检查结果、查看生成的查询,并在问题需要联接、多个公用表表达式或可重用指标定义时移至查询工作区。
操作流程示意图:运行查询、检查结果,然后保存到仪表板或配置告警。
通过带有仪表板名称的保存按钮或 保存此结果 保存已检查的结果。没有仪表板时使用 创建入门仪表板并保存;有多个目标时会显示 选择仪表板。符合要求的单序列时间图表可通过 监测结果 或 监控这个结果 打开告警设置。
从示例事件开始
在添加聚合之前,选择一个事件表并检查最近的行。确认:
- 该表代表一个明确的工作单元,例如已完成的请求或代理运行;
- 时间戳使用预期的发生时间和时区;
- 数字字段是数字而不是看起来像数字的字符串;
- 类别字段使用稳定的有界值;
- 路由、发布、租户和相关字段按预期填充;
- 敏感值不存在或根据您的隐私政策进行转换。
图表可以隐藏空值、混合单位、重复传递和意外稀疏的字段。样本会在这些问题成为误导性的比率或百分位数之前将其暴露出来。
建立有针对性的结果
Explore 支持示例和表格结果以及折线图、条形图和堆积面积图。选择能够回答问题的最小视图。
- 选择表和时间范围。
- 添加稳定字段(例如
environment、service、outcome)或路由模板的过滤器。 - 选择
count、sum、average、min、max或百分位数聚合。 - 当聚合需要数字字段时,选择数字字段。
- 仅按有助于解释结果的有界维度拆分系列。
- 检查生成的 SQL 和返回的行数。
当嵌套结构化字段出现在表架构中时,可以对其进行过滤。优先选择显式列和路由模板,而不是原始 URL 或任意对象内容。
示例问题
| 问题 | 建议的控制措施 |
|---|---|
| API发布后故障是否增加? | 按时间对事件进行计数,过滤失败的结果,按版本拆分 |
| 哪个作业队列重试最频繁? | 计算事件数,过滤大于 1 的尝试,按队列拆分 |
| 一项功能的模型成本是否会上升? | 按时间求和估计成本,按有界功能名称分割 |
| 浏览器性能有变化吗? | 选择 Web Vital 的百分位数,按指标过滤,按版本拆分 |
将成交量放在比率和百分位数旁边。基于三个事件的看似严重的变化不应被解释为基于三百万个事件的相同变化。
查看生成的SQL
在保存结果之前,检查生成的查询:
- 过滤预期的时间场和环境;
- 使用正确的分母来计算比率;
- 故意处理空值;
- 与决策具有相同粒度的分组;
- 不被高基数标识符分割;
- 排除不完整的最新时间段,因为这会扭曲比较。
当您需要对交付进行重复数据删除、连接表、连接前预聚合、比较多个群组或在 SQL 中记录指标时,请在查询中打开结果。 Explore 有意以单表调查为中心。
推广结果
当团队成员重复需要相同的答案时,将经过审核的探索结果添加到仪表板。为小部件指定一个面向决策的名称,保留相关的时间范围和过滤器,并将成交量视图放置在任何百分比或百分位附近。
仅在检查几个代表性窗口后才创建告警。定义所有者、阈值、评估窗口和响应操作。由稀疏或不完整的最新数据构建的阈值会产生噪音。
验证清单
- 发送具有已知字段值的合成事件。
- 在示例视图中找到确切的事件。
- 添加一个包含它的过滤器,然后添加一个排除它的过滤器。
- 将计数或总和与手动已知的固定装置进行比较。
- 查看生成的 SQL。
- 保存结果并从目标仪表板或告警流中重新打开它。
- 确认另一位目标团队成员可以解释标题、过滤器、单位和响应操作。
继续使用 编写第一个 Telemetry SQL 查询、创建仪表板 或 告警。