跳转到内容
Telemetry
Telemetry 文档

发送第一个事件,创建第一个仪表盘。

从第一次事件到生产环境插桩、SDK、API、结构化事件设计、DataFusion SQL、仪表板、告警和故障排除,了解 Telemetry。

审阅者 Telemetry产品团队 . 我们检查了主题、导航、来源和在生产环境中使用 Telemetry 的指导. 谁负责审核此页面

98

篇文档

5

个学习模块

供人阅读的 HTML,供智能体使用的 Markdown

在网站上阅读文章,或将原始 Markdown 版本交给你的编程代理。

按目标选择

从需要做出的决策或实现的功能开始

监控 AI 和代理工作流程

连接模型使用情况、成本、延迟、工具、检索质量和审查的产品结果,默认情况下不存储原始提示。

排查缺失的事件或结果

在更改仪器之前,将摄取、架构、查询、告警和下游交付故障分开。

开始使用

创建密钥,发送并验证第一个事件,写入 SQL,并完成初始生产检查表。

快速入门

发送结构化事件,检查其表,使用 SQL 查询,并将结果转换为仪表板或告警。

阅读文档

发送您的第一个结构化事件

创建写入范围的 API 密钥,发送一个合成结构化事件,并选择在生产中仍然有用的事件名称和字段。

阅读文档

验证事件摄取和架构

在扩展检测之前,请确认测试事件已达到具有预期类型、时间戳、标识符和隐私边界的预期表。

阅读文档

编写第一个 Telemetry SQL 查询

查询经过验证的结构化事件表,计算数量和错误率,检查原始行,并根据已知的合成装置验证结果。

阅读文档

创建您的第一个仪表板和告警

将经过验证的查询提升到重点仪表板小部件和具有明确所有者、时间窗口和响应操作的阈值告警中。

阅读文档

生产环境插桩检查清单

在生产部署之前检查事件所有权、架构稳定性、敏感数据边界、凭据、故障行为、保留、查询、仪表板和告警。

阅读文档

API 密钥与身份验证

创建、确定范围、存储、轮换和撤销 Telemetry API 密钥,而不会向不受信任的客户端公开摄取或查询访问权限。

阅读文档

团队、工作区、成员和角色

将分析组织到团队工作区、邀请成员、了解管理员和成员角色,并在共享数据之前检查访问权限。

阅读文档

用量、账单与套餐限制

查看存储和查询持续时间的使用情况,了解免费计划的实施,比较当前的定价,并安全地计划升级。

阅读文档

概念与 SQL 模式

设计稳定的事件契约、控制模式和基数,并使用可重用的 DataFusion SQL 模式。

Telemetry 架构

了解 Telemetry 如何验证和缓冲事件、在 S3 中存储 Parquet 以及组合 SQL 查询的最新数据和历史数据。

阅读文档

创建仪表板

从 Explore 和 SQL 查询结果构建重点突出的 Telemetry 仪表板,然后安排小部件以快速做出运营决策。

阅读文档

模式演化

了解 Telemetry 如何适应添加事件字段或更改类型,以及如何在不破坏分析的情况下发展模式。

阅读文档

选择分区列

使用分区列使选择性 Telemetry 查询扫描更少的数据。

阅读文档

查询嵌套JSON

使用稳定的点列名称查询 Telemetry 中的顶级和嵌套 JSON 字段。

阅读文档

使用时间戳

一致地存储时间戳并使用 SQL 来提取、存储、比较和测量时间间隔。

阅读文档

CamelCase 与 snake_case

了解为什么 Snake_case 为 Telemetry 事件数据生成更简单、更可移植的 SQL 列名称。

阅读文档

结构化事件与文本日志

比较结构化事件和文本日志,包括何时使用它们、它们在 SQL 中有何不同,以及如何避免重复遥测。

阅读文档

日志、指标、跟踪和结构化事件

