Skip to content

Commit 6189169

Browse files
fix: App start definitions for iOS and Android (#15798)
<!-- Use this checklist to make sure your PR is ready for merge. You may delete any sections you don't need. --> ## DESCRIBE YOUR PR Corrects the definitions of cold/warm starts ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. - [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE --> - [ ] Other deadline: <!-- ENTER DATE HERE --> - [X] None: Not urgent, can wait up to 1 week+ ## SLA - Teamwork makes the dream work, so please add a reviewer to your PRs. - Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it. Thanks in advance for your help! ## PRE-MERGE CHECKLIST *Make sure you've checked the following before merging your changes:* - [ ] Checked Vercel preview for correctness, including links - [ ] PR was reviewed and approved by any necessary SMEs (subject matter experts) - [ ] PR was reviewed and approved by a member of the [Sentry docs team](https://github.com/orgs/getsentry/teams/docs) --------- Co-authored-by: Markus Hintersteiner <markus.hintersteiner@sentry.io>
1 parent 2b5ee08 commit 6189169

File tree

2 files changed

+5
-5
lines changed

2 files changed

+5
-5
lines changed

docs/concepts/search/searchable-properties/events.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -342,13 +342,13 @@ Returns results with a matching maximum value for the field entered.
342342

343343
### `measurements.app_start_cold`
344344

345-
A [cold start](/product/insights/mobile/mobile-vitals/app-starts/) refers to when the app launches for the first time after a reboot or update. The app is not in memory and no process exists.
345+
A [cold start](/product/insights/mobile/mobile-vitals/app-starts/) on Android refers to when the app process is created from scratch. On iOS it is only the first time a process is created after a reboot or update.
346346

347347
- **Type:** duration
348348

349349
### `measurements.app_start_warm`
350350

351-
A [warm start](/product/insights/mobile/mobile-vitals/app-starts/) refers to when the app has already launched at least once and is partially in memory. For instance, the user backs out of your app, but then re-launches it. The process may have continued to run, but the app must recreate the activity from scratch.
351+
A [warm start](/product/insights/mobile/mobile-vitals/app-starts/) on Android refers to when the app launches with some saved state, for example it may have an existing process and only need to create a new Activity. On iOS it is any process creation that isn't a cold start.
352352

353353
- **Type:** duration
354354

docs/platforms/apple/common/tracing/instrumentation/automatic-instrumentation.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,8 +102,8 @@ To enable this feature, enable `enableAutoPerformanceTracing`.
102102
103103
The SDK differentiates between a cold and a warm start, but doesn't track hot starts/resumes.
104104
105-
- **Cold start**: App launched for the first time, after a reboot or update. The app is not in memory and no process exists.
106-
- **Warm start**: App launched at least once, is partially in memory, and no process exists.
105+
- **Cold start**: App launched for the first time, after a reboot or update. A cold start begins when the process is created.
106+
- **Warm start**: Any time the process is created that isn’t a cold start.
107107
108108
<Alert>
109109
@@ -118,7 +118,7 @@ The Cocoa SDK creates the following app start spans:
118118
- **Runtime Init to Pre Main Initializers**: from runtime init to pre main initializers.
119119
- **UIKit Init**: from pre main initializers to the when starting the Sentry Cocoa SDK.
120120
- **Application Init**: this reflects the duration of your AppDelegate `application:didFinishLaunchingWithOptions` method or [App conformer's initializer](<https://developer.apple.com/documentation/swiftui/app/main()>) when using SwiftUI, which is from when starting the Cocoa SDK to the [`didFinishLaunchingNotification`][didfinishlaunching].
121-
- **Initial Frame Render**: from the [`didFinishLaunchingNotification`][didfinishlaunching] until the app renders its first frame. **Starting with version 9.0.0, this is the default behavior.** In versions prior to 9.0.0, this measured until [`UIWindowDidBecomeVisibleNotification`][uiwindow] unless you enabled the `enablePerformanceV2` option.
121+
- **Initial Frame Render**: from the [`didFinishLaunchingNotification`][didfinishlaunching] until the first CADisplayLink callback. **Starting with version 9.0.0, this is the default behavior.** In versions prior to 9.0.0, this measured until [`UIWindowDidBecomeVisibleNotification`][uiwindow] unless you enabled the `enablePerformanceV2` option.
122122
123123
![App Start Transaction](./img/app-start-transaction.png)
124124

0 commit comments

Comments
 (0)