App Starts

Learn how to monitor your mobile application's performance by using App Starts to identify slow or regressed screens.

This feature is available only if your organization is on a Business or Enterprise plan.

Example of App Starts

The App Starts page shows an overview of the amount of time it takes for your application to complete cold and warm starts. It helps you identify slow or regressed screens and gives additional information so you can better understand the factors contributing to the slowness of your application start times.

For Android:

  • >=7.4.0 for automatic instrumentation of app start spans and app start profiling
  • Performance-V2 feature flag and App Start Profiling must also be enabled in the SDK, e.g.:

SentryAndroid.init(this, options -> {

For iOS:

import Sentry

SentrySDK.start { options in
    options.enablePerformanceV2 = true

By default, the App Starts page displays metrics for the two releases with the highest screen counts for the time range you’ve selected. To choose a different set of releases to compare, use the “release selector” at the top of the page. To change the app start type (cold or warm), use the “App Start” selector at the top of the page.

The charts display the following metrics (using cold starts as an example):

  • Average Cold Start
    • The overall time it takes your application to start, compared by release.
  • Top Screen Cold Start
    • The time it takes for individual screens to start, compared by release. This chart syncs with the sort order in the table below it.
  • Count
    • The number of starts occurring in the selected time range for the releases. This gives you an idea of how statistically significant the aggregated data is.

Reasons Why You Might Not Be Seeing Any Data:

  • You don’t have any transactions with op ui.load
  • Your SDKs don’t meet the minimum SDK requirements

Example of Screen Summary

To get additional information about any of your application’s screens, click on them to get to the Screen Summary page. Here, you’ll see your average start duration broken down by release and device class (high, medium, low, or unknown). This will help you understand how users with different device performance levels are being affected.

The table below the chart shows spans that have changed from one release to the next and allows you to filter for specific span operations and device classes. Being able to narrow down to specific event samples helps debug slow starts.

Clicking the "By Event" toggle in the top right corner of this table will show you events split by release and you'll be able to see overall changes in start times between the two releases you've selected.

Example of Samples By Event

The following table describes the span operations that are surfaced in the spans table:

PlatformSpan Operations
  • file.write
  • ui.load
  • http.client
  • db
  • db.sql.query
  • db.sql.transaction
  • app.start.cold
  • app.start.warm
  • activity.load
  • application.load
  • contentprovider.load
  • process.load

Example of Span Detail View

Clicking on a span description opens up a side panel that shows span details, including the average duration and count for that span in each of the releases you’re looking at.

In the table below, you’ll see a list of sampled events and profiles (if they exist). By comparing the two, you’ll be able to see how much the duration of the span you’re looking at deviates from average spans in each of the two releases you’ve selected.

Sentry automatically identifies sample events to help you investigate performance problems. (They’re shown as triangles in the “Average Duration” graph.) To give you an accurate picture, a range of faster than average, slower than average, and average span durations are sampled across the whole time period you’ve selected.

You can use the sample list to drill down to and compare fast, average, and slow events of interest within a given screen.

Clicking on a sample event will take you into either the query’s span details within the span waterfall of the Trace View page or the profile icon to see the flamegraph for the event. To get different event samples, click the "Try Different Samples" button.

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