Welcome to Instabug's Documentation!
Here you'll find a comprehensive technical guide
to help you start working with the Instabug SDK efficiently.

Get Started

App Launch

This page covers Instabug's app launch definition, its apdex calculation, how to set your custom target, and all the details you need to know about the app launch metric on iOS.

Cold App Launch

Instabug automatically measures your cold app launch latency, which is the time between when your user launches the app from scratch and when it is responsive and accepting touch events.

It starts with the process start time and stops by the end of the first run loop. This interval accounts for any launch blocking logic in your code as well as the time before your app classes are loaded. It includes loading dynamic frameworks and resolving any dynamic references made in the binary.

Disabling/Enabling Cold App Launch Tracking

If APM is enabled, our SDK starts collecting data about your cold app launch time by default. If needed, you can always toggle this on and off by updating the relevant flag after the SDK is initialized:

// Enable
APM.coldAppLaunchEnabled = true

// Disable
APM.coldAppLaunchEnabled = false
// Enable
IBGAPM.coldAppLaunchEnabled = YES;

// Disable
IBGAPM.coldAppLaunchEnabled = NO;

Hot App Launch

The Instabug SDK automatically measures the hot app launch latency, which is the time between the user launching the app from the background until it's responsive and accepting touch events.

Hot Launch is transitioning the app from the background to the foreground-active state. We capture the Hot Launch event by observing a UIApplicationWillEnterForegroundNotification notification which is then followed by UIApplicationDidBecomeActiveNotification.

Disabling/Enabling Hot App Launch Tracking

If APM is enabled, our SDK starts collecting data about your hot app launch time by default. If needed, you can always toggle this on and off by updating the relevant flag after the SDK is initialized:

// Enable
IBGAPM.hotAppLaunchEnabled = YES;

// Disable
IBGAPM.hotAppLaunchEnabled = NO;
// Enable
IBGAPM.hotAppLaunchEnabled = YES;

// Disable
IBGAPM.hotAppLaunchEnabled = NO;

End App Launch

In the event that you'd like to define a specific point in time where the app launch can be considered complete, such as when the app is actually interactable, you can use the end app launch API to set that point. You'll then be able to see this data alongside the automatic cold and hot app launches that were captured.

To use the End App Launch API, you'll just need to call the following method:

APM.endAppLaunch()
[IBGAPM endAppLaunch]

App Launch Apdex

Instabug calculates an Apdex score for your app launch that reflects how satisfying your app launch time is. Your Apdex score ranges between 0 and 1; a higher value means better performance and, hence, a better user experience:

  • Apdex score ≥ 0.94 equates to Excellent performance.
  • Apdex score ≥ 0.85 and < 0.94 equates to Good performance.
  • Apdex score ≥ 0.7 and < 0.85 equates to Fair performance.
  • Apdex score ≥ 0.5 and < 0.7 equates to Poor performance.
  • Apdex score < 0.5 is considered Unacceptable.

How Is The App Launch Apdex Calculated?

When an app launch occurrence is collected, it is flagged based on a pre-defined target (T). An app launch occurrence is considered:

  • Satisfying: if its duration ≤ T
  • Tolerable: if its duration > T and ≤ 4T
  • Frustrating: if its duration > 4T

Then based on the bucketing explained above, the Apdex score is calculated as follows:

  • Total occurrences = Satisfying occurrences + Tolerable occurrences + Frustrating occurrences
  • Apdex score = (Satisfying occurrences + 0.5 * Tolerable occurrences) / Total occurrences

How Can You Control Your App Launch Target?

By default, the target is set to 2 seconds, however, you can easily change this number from your dashboard by clicking on the action highlighted in the screenshots below.

Click on the highlighted action to control whether Cold App Launch affects your app apdex.Click on the highlighted action to control whether Cold App Launch affects your app apdex.

Click on the highlighted action to control whether Cold App Launch affects your app apdex.

📘

Please note that updating your app launch target does not affect the already stored occurrences, only future occurrences will be flagged using the new target.

Updated about a month ago

App Launch


This page covers Instabug's app launch definition, its apdex calculation, how to set your custom target, and all the details you need to know about the app launch metric on iOS.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.