跳转到内容
Telemetry SQL 手册

SQL日志分析和可观测性秘诀

将日志分析为类型化、结构化的事件表。从问题开始,然后提出查询和图表。每个查询示例都将现实模式与可复制的 DataFusion SQL、合成结果数据、有用的可视化、公共 JSON 和 CSV 装置、解释注释、边缘案例以及仪表板或警报建议配对。

对这种方法不熟悉吗?阅读 SQL 可观测性和事件分析指南 了解查询示例背后的事件模型、架构、查询模式和迁移权衡。

Planned and executed with Apache DataFusion 45.2.0
具有视觉预览的可抓取结果表
可下载的 JSON、CSV 和静态 SVG 资源
可联接的 SaaS 表
用于可复制装置的只读浏览器游乐场
操作边缘情况和警报指导
综合示例。无客户数据

84

完整的 SQL 查询示例

12

运营和产品类别

1:1

查询结果图表

交互式 SQL 实验室

跨产品、API、AI、职位、计费和数据库关注一个帐户

查询示例页面一次解释一种分析模式。 SQL 实验室添加了版本化的 15 个表数据集和针对实际连接、激活漏斗、LLM 单元经济学、事件影响、重试恢复和数据库可靠性的指导课程。

启动 SQL 实验室

可重现的 SQL

语法检查是自动化的;解释保持明确

每个发布的查询必须是只读的,包括类型化的事件契约,并成功地计划和执行 阿帕奇 DataFusion 45.2.0。综合结果、业务定义和边缘情况要单独审查,因为有效的 SQL 仍然可能回答错误的问题。

菜谱合集

产品分析

10 recipes
入门prototype_events

统计学生原型中记录到的各步骤

对八次虚构尝试产生的 18 条事件记录运行 SQL。分别统计每个步骤中不同的尝试,不要把缺少事件误当作用户放弃的证据。

查看 SQL 和结果
中级product_events

使用 SQL 构建注册到激活渠道

通过注册、入职、集成和第一价值里程碑计算唯一用户转化。

查看 SQL 和结果
高级product_events

计算每周群组保留率

按第一个活动周对用户进行分组,并衡量随后几周的返回百分比。

查看 SQL 和结果
高级product_events

查找升级前使用的功能

加入功能事件以升级事件并对付费转化之前发生的行为进行排名。

查看 SQL 和结果
高级product_events

计算 DAU、WAU 和产品粘性

一起衡量每日和每周的活跃用户,并根据一致的活动定义计算 DAU 到 WAU 的粘性。

查看 SQL 和结果
中级product_events

按获取来源比较渠道转化

按获取来源衡量注册到激活的转化,同时消除重复的里程碑事件。

查看 SQL 和结果
高级product_events

测量激活时间

计算用户注册和执行第一个有意义的产品操作之间经过的时间分布。

查看 SQL 和结果
高级product_events

按群组衡量流失和重新激活

将帐户分类为保留帐户、流失帐户或因重复的有意义的产品活动而重新激活的帐户。

查看 SQL 和结果
高级experiment_events

比较实验转化和收入提升

通过实验变量衡量转化率、每个参与者的收入以及相对提升,而无需重复计算重复事件。

查看 SQL 和结果
中级product_journey_events

按会话衡量产品旅程下降情况

衡量有多少会话达到每个订购产品的里程碑,并计算旅程完成度和逐步转化率。

查看 SQL 和结果

菜谱合集

数据质量

8 recipes

菜谱合集

API 可靠性

12 recipes
入门api_requests

按路由计算API错误率

按 5xx 错误率对 API 路由排序。排除请求少于 20 次的路由,避免单次失败主导结果。

查看 SQL 和结果
中级api_requests

计算 p50、p95 和 p99 API 延迟

使用 DataFusion 兼容的百分位数 SQL 按端点比较中值和尾部延迟。

查看 SQL 和结果
中级api_requests

计算 API 错误预算消耗率

将每小时的请求失败转化为 SLO 消耗率系列,显示允许的错误预算消耗的速度。

查看 SQL 和结果
中级api_requests

按版本比较 API 可靠性

比较跨应用程序版本的流量、5xx 速率和 p95 延迟,无需将每个部署后更改都归因于部署。

查看 SQL 和结果
入门api_requests

