Important
This feature is supported in iOS agent version 7.4.0 and higher. App launch times are not reported when using simulators or during debugging.
The AppLaunch/Cold metric on iOS is more restrictive than general definitions suggest. It is only reported once after the following specific criteria are met:
After a device reboot: You must reboot the iOS device, then launch the application for the metric to be reported.
After a fresh install: You must perform a fresh installation of the iOS application and then launch it.
One-time reporting: The metric is generally only received once after these specific events occur, rather than every time the app is killed and restarted.
With the iOS agent, you can report app launch time, also known as "cold time" and "hot time" (warm and prewarmed times are not reported). By default, app launch times are collected with the feature flag NRFeatureFlag_AppStartMetrics.
View app launch time
Your app launch time is reported in milliseconds with the metrics AppLaunch/Cold and AppLaunch/Hot. To track these launch time metrics:
- Go to one.newrelic.com > All capabilities > Capabilities > Query builder.
- Run a NRQL query, such as:SELECT average(newrelic.timeslice.value ) * 1000 AS 'AppLaunch/Cold' FROM Metric WHERE metricTimesliceName = 'AppLaunch/Cold' AND entity.guid = 'YOUR_APP_TOKEN' SINCE 1664218800000 UNTIL 1664220600000 TIMESERIES
- Click Add to dashboard and either add it to an existing dashboard or create a new one.
If no data appears, review your logcat output for errors.