跳转到内容
Telemetry
Telemetry SQL 手册

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

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

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

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

81

完整的 SQL 查询示例

12

运营和产品类别

1:1

查询到结果的可视化

交互式 SQL 实验室

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

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

启动 SQL 实验室

可重现的 SQL

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

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

菜谱合集

API 可靠性

12 recipes
入门api_requests

按路由计算API错误率

使用 SQL 按 5xx 错误率对 API 路由进行排名,同时保护结果免受低音量噪音的影响。

查看 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

菜谱合集

产品分析

9 recipes
中级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 和结果

菜谱合集

结构化事件

4 recipes

菜谱合集

数据质量

6 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 密钥