按客户影响对错误指纹进行排名

按发生次数和受影响的帐户对标准化应用程序错误进行排名,而不是让一个重试循环主导事件视图。

查看 SQL 和结果
入门api_requests

按路由计算API超时率

按超时率对路由进行排名,同时保留请求量和配置的超时边界。

查看 SQL 和结果
中级dependency_calls

比较依赖性 p95 延迟

查找对请求造成最大尾部延迟的数据库、API、缓存和队列。

查看 SQL 和结果
中级api_requests

根据 SLO 衡量 API 可用性

计算每日可用性并显示服务是否达到其明确的目标。

查看 SQL 和结果
入门api_throughput_events

按路由计算 API 请求吞吐量

通过稳定的 API 路由计算观察到的每分钟请求数,并在吞吐量旁边保留错误量。

查看 SQL 和结果
中级api_attempt_events

测量 API 429 速率限制恢复

测量速率限制请求在稍后尝试中恢复的频率,而不将每次重试都视为新请求。

查看 SQL 和结果
入门feature_rollout_events

比较功能推出错误率

比较一个版本的功能标记部署和控制组之间的请求错误和平均延迟。

查看 SQL 和结果
中级incident_account_impact_events

按计划衡量事件对客户的影响

按计划计算受影响的帐户和平均影响持续时间,而无需暴露客户名称或原始请求数据。

查看 SQL 和结果

菜谱合集

后台任务

6 recipes

菜谱合集

网络钩子

3 recipes

菜谱合集

人工智能和法学硕士

8 recipes

菜谱合集

结构化事件

4 recipes

菜谱合集

收入和账单

5 recipes

菜谱合集

基础设施

4 recipes

菜谱合集

安全和审计

7 recipes

菜谱合集

数据库可靠性

12 recipes
入门database_query_events

通过指纹查找缓慢的数据库查询

按慢查询率、平均持续时间和最差观察持续时间对规范化数据库操作进行排名,无需存储原始 SQL 或参数。

查看 SQL 和结果
入门database_pool_samples

测量数据库连接池饱和度

按应用程序服务测量平均池利用率、排队获取等待、超时和空闲容量。

查看 SQL 和结果
中级database_transaction_events

计算数据库事务回滚率

按服务比较已提交和回滚的事务,同时保留错误类别、持续时间和受影响的帐户。

查看 SQL 和结果
中级database_lock_wait_events

查找数据库锁等待和死锁

按事件计数、等待持续时间、未解决的锁定和检测到的死锁对阻塞的数据库操作指纹进行排名。

查看 SQL 和结果
入门database_replication_samples

测量数据库复制和 CDC 延迟

通过平均延迟、最差延迟、落后字节数和过时采样率来比较副本和更改数据捕获消费者。

查看 SQL 和结果
入门database_migration_events

按版本跟踪数据库迁移失败

在完成部署之前,按应用程序版本比较数据库迁移的成功、失败、回滚和持续时间。

查看 SQL 和结果
中级database_request_query_events

检测 N+1 数据库查询模式

检测在一个应用程序请求内多次重复的数据库指纹。

查看 SQL 和结果
入门database_query_events

按总时间影响对数据库查询进行排名

结合调用量和延迟来查找消耗最多应用程序时间的数据库指纹。

查看 SQL 和结果
中级database_transaction_events

测量长时间运行的数据库事务

查找具有长尾、回滚和开放持续时间过长的应用程序事务类。

查看 SQL 和结果
入门database_error_events

通过 SQLSTATE 和版本分析数据库错误

按可移植 SQLSTATE 类、应用程序操作和发布对数据库故障进行分组。

查看 SQL 和结果
中级database_connection_events

测量数据库连接超时和改动

按服务和区域比较连接打开、关闭、获取超时以及受影响的请求。

查看 SQL 和结果
高级database_replica_read_events

按区域测量数据库副本的陈旧程度

按区域比较应用程序观察到的副本重播延迟、陈旧读取和故障转移结果。

查看 SQL 和结果

菜谱合集

前端可靠性

5 recipes

使用您自己的事件

将查询示例改用于自己的表

Telemetry 从结构化事件创建表。一旦字段流动,调整查询示例,保存结果,并将其转变为共享仪表板或警报。

获取 API 密钥