为调试、趋势、请求路径和业务工作流程选择正确的可观测性信号,而无需收集冗余数据。

阅读文档

设计事件架构

为可靠的 SQL、仪表板、告警和模式演变创建稳定的事件名称和类型字段。

阅读文档

高基数字段

在 SQL、仪表板和分区中有意使用用户 ID、请求 ID、URL 和其他高基数事件字段。

阅读文档

结构化事件的关联 ID

使用安全关联标识符连接请求、作业、Webhook 和跟踪,同时避免敏感数据和不稳定的连接。

阅读文档

对事件中的敏感数据进行脱敏

通过许可名单和边界级别控制,防止机密、个人数据和原始客户内容进入结构化事件。

阅读文档

Telemetry 的 DataFusion SQL 参考

使用时间过滤器、条件聚合、百分位数、窗口、联接和安全比率为 Telemetry 事件表编写实用的 DataFusion SQL。

阅读文档

事件传递、幂等性和重复处理

设计结构化事件生成器以实现重试、重复交付、稳定的事件标识和可测量的摄取失败。

阅读文档

批处理、背压与优雅关闭

选择安全的批量大小、绑定遥测队列、处理过载以及在应用程序关闭期间刷新或保留待处理事件。

阅读文档

结构化 Telemetry 的事件采样策略

减少遥测量,而不会使费率、百分位数、事件调查或客户影响分析失效。

阅读文档

用于事件分析的多租户身份建模

对帐户、用户、会话、匿名访问者和租户边界进行建模,而无需混合身份语义或暴露个人数据。

阅读文档

告警

从探索和查询结果中的单系列时间图表创建易于理解的阈值告警。

阅读文档

事件数据类型与可空性

选择稳定的字符串、数字、布尔值、时间戳和嵌套事件字段,以便架构在不破坏 SQL 的情况下不断发展。

阅读文档

数据保留和删除

计划表保留、选择性删除、全表删除以及结构化事件数据的验证。

阅读文档

规范化宽事件

设计规范的广泛事件,捕获一个已完成的工作单元以及 SQL、调试、仪表板和代理分析所需的上下文。

阅读文档

SQL 条件聚合

将 CASE 表达式与 COUNT、SUM 和 AVG 结合使用,根据结构化事件数据计算费率、细分和运营结果。

阅读文档

使用 SQL 对事件数据进行时间分桶

使用 date_trunc 或 date_bin 将结构化事件分组为完整的 UTC 时间间隔,然后比较费率和交易量,避免出现部分错误。

阅读文档

使用 SQL 计算延迟和分布百分位数

计算 DataFusion SQL 中的近似 p50、p95 和 p99 值,并在不隐藏体积或分布形状的情况下解释尾部延迟。

阅读文档

用于事件分析的 SQL 窗口函数

使用 LAG、ROW_NUMBER 和框架聚合来比较期间、删除重复事件并计算滚动基线,而不会丢失行详细信息。

阅读文档

使用 SQL 对结构化事件去重

定义事件标识并使用 ROW_NUMBER 删除重复的交付,而不会意外破坏有效的重试或重复的用户操作。

阅读文档

SQL 漏斗分析

使用有条件的里程碑、明确的排序、群组窗口和可审查的转化分母来构建帐户级产品渠道。

阅读文档

使用 SQL 分析同期群留存

衡量用户或帐户是否在起始里程碑后返回,同时明确群组日期、活动窗口、身份和不完整时段。

阅读文档

生产环境指南

实施完整的产品、可靠性、人工智能、计费、数据库、安全性和报告工作流程。

结构化日志记录指南

设计结构化应用程序事件,这些事件可以安全收集,易于使用 SQL 查询,并且对仪表板、调试和产品决策有用。

阅读文档

应用遥测实用指南

设计应用程序遥测,将结构化事件、日志、指标和跟踪连接到可靠的 SQL、仪表板和告警。

阅读文档

按模型和功能跟踪 OpenAI API 成本

