跳转到内容
Telemetry
数据质量 SQL查询示例

按事件名称测量 Telemetry 音量

在更改保留或收集策略之前,按有效负载字节、平均事件大小和拒绝率对事件类型进行排名。

入门telemetry_ingestion_events已审核 2026-07-28测试用 阿帕奇 DataFusion 45.2.0

审阅者 Telemetry产品团队 . SQL 兼容性、事件契约、合成输出和操作注意事项. 审查标准和所有权

问题已回答

哪些事件合约创造了最大的摄取量?

仅事件计数就可以隐藏过大的有效负载。此查询将计数和字节量保持在一起,使嘈杂或意外大的事件合同可见,而无需假装有效负载字节等于供应商账单。

活动合约

查询期望的字段

字段类型为什么存在
timestamp_utcTimestampUTC 中的摄取尝试时间。
event_nameUtf8受控事件名称。
sourceUtf8有限的生产者或 SDK 源。
payload_bytesInt64传输压缩之前的序列化事件大小。
acceptedBoolean摄取是否接受该事件。
environmentUtf8部署环境。
DataFusion SQL

复制查询

sql
SELECT
  event_name,
  source,
  COUNT(*) AS events,
  SUM(payload_bytes) AS total_payload_bytes,
  AVG(payload_bytes) AS avg_payload_bytes,
  SUM(CASE WHEN accepted THEN 0 ELSE 1 END) AS rejected_events,
  100.0 * SUM(CASE WHEN accepted THEN 0 ELSE 1 END)
    / NULLIF(COUNT(*), 0) AS rejection_rate_pct
FROM telemetry_ingestion_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY event_name, source
ORDER BY total_payload_bytes DESC, event_name;

此只读查询是针对空类型表计划和执行的 阿帕奇 DataFusion 45.2.0。确定性样本输出是综合的并单独审查;根据您自己的数据验证字段类型、阈值和业务定义。 阅读测试方法。

查询结果

按事件合约划分的有效负载量

尽管事件少于页面视图,但综合调试跟踪具有最大的字节量。

event_namesourceeventstotal_payload_bytesavg_payload_bytesrejected_eventsrejection_rate_pct
debug_traceworker416,0004,000125
llm_request_completedapi36,0002,00000
page_viewedweb63,000500116.67

综合示例输出。在将其用于操作决策之前,针对您自己的事件架构和阈值运行查询。

Payload volume by event contract:来自 Measure Telemetry Volume by Event Name 示例结果的合成 total_payload_bytes 值的静态图表
确定性示例输出的可索引 SVG。下载它以获取带有归属的文章、操作手册或设计评论。

重现示例

下载公共装置

JSON 包包含类型化事件契约, reproducible 输入行、确切的 SQL、预期输出、审阅注释和引擎版本。 CSV 包含显示的结果。

SQL 是如何工作的

  1. 1总字节数和平均字节数可区分高频事件和超大合约。
  2. 2当多个生产者可以发出相同的事件名称时,源保持所有权可见。
  3. 3拒绝率将收集更改转变为数据质量审查,而不是仅花费成本的活动。

需要决定的边缘情况

  • 序列化有效负载大小不是存储大小、扫描字节、网络出口或发票成本。
  • 单独测量维度基数;一个小事件仍然可以创建昂贵或无法使用的组。
  • 在更改生产保留之前排除合成和开发流量。

推荐仪表板

  • 酒吧:total_payload_bytes by event_name
  • 趋势:按源划分的事件计数和字节数
  • 表:平均大小、拒绝率、保留所有者和架构版本

警报指导

就相对于审查基准的持续合约规模或交易量变化发出警报,而不是针对固定的全局字节阈值。

读取警报设置

让查询示例发挥作用

相关埋点和指南

继续分析

在真实事件中运行它

创建表,调整字段并保存结果

免费开始,发送结构化事件,并将查询结果用作图表、共享仪表板小部件或警报输入。

获取 API 密钥