---
title: "Tracing"
description: "Learn how to enable tracing in your app using the Sentry Go SDK and see where requests and jobs fail or slow down."
url: https://docs.sentry.io/platforms/go/guides/gin/tracing/
---

# Set Up Tracing for Gin

With [tracing](https://docs.sentry.io/concepts/key-terms/tracing.md), Sentry follows requests and background jobs 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.

Sentry can integrate with **OpenTelemetry**. You can find more information about it [here](https://docs.sentry.io/platforms/go/guides/gin/tracing/instrumentation/opentelemetry.md).

## [Requirements](https://docs.sentry.io/platforms/go/guides/gin/tracing.md#requirements)

* Tracing is available for the Sentry's Go SDK version ≥ 0.9.0.

## [Configure](https://docs.sentry.io/platforms/go/guides/gin/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.

```go
func main() {
    err := sentry.Init(sentry.ClientOptions{
        // ...

+       EnableTracing: true,

+       // Specify a fixed sample rate:
+       // We recommend adjusting this value in production
+       TracesSampleRate: 1.0,

+       // Or provide a custom sample rate:
+       TracesSampler: sentry.TracesSampler(func(ctx sentry.SamplingContext) float64 {
+           // As an example, this does not send some
+           // transactions to Sentry based on their name.
+           if ctx.Span.Name == "GET /health" {
+               return 0.0
+           }
+           return 1.0
+       }),
    })
}
```

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

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

If you're using an HTTP framework with Sentry middleware (Gin, Echo, Fiber, etc.), transactions are created automatically for every incoming request. See [Automatic Instrumentation](https://docs.sentry.io/platforms/go/guides/gin/tracing/instrumentation/auto-instrumentation.md) for details.

If you're not using a supported framework, you can manually create transactions. Learn how in our [Custom Instrumentation](https://docs.sentry.io/platforms/go/guides/gin/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.

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

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

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

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

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

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

  Learn how to troubleshoot your tracing setup.

## Pages in this section

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