按型号、功能、团队和结果跟踪 OpenAI API 成本。复制生产就绪的事件形状和 SQL 查询,然后将估算值与您的发票进行核对。

阅读文档

使用结构化事件和 SQL 评估 AI 代理

设计 AI 代理评估活动,将质量与成本和可靠性结合起来,并将版本与可审查的 SQL 和显式分母进行比较。

阅读文档

通过结构化事件进行 AI 代理安全监控

使用有界事件和可审查的 SQL 监控代理工具授权、策略拒绝、人工批准和终端结果。

阅读文档

将 OpenTelemetry GenAI 跟踪连接到结果事件

将 OpenTelemetry 生成式 AI 跟踪与紧凑的 Telemetry 结果事件相关联,无需复制提示、工具负载或完整范围。

阅读文档

收入 A/B 测试

比较不同实验变体中每个曝光访客的收入,并量化提升,而不会被不平等的流量误导。

阅读文档

监控网站正常运行时间

记录计划的心跳检查以测量正常运行时间、调查事件并对重复故障发出告警。

阅读文档

队列工作进程可观测性

一起监控队列深度和尾部延迟,以检测积压、卡住的工作人员和用户可见的处理延迟。

阅读文档

可视化分布

使用百分位来揭示单个平均值可以隐藏的典型价值、长尾和高价值客户群。

阅读文档

使用 SQL 测量转化率

分析漏斗里程碑并计算用户级转化率,以便您可以定位流失情况,而无需重复计算重复事件。

阅读文档

分析网络服务器错误

捕获状态、路由、发布和请求上下文,以便错误峰值导致特定的回归而不是通用计数。

阅读文档

代码执行性能分析

记录步骤持续时间和执行上下文,以查找瓶颈、比较运行并确定性能工作的优先级。

阅读文档

导出查询结果

选择同步 JSON 或异步 JSON 和 Parquet 导出、安全轮询并保留下游报告的查询上下文。

阅读文档

告警传送和故障排除

验证 Telemetry 告警查询、时间段、阈值、收件人、评估历史记录和电子邮件传送,而不会创建嘈杂的页面。

阅读文档

事件摄取故障排除

通过检查 HTTP 响应、API 密钥范围、有效负载形状、表规范化、时间戳、模式、重试和新鲜度来诊断丢失或拒绝的 Telemetry 事件。

阅读文档

SQL 查询故障排除

通过检查 API 响应、表架构、DataFusion 语法、字段类型、时间窗口、联接、速率和异步导出状态来系统地调试 Telemetry SQL。

阅读文档

使用 SQL 响应故障

使用可重复的 SQL 工作流程来确定事件范围、识别受影响的路线和发布、构建时间表并验证结构化事件的恢复情况。

阅读文档

使用 SQL 进行数据库可靠性监控

检测安全的应用程序级数据库事件并使用 SQL 调查慢速查询指纹、池争用、回滚、锁定、复制滞后和迁移。

阅读文档

从临时日志迁移到结构化事件和 SQL

将生产工作流程从自由格式的日志搜索转移到有界结构化事件、测试 SQL、仪表板和告警,而无需进行有风险的一次性切换。

阅读文档

使用 SQL 进行前端可靠性监控

检测类型化浏览器性能事件,并使用 SQL 按路由和发布比较 Core Web Vitals,而无需收集原始页面内容。

阅读文档

浏览器遥测代理与 Core Web Vitals

通过速率受限的服务器代理收集注重隐私的浏览器事件和核心 Web Vitals,而不会暴露 Telemetry API 密钥。

阅读文档

事件跟踪计划和治理

创建具有明确粒度、所有权、字段、隐私、验证、保留和下游 SQL 依赖项的事件跟踪计划。

阅读文档

在 CI 中测试 Telemetry 插桩

在 CI 中测试结构化事件合约、隐私边界、交付失败和 SQL 结果,而无需发送生产数据或依赖于实时 API。

