---
title: "Tracing"
description: "Learn how to enable tracing in your app using the Sentry Dart SDK and see what parts of your app fail or slow down."
url: https://docs.sentry.io/platforms/dart/tracing/
---

# Set Up Tracing for Dart

With [tracing](https://docs.sentry.io/concepts/key-terms/tracing.md), Sentry follows requests and other operations and processes in your app so you can see where they fail or slow down. Spans record each operation. Learn more in [Distributed Tracing](https://docs.sentry.io/concepts/key-terms/tracing/distributed-tracing.md).

If you're adopting Tracing in a high-throughput environment, we recommend testing prior to deployment to ensure that your service's performance characteristics maintain expectations.

Sentry can send spans in one of two ways: stream mode (the default), where spans are sent in batches as they finish, or transaction mode, where spans are sent together when the transaction ends. See [Streamed Spans](https://docs.sentry.io/platforms/dart/tracing/streamed-spans.md) to learn more.

## [Configure](https://docs.sentry.io/platforms/dart/tracing.md#configure)

First, enable tracing and configure the sample rate for transactions (or service spans in stream mode). Set the sample rate by either:

* Setting a uniform sample rate for all transactions/service spans using the `tracesSampleRate` option in your SDK config to a number between `0` and `1`. (For example, to send 20% of transactions/service spans, set `tracesSampleRate` to `0.2`.)
* Controlling the sample rate based on the transaction/service span itself and the context in which it's captured, by providing a function to the `tracesSampler` config option.

The two options are meant to be mutually exclusive. If you set both, `tracesSampler` will take precedence.

```dart
Sentry.init((options) {
+   // To set a uniform sample rate
+   options.tracesSampleRate = 1.0;

+   // OR if you prefer, determine traces sample rate
+   // based on the sampling context
+   options.tracesSampler = (samplingContext) {
+     // return a number between 0 and 1 or null (to fallback
+     // to configured value)
+   };
});
```

Learn more about tracing [options](https://docs.sentry.io/platforms/dart/configuration/options.md#tracing-options), how to use the [tracesSampler](https://docs.sentry.io/platforms/dart/configuration/sampling.md#setting-a-sampling-function) function, or how to [sample transactions and service spans](https://docs.sentry.io/platforms/dart/configuration/sampling.md#sampling-transaction-events).

## [Verify](https://docs.sentry.io/platforms/dart/tracing.md#verify)

Verify that tracing is working correctly by using our [automatic instrumentation](https://docs.sentry.io/platforms/dart/tracing/instrumentation/automatic-instrumentation.md) or by starting and finishing a transaction/service span using [custom instrumentation](https://docs.sentry.io/platforms/dart/tracing/instrumentation/custom-instrumentation.md).

Test out tracing by starting and finishing a transaction/service span, which you *must* do so data can be sent to Sentry. Learn how in our [Custom Instrumentation](https://docs.sentry.io/platforms/dart/tracing/instrumentation/custom-instrumentation.md) content.

While you're testing, set `tracesSampleRate` to `1.0`, as that ensures that every transaction/service span will be sent to Sentry. Once testing is complete, you may want to set a lower `tracesSampleRate` value, or switch to using `tracesSampler` to selectively sample and filter your transactions/service spans, based on contextual data.

## [Next Steps](https://docs.sentry.io/platforms/dart/tracing.md#next-steps)

* #### [Streamed Spans](https://docs.sentry.io/platforms/dart/tracing/streamed-spans.md)

  Learn how to use stream mode to send spans to Sentry as they finish, removing the 1,000-span limit and making trace data visible sooner.

* #### [Instrumentation](https://docs.sentry.io/platforms/dart/tracing/instrumentation.md)

  Learn how to instrument tracing in your app using Sentry's Dart SDK.

* #### [Trace Propagation](https://docs.sentry.io/platforms/dart/tracing/trace-propagation.md)

  Learn how to connect events across applications/services using the Sentry Dart SDK.

## Pages in this section

- [Streamed Spans](https://docs.sentry.io/platforms/dart/tracing/streamed-spans.md)
- [Instrumentation](https://docs.sentry.io/platforms/dart/tracing/instrumentation.md)
- [Trace Propagation](https://docs.sentry.io/platforms/dart/tracing/trace-propagation.md)
