开发工具

Telemetry

接收应用的结构化 JSON 事件，用 SQL 查询汇总并生成图表、仪表盘和告警的事件分析平台。

Overview

关于 Telemetry

Telemetry 是一个面向开发者的事件分析与遥测平台：应用通过 HTTP API 或官方 SDK（JavaScript/TypeScript、Python、Rust、Go、Ruby、PHP、Java、.NET）发送结构化 JSON 事件，平台自动识别字段并建表，随后可以直接用 SQL（基于 DataFusion）查询、聚合和对比，把结果保存为图表、仪表盘和阈值告警。底层以 Parquet 列存加 S3 存储，兼顾实时与历史数据。它主打“先埋点、再优化、后验证”的决策闭环，对 AI 应用有专门支持，例如按模型和功能追踪 OpenAI 成本、评估 Agent 质量与可靠性，且默认不存储原始 prompt。需要注册账号获取 API Key，提供免费计划，具体额度与价格以官网最新说明为准。

Features

Telemetry 的核心功能

结构化事件接入：通过 HTTP API 或 JavaScript/TypeScript、Python、Rust、Go、Ruby、PHP、Java、.NET 等 SDK 发送带类型字段的 JSON 事件，平台按事件自动建表（AutoSchema），支持嵌套 JSON 用点号取列，不必预先设计表结构。
直接用 SQL 分析：在浏览器工作台用基于 DataFusion 的 SQL 查询事件表，支持条件聚合、时间分桶、百分位（p50/p95/p99）、窗口函数、漏斗与留存分析，查询结果还可同步导出为 JSON 或 Parquet。
仪表盘与阈值告警：验证过的查询可保存为图表和仪表盘，并对单序列时间图设置阈值告警，明确负责人、时间窗口和响应动作，告警通过邮件投递。
面向 AI 与 Agent 的分析场景：内置追踪 OpenAI API 成本（按模型、功能、团队并与账单核对）、AI Agent 评估（质量、成本、可靠性联合查询）、Agent 安全监控等指南，默认不存储原始 prompt，并可与 OpenTelemetry GenAI traces 关联。

Use cases

Telemetry 适合哪些场景

后端开发者想确认“某个版本是否在不拖慢 p95 的前提下提升了结账完成率”：记录 release、状态、耗时等稳定字段，再用 SQL 按版本对比结果与代价。
任务或队列系统的重试统计去伪存真：同一任务重试三次并不代表完成三项任务，可以记录任务编号、尝试次数和最终状态，用 SQL 去重统计真正完成的任务数。
AI 应用开发者按模型、功能、团队核算 LLM 调用成本与延迟，把质量、成功率和费用放进同一条查询，避免“换了便宜模型但人工转接上升”这类隐性代价。
SRE 或值班人员把错误率、队列深度、网站可用性等已验证查询升级为仪表盘和阈值告警，指标异常时收到邮件通知。

Highlights

Telemetry 的特点

事件进来就是带类型的表，直接写标准 SQL 分析，不用学习厂商专有查询语言。
事件缓冲后以 Parquet 列存落入 S3，查询自动合并实时与历史数据，并支持异步 Parquet 导出。
强调“埋点、查询、改进、再验证”的证据闭环，可按 release、prompt 版本或模型对比结果，事件契约与 SQL 对人可审计。
对 AI 应用有现成方法论：成本追踪、Agent 评估、安全监控均提供生产级事件结构和 SQL 示例。

Guide

Telemetry 使用指南

如何设计第一个事件 schema

先想清楚要回答的决策（如完成率、错误率），以“一个完成的工作单元”为粒度设计宽事件，字段保持稳定类型并优先使用 snake_case 命名。高基数字段（用户 ID、请求 ID）和分区列要有意选择，避免基数失控拖慢查询。

埋点上线前需要检查什么

按官方生产清单确认事件归属人、schema 稳定性、敏感数据边界、凭据存放方式、发送失败与重试行为、采样策略、数据保留周期，以及下游依赖的查询、仪表盘和告警，再推广到生产环境。

FAQ

Telemetry 常见问题

Telemetry 是监控系统吗，和传统 APM 有什么区别

它更接近“事件分析平台”：需要开发者自己定义事件字段并主动埋点，再用 SQL 回答业务和可靠性问题，而不是接入后自动发现所有问题的 APM。它可以与 OpenTelemetry 的 traces、metrics、logs 并存，通过关联 ID 互相打通。

Telemetry 怎么开始使用，需要付费吗

注册账号后创建限定作用域（写入或查询）的 API Key，按快速入门发送第一个事件、在 SQL 工作台验证后即可扩展埋点。平台提供免费计划，存储量、查询时长等额度以及具体价格以官网最新说明为准。

使用 Telemetry 会不会把敏感数据和用户原始内容传上去

官方建议只发送有边界的结构化字段，默认不存储原始 prompt，并提供敏感数据脱敏（allowlist）、API Key 权限管理和数据保留与删除文档。生产接入前应按官方生产检查清单完成隐私评审。

访问提示

第三方网站的功能、价格和可用性可能发生变化。请在访问时查看其最新条款，并谨慎处理个人或敏感信息。