阅读文档

将 Telemetry 与 OpenTelemetry 配合使用

在 OpenTelemetry 跟踪、指标和日志旁边使用 Telemetry 结果事件,并具有安全相关 ID 和明确的信号边界。

阅读文档

Kubernetes 使用 SQL 进行可靠性监控

使用结构化 Kubernetes 工作负载事件和 SQL 来调查容器重新启动、就绪性损失、部署更改和应用程序影响。

阅读文档

使用 SQL 进行安全审计分析

设计有界特权操作事件并使用 SQL 来审查拒绝、失败和人工审查队列,而不会暴露秘密。

阅读文档

使用 SQL 进行产品旅程分析

对订购产品里程碑进行建模,并使用 SQL 来衡量会话旅程的完成情况以及通过明确的计数规则逐步减少的情况。

阅读文档

遥测成本与数据量管理

在更改遥测收集合同之前测量事件计数、有效负载字节、拒绝率、保留率和基数。

阅读文档

使用 SQL 进行客户影响分析

将事件与隐私安全帐户影响事件连接起来,并使用 SQL 按计划计算受影响的帐户、受影响的份额和影响持续时间。

阅读文档

使用 SQL 进行 RAG 评估

版本 RAG 评估事件并使用 SQL 比较跨管道版本的检索相关性、接地答案、延迟和成本。

阅读文档

使用 SQL 进行功能推出分析

使用稳定的功能分配、发布上下文、请求量、错误和延迟,将控制和部署队列与 SQL 进行比较。

阅读文档

使用 SQL 实现可观测性与事件分析

了解结构化事件如何成为 SQL 就绪的可观测性数据、哪些事件合约有效、如何查询它们,以及 SQL 应在何处补充日志、指标和跟踪。

阅读文档

将计划的 SQL 报告发送到 Slack

按计划运行 Telemetry SQL 查询,将结果格式化为简洁的 Slack 消息,保护 Webhook 凭据,并使交付失败可观察。

阅读文档

将 LogQL、KQL 和 SPL 查询迁移到 SQL

将常见的 LogQL、Kusto 查询语言和 Splunk SPL 分析模式转换为可审查的 SQL,而无需假设语言或数据模型相同。

阅读文档

端到端 SaaS 可观测性演示

运行一个发出结构化事件的小型 Node.js SaaS 工作流程,使用 SQL 查询结果表,并将一个事件契约转换为可靠性、产品和成本视图。

阅读文档

Telemetry 数据摄取与查询性能基准测试

运行可重复的、有界的 Telemetry API 基准测试,将客户端计时与服务行为分开,发布测试条件,并避免不受支持的性能声明。

阅读文档

使用 SQL 进行 SLI、SLO 和错误预算监控

使用 SQL 定义基于请求的服务指标,计算 SLO 合规性和错误预算消耗,并构建可审查的可靠性告警。

阅读文档

无需从 SQL 开始即可探索结构化事件

检查事件样本、应用类型过滤器、聚合字段、构建图表以及将经过审核的“探索”结果提升到仪表板或告警中。

阅读文档

AI 辅助 SQL:生成、审查和验证查询

将重点事件问题转换为可编辑的 DataFusion SQL,然后审查模式假设、计数逻辑、隐私边界和结果有效性。

阅读文档

保存的查询、历史记录、收藏夹和协作

在团队工作区中组织审查的 SQL、保留查询历史记录、使用个人收藏夹,并将稳定的结果提升到共享仪表板和告警中。

阅读文档

安全的移动应用遥测代理

通过经过身份验证的服务器代理路由 React Native、Swift、Kotlin 和 Flutter 事件,使摄取密钥远离应用程序二进制文件。

阅读文档

Telemetry 如何评估 SQL 告警

了解 Telemetry 如何评估已保存的 SQL、选择点、聚合值、记录状态转换以及尝试电子邮件传送。

阅读文档