设置追踪

了解如何在您的应用程序中启用追踪。

通过 追踪,Sentry 跟踪您的软件性能,测量吞吐量和延迟等指标,并显示错误对多个系统的影響。Sentry 捕获由事务和跨度组成的分布式跟踪,这些事务和跨度分别测量各个服务及其内部的各个操作。更多关于我们的模型信息,请参阅 分布式追踪

如果您在高吞吐量环境中采用追踪功能,我们建议在部署前进行测试,以确保服务的性能特征符合预期。

首先,配置事务的采样率。通过以下方式之一设置事务的采样率:

  • 使用 SDK 配置中的 tracesSampleRate 选项为所有事务设置统一的采样率,该值应介于 01 之间。(例如,要发送 20% 的事务,将 tracesSampleRate 设置为 0.2。)
  • 通过提供一个函数给 tracesSampler 配置选项,根据事务本身及其捕获上下文来控制采样率。

这两个选项是互斥的。如果同时设置了两者,则以 tracesSampler 为准。

Set tracesSampleRate in your config files, sentry.server.config.js, sentry.client.config.js, and sentry.edge.config.js:

Copied
import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: "https://examplePublicKey@o0.ingest.sentry.io/0",

  // We recommend adjusting this value in production, or using `tracesSampler`
  // for finer control
  tracesSampleRate: 1.0,
});

了解更多关于追踪的 选项,如何使用 tracesSampler 函数,或如何 采样事务

在测试期间,将 tracesSampleRate 设置为 1.0,以确保每个事务都会发送到 Sentry。测试完成后,您可能希望设置一个较低的 tracesSampleRate 值,或切换到使用 tracesSampler,根据上下文数据有选择地采样和过滤事务。

如果您将采样率保持在 1.0,每次用户加载页面或在应用程序内导航时都会发送一个事务。根据您的应用程序流量,这可能会导致大量的事务。如果您有一个高负载的后端应用程序,您可能需要考虑设置一个较低的 tracesSampleRate 值,或切换到使用 tracesSampler,根据上下文数据有选择地采样和过滤事务。