跳转到内容
整合集合

应用框架 Telemetry 集成

比较 JavaScript、Python、Elixir、PHP、Java、.NET 和 Go 的服务器框架的请求、作业、数据库和发布检测模式。

审阅者 Telemetry产品团队 上 . 我们检查了代码运行位置、共享事件字段、验证步骤和链接的实施指南. 谁负责审核此页面

11 实施指南

每个指南都包含服务器端代码片段、交付和隐私边界、验证查询、相关 SQL 以及上游文档的链接。

浏览指南

选择框架

选择知道结果的边界

框架解决结果后的工具

使用状态、持续时间和受控错误类别已知的终端中间件、异常过滤器、响应挂钩或处理程序包装器。

将运输成功与产品成功分开

200 响应仍然可以代表被拒绝或不完整的工作流程。在拥有它的层添加有限的业务成果。

跨版本使用稳定的名称

记录路由模板、命名操作和发布,而不是原始 URL、函数源、请求正文或任意异常消息。

共享事件合约

保持第一个模式可互操作

  • route_template、方法、状态、结果、duration_ms 和发布
  • request_id、account_id、环境、运行时和受控 error_type
  • 数据库持续时间、队列切换、依赖性和已知的业务成果

使这些字段适应工作流程,但在多个服务依赖同一个表之前保持单位、状态类别、标识符和所有权明确。

验证

在发出警报之前练习故障路径

  1. 1练习一次成功、验证失败、未处理的异常和超时。
  2. 2确认路由名称已模板化并且敏感请求数据已被排除。
  3. 3将记录的持续时间和状态与框架响应进行比较。
  4. 4重新启动运行时并验证挂起的遥测不能无限期地阻止关闭。

实施指南

匹配框架、提供程序或运行时

含来源链接的配置指南

Node.js 和快速结构化日志记录

Instrument Express 路由结果具有稳定的路由模板、状态代码、请求延迟和安全关联字段。

打开指南
含来源链接的配置指南

Next.js 服务器事件分析

通过可用于 SQL 查询的事件观测现有 Next.js 路由处理函数,无需向浏览器暴露写入密钥。

打开指南
含来源链接的配置指南

NestJS 请求和工作流程 Telemetry

为 NestJS 控制器和提供者提供规范化的路由结果、延迟、错误、版本和批准的帐户上下文。

打开指南
含来源链接的配置指南

Python 和 FastAPI 结构化日志记录

使用 Telemetry 异步客户端和规范化路由名称,记录 FastAPI 响应状态及响应头阶段的延迟。

打开指南
含来源链接的配置指南

Django 和 Celery 结构化事件监控

记录 Celery 任务每次尝试的状态,不将重试误记为最终失败,也不改变任务结果。

打开指南
含来源链接的配置指南

Flask 和 SQLAlchemy Telemetry

使用有界 Python 事件、稳定的路由模板和安全的错误类别来测量 Flask 请求结果和 SQLAlchemy 事务行为。

打开指南
含来源链接的配置指南

Elixir Phoenix Telemetry 集成

附加到 Phoenix 请求生命周期事件并转发有界终端请求结果,而无需复制连接数据、参数或异常文本。

打开指南
含来源链接的配置指南

Laravel 结构化日志记录和队列分析

将 Laravel 请求、命令、队列和计费结果作为类型化事件发送,而不会暴露应用程序机密或有效负载。

打开指南
含来源链接的配置指南

.NET 和 Serilog 结构化事件分析

除了针对 ASP.NET 请求延迟、故障、版本和客户影响的 Serilog 诊断之外,添加重点 Telemetry 结果事件。

打开指南
含来源链接的配置指南

Spring Boot 结构化事件监控

通过 Telemetry 的 HTTP API 记录 Spring MVC 和预定工作流结果,并提供稳定的路由、延迟、状态和跟踪上下文。

打开指南
含来源链接的配置指南

Go HTTP 服务器结构化日志记录

将类型化的请求结果事件添加到 Go HTTP 服务,以获取路由错误率、延迟百分位数和版本比较。

打开指南

首先验证一个端到端工作流程

创建一个免费的 API 密钥,选择最接近的运行时指南,并在扩大覆盖范围之前发送已知的成功和失败信息。

免费开始