---
title: "Tracing"
description: "Learn how to enable tracing in your app using the Sentry .NET SDK and see where work fails or slows down."
url: https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/
---

# Set Up Tracing for ASP.NET

## Set up with Sentry CLI

Set up the Sentry .NET SDK with the Sentry CLI. Install the CLI with one of these commands, then follow the Sentry CLI docs to finish setup.

**cURL**

```bash
curl https://cli.sentry.dev/install -fsS | bash
```

**PowerShell**

```powershell
irm https://cli.sentry.dev/install.ps1 | iex
```

**Homebrew**

```bash
brew install getsentry/tools/sentry
```

**npx**

```bash
npx sentry@latest
```

[Learn more about the Sentry CLI](https://cli.sentry.dev/)

With [tracing](https://docs.sentry.io/concepts/key-terms/tracing.md), Sentry follows requests, background jobs, and [agent runs](https://docs.sentry.io/product/agents.md) across services so you can see where they fail or slow down. Spans record each service and the operations inside it. 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.

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

First, enable tracing and configure the sample rate for transactions. Set the sample rate for your transactions by either:

* Setting a uniform sample rate for all transactions using the `TracesSampleRate` option in your SDK config to a number between `0` and `1`. (For example, to send 20% of transactions, set `TracesSampleRate` to `0.2`.)
* Controlling the sample rate based on the transaction 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.

```csharp
+ // Add this to the SDK initialization callback
+ // Example uniform sample rate: capture 100% of transactions
+ options.TracesSampleRate = 1.0;
```

Learn more about tracing [options](https://docs.sentry.io/platforms/dotnet/guides/aspnet/configuration/options.md#tracing-options), how to use the [TracesSampler](https://docs.sentry.io/platforms/dotnet/guides/aspnet/configuration/sampling.md#setting-a-sampling-function) function, or how to [sample transactions](https://docs.sentry.io/platforms/dotnet/guides/aspnet/configuration/sampling.md#sampling-transaction-events).

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

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

While you're testing, set `TracesSampleRate` to `1.0`, as that ensures that every transaction 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, based on contextual data.

## [Agent Tracing](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing.md#agent-tracing)

If you're building with agents or LLMs, the same trace can include the agent run, so you can see the model calls, tool executions, and where the run failed or slowed down. With tracing already enabled, the .NET SDK can automatically instrument agents built with `Microsoft.Extensions.AI`.

[Set up Agent Tracing](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/instrumentation/ai-agents-module.md) to get started.

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

* #### [Included Instrumentation](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/included-instrumentation.md)

  Learn what transactions are captured after tracing is enabled in the Sentry ASP.NET SDK.

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

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

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

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

* #### [Tracing Troubleshooting](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/troubleshooting.md)

  Learn how to troubleshoot your tracing setup.

## Pages in this section

- [Included Instrumentation](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/included-instrumentation.md)
- [Instrumentation](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/instrumentation.md)
- [Trace Propagation](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/trace-propagation.md)
- [Troubleshooting](https://docs.sentry.io/platforms/dotnet/guides/aspnet/tracing/troubleshooting.md)
