Getting Started

Current Limitations

The Performance at Scale feature is currently only available for the following SDKs:

  • Python: 1.7.2 or later
  • JavaScript: 7.6.0 or later
  • Apple: 7.23.0 or later
  • Android: 6.5.0 or later
  • React Native: 4.3.0 or later
  • Dart and Flutter: 6.11.0 or later
  • PHP: 3.9.0 or later
  • Laravel: 3.0.0 or later
  • Symfony: 4.4.0 or later
  • Ruby: 5.5.0 or later
  • Java: 6.5.0 or later
  • .NET: 3.22.0 or later
  • Go: 0.16.0 or later

If your application relies on any Sentry SDK that isn't specified above, then you won’t be able to use Sentry's Performance at Scale.

1. Update Sentry SDK Versions

Once you’ve confirmed that your application only relies on supported SDKs, then the next step is to update them to the specified version or higher. Check out the migration documentation for the SDKs you’re using to learn everything you need to know to get up and running again with the latest Sentry features.

2. Optionally, Update Retention Priorities

While we do our best to provide you with the most useful transaction data, we recognize that every project is different. For example, you may have a project where retaining transactions from the latest release or development environments is not a priority for you.

You can update your configuration by going into your project settings and navigating to the Performance tab. The feature allows you to turn the priorities that we apply to your data retention on or off: you can set these toggles differently for different projects.

The Retention Priorities section with toggles enabled.

By default, these toggles are all enabled so that Sentry's retention priorities are applied to your data.

3. Increase Your SDK Transaction Sample Rate

Our Performance at Scale feature works best when you send us as much data as you can (ideally 100%). As you purchase more transaction volume, your per-transaction pricing goes down accordingly, so you can affordably monitor your application at any scale. Update your transaction sample rate in the SDK by setting the tracesSampleRate.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").