[Starfish] Attach app-start spans

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Features
+
+- (Internal, Experimental) Attach spans for Application, ContentProvider, and Activities to app-start ([#3057](https://github.com/getsentry/sentry-java/pull/3057))
+
 ## 6.34.0
 
 ### Features

sentry-android-core/api/sentry-android-core.api

@@ -115,17 +115,6 @@ public final class io/sentry/android/core/AppLifecycleIntegration : io/sentry/In
 	public fun register (Lio/sentry/IHub;Lio/sentry/SentryOptions;)V
 }
 
-public final class io/sentry/android/core/AppStartState {
-	public fun getAppStartEndTime ()Lio/sentry/SentryDate;
-	public fun getAppStartInterval ()Ljava/lang/Long;
-	public fun getAppStartMillis ()Ljava/lang/Long;
-	public fun getAppStartTime ()Lio/sentry/SentryDate;
-	public static fun getInstance ()Lio/sentry/android/core/AppStartState;
-	public fun isColdStart ()Ljava/lang/Boolean;
-	public fun reset ()V
-	public fun setAppStartMillis (J)V
-}
-
 public final class io/sentry/android/core/AppState {
 	public static fun getInstance ()Lio/sentry/android/core/AppState;
 	public fun isInBackground ()Ljava/lang/Boolean;
@@ -151,6 +140,7 @@ public final class io/sentry/android/core/BuildInfoProvider {
 }
 
 public final class io/sentry/android/core/ContextUtils {
+	public static fun isForegroundImportance (Landroid/content/Context;)Z
 }
 
 public class io/sentry/android/core/CurrentActivityHolder {
@@ -269,6 +259,7 @@ public final class io/sentry/android/core/SentryAndroidOptions : io/sentry/Sentr
 	public fun isEnableFramesTracking ()Z
 	public fun isEnableNetworkEventBreadcrumbs ()Z
 	public fun isEnableRootCheck ()Z
+	public fun isEnableStarfish ()Z
 	public fun isEnableSystemEventBreadcrumbs ()Z
 	public fun isReportHistoricalAnrs ()Z
 	public fun setAnrEnabled (Z)V
@@ -289,6 +280,7 @@ public final class io/sentry/android/core/SentryAndroidOptions : io/sentry/Sentr
 	public fun setEnableFramesTracking (Z)V
 	public fun setEnableNetworkEventBreadcrumbs (Z)V
 	public fun setEnableRootCheck (Z)V
+	public fun setEnableStarfish (Z)V
 	public fun setEnableSystemEventBreadcrumbs (Z)V
 	public fun setNativeSdkName (Ljava/lang/String;)V
 	public fun setProfilingTracesHz (I)V
@@ -326,17 +318,12 @@ public final class io/sentry/android/core/SentryLogcatAdapter {
 	public static fun wtf (Ljava/lang/String;Ljava/lang/Throwable;)I
 }
 
-public final class io/sentry/android/core/SentryPerformanceProvider : android/app/Application$ActivityLifecycleCallbacks {
+public final class io/sentry/android/core/SentryPerformanceProvider {
 	public fun <init> ()V
 	public fun attachInfo (Landroid/content/Context;Landroid/content/pm/ProviderInfo;)V
+	public fun getActivityCallback ()Landroid/app/Application$ActivityLifecycleCallbacks;
 	public fun getType (Landroid/net/Uri;)Ljava/lang/String;
-	public fun onActivityCreated (Landroid/app/Activity;Landroid/os/Bundle;)V
-	public fun onActivityDestroyed (Landroid/app/Activity;)V
-	public fun onActivityPaused (Landroid/app/Activity;)V
-	public fun onActivityResumed (Landroid/app/Activity;)V
-	public fun onActivitySaveInstanceState (Landroid/app/Activity;Landroid/os/Bundle;)V
-	public fun onActivityStarted (Landroid/app/Activity;)V
-	public fun onActivityStopped (Landroid/app/Activity;)V
+	public fun onAppLaunched ()V
 	public fun onCreate ()Z
 }
 
@@ -387,3 +374,89 @@ public final class io/sentry/android/core/cache/AndroidEnvelopeCache : io/sentry
 	public fun store (Lio/sentry/SentryEnvelope;Lio/sentry/Hint;)V
 }
 
+public class io/sentry/android/core/performance/ActivityLifecycleCallbacksAdapter : android/app/Application$ActivityLifecycleCallbacks {
+	public fun <init> ()V
+	public fun onActivityCreated (Landroid/app/Activity;Landroid/os/Bundle;)V
+	public fun onActivityDestroyed (Landroid/app/Activity;)V
+	public fun onActivityPaused (Landroid/app/Activity;)V
+	public fun onActivityResumed (Landroid/app/Activity;)V
+	public fun onActivitySaveInstanceState (Landroid/app/Activity;Landroid/os/Bundle;)V
+	public fun onActivityStarted (Landroid/app/Activity;)V
+	public fun onActivityStopped (Landroid/app/Activity;)V
+}
+
+public class io/sentry/android/core/performance/ActivityLifecycleTimeSpan : java/lang/Comparable {
+	public final field onCreate Lio/sentry/android/core/performance/TimeSpan;
+	public final field onStart Lio/sentry/android/core/performance/TimeSpan;
+	public fun <init> ()V
+	public fun compareTo (Lio/sentry/android/core/performance/ActivityLifecycleTimeSpan;)I
+	public synthetic fun compareTo (Ljava/lang/Object;)I
+}
+
+public class io/sentry/android/core/performance/AppStartMetrics {
+	public fun <init> ()V
+	public fun addActivityLifecycleTimeSpans (Lio/sentry/android/core/performance/ActivityLifecycleTimeSpan;)V
+	public fun clear ()V
+	public fun getActivityLifecycleTimeSpans ()Ljava/util/List;
+	public fun getAppStartTimeSpan ()Lio/sentry/android/core/performance/TimeSpan;
+	public fun getAppStartType ()Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;
+	public fun getApplicationOnCreateTimeSpan ()Lio/sentry/android/core/performance/TimeSpan;
+	public fun getContentProviderOnCreateTimeSpans ()Ljava/util/List;
+	public static fun getInstance ()Lio/sentry/android/core/performance/AppStartMetrics;
+	public fun getLegacyAppStartTimeSpan ()Lio/sentry/android/core/performance/TimeSpan;
+	public fun isAppLaunchedInForeground ()Z
+	public static fun onApplicationCreate (Landroid/app/Application;)V
+	public static fun onApplicationPostCreate (Landroid/app/Application;)V
+	public static fun onContentProviderCreate (Landroid/content/ContentProvider;)V
+	public static fun onContentProviderPostCreate (Landroid/content/ContentProvider;)V
+	public fun setAppStartType (Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;)V
+}
+
+public final class io/sentry/android/core/performance/AppStartMetrics$AppStartType : java/lang/Enum {
+	public static final field COLD Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;
+	public static final field UNKNOWN Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;
+	public static final field WARM Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;
+	public static fun valueOf (Ljava/lang/String;)Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;
+	public static fun values ()[Lio/sentry/android/core/performance/AppStartMetrics$AppStartType;
+}
+
+public class io/sentry/android/core/performance/NextDrawListener : android/view/View$OnAttachStateChangeListener, android/view/ViewTreeObserver$OnDrawListener {
+	protected fun <init> (Landroid/os/Handler;Ljava/lang/Runnable;)V
+	public static fun forActivity (Landroid/app/Activity;Ljava/lang/Runnable;)Lio/sentry/android/core/performance/NextDrawListener;
+	public fun onDraw ()V
+	public fun onViewAttachedToWindow (Landroid/view/View;)V
+	public fun onViewDetachedFromWindow (Landroid/view/View;)V
+	public fun unregister ()V
+}
+
+public class io/sentry/android/core/performance/TimeSpan : java/lang/Comparable {
+	public fun <init> ()V
+	public fun compareTo (Lio/sentry/android/core/performance/TimeSpan;)I
+	public synthetic fun compareTo (Ljava/lang/Object;)I
+	public fun getDescription ()Ljava/lang/String;
+	public fun getDurationMs ()J
+	public fun getProjectedStopTimestamp ()Lio/sentry/SentryDate;
+	public fun getProjectedStopTimestampMs ()J
+	public fun getProjectedStopTimestampS ()D
+	public fun getStartTimestamp ()Lio/sentry/SentryDate;
+	public fun getStartTimestampMs ()J
+	public fun getStartTimestampS ()D
+	public fun getStartUptimeMs ()J
+	public fun hasNotStarted ()Z
+	public fun hasNotStopped ()Z
+	public fun hasStarted ()Z
+	public fun hasStopped ()Z
+	public fun reset ()V
+	public fun setDescription (Ljava/lang/String;)V
+	public fun setStartUnixTimeMs (J)V
+	public fun setStartedAt (J)V
+	public fun setStoppedAt (J)V
+	public fun start ()V
+	public fun stop ()V
+}
+
+public class io/sentry/android/core/performance/WindowContentChangedCallback : io/sentry/android/core/internal/gestures/WindowCallbackAdapter {
+	public fun <init> (Landroid/view/Window$Callback;Ljava/lang/Runnable;)V
+	public fun onContentChanged ()V
+}
+

sentry-android-core/src/main/java/io/sentry/android/core/ActivityLifecycleIntegration.java

@@ -30,6 +30,8 @@
 import io.sentry.TransactionOptions;
 import io.sentry.android.core.internal.util.ClassUtil;
 import io.sentry.android.core.internal.util.FirstDrawDoneListener;
+import io.sentry.android.core.performance.AppStartMetrics;
+import io.sentry.android.core.performance.TimeSpan;
 import io.sentry.protocol.MeasurementValue;
 import io.sentry.protocol.TransactionNameSource;
 import io.sentry.util.Objects;
@@ -70,7 +72,6 @@ public final class ActivityLifecycleIntegration
   private boolean isAllActivityCallbacksAvailable;
 
   private boolean firstActivityCreated = false;
-  private final boolean foregroundImportance;
 
   private @Nullable FullyDisplayedReporter fullyDisplayedReporter = null;
   private @Nullable ISpan appStartSpan;
@@ -100,10 +101,6 @@ public ActivityLifecycleIntegration(
     if (buildInfoProvider.getSdkInfoVersion() >= Build.VERSION_CODES.Q) {
       isAllActivityCallbacksAvailable = true;
     }
-
-    // we only track app start for processes that will show an Activity (full launch).
-    // Here we check the process importance which will tell us that.
-    foregroundImportance = ContextUtils.isForegroundImportance(this.application);
   }
 
   @Override
@@ -182,15 +179,27 @@ private void startTracing(final @NotNull Activity activity) {
       if (!performanceEnabled) {
         activitiesWithOngoingTransactions.put(activity, NoOpTransaction.getInstance());
         TracingUtils.startNewTrace(hub);
-      } else if (performanceEnabled) {
+      } else {
         // as we allow a single transaction running on the bound Scope, we finish the previous ones
         stopPreviousTransactions();
 
         final String activityName = getActivityName(activity);
 
-        final SentryDate appStartTime =
-            foregroundImportance ? AppStartState.getInstance().getAppStartTime() : null;
-        final Boolean coldStart = AppStartState.getInstance().isColdStart();
+        final @Nullable SentryDate appStartTime;
+        final @Nullable Boolean coldStart;
+        final TimeSpan appStartTimeSpan = getAppStartTimeSpan();
+
+        // we only track app start for processes that will show an Activity (full launch).
+        // Here we check the process importance which will tell us that.
+        final boolean foregroundImportance = ContextUtils.isForegroundImportance(this.application);
+        if (foregroundImportance && appStartTimeSpan.hasStarted()) {
+          appStartTime = appStartTimeSpan.getStartTimestamp();
+          coldStart =
+              AppStartMetrics.getInstance().getAppStartType() == AppStartMetrics.AppStartType.COLD;
+        } else {
+          appStartTime = null;
+          coldStart = null;
+        }
 
         final TransactionOptions transactionOptions = new TransactionOptions();
         if (options.isEnableActivityLifecycleTracingAutoFinish()) {
@@ -406,13 +415,13 @@ public synchronized void onActivityStarted(final @NotNull Activity activity) {
   public synchronized void onActivityResumed(final @NotNull Activity activity) {
     if (performanceEnabled) {
       // app start span
-      @Nullable final SentryDate appStartStartTime = AppStartState.getInstance().getAppStartTime();
-      @Nullable final SentryDate appStartEndTime = AppStartState.getInstance().getAppStartEndTime();
+      final @NotNull TimeSpan appStartTimeSpan = getAppStartTimeSpan();
+
       // in case the SentryPerformanceProvider is disabled it does not set the app start times,
       // and we need to set the end time manually here,
       // the start time gets set manually in SentryAndroid.init()
-      if (appStartStartTime != null && appStartEndTime == null) {
-        AppStartState.getInstance().setAppStartEnd();
+      if (appStartTimeSpan.hasStarted() && appStartTimeSpan.hasNotStopped()) {
+        appStartTimeSpan.stop();
       }
       finishAppStartSpan();
 
@@ -625,7 +634,15 @@ private void setColdStart(final @Nullable Bundle savedInstanceState) {
     if (!firstActivityCreated) {
       // if Activity has savedInstanceState then its a warm start
       // https://developer.android.com/topic/performance/vitals/launch-time#warm
-      AppStartState.getInstance().setColdStart(savedInstanceState == null);
+      // SentryPerformanceProvider sets this already
+      // pre-starfish: back-fill with best guess
+      if (options != null && !options.isEnableStarfish()) {
+        AppStartMetrics.getInstance()
+            .setAppStartType(
+                savedInstanceState == null
+                    ? AppStartMetrics.AppStartType.COLD
+                    : AppStartMetrics.AppStartType.WARM);
+      }
     }
   }
 
@@ -661,9 +678,18 @@ private void setColdStart(final @Nullable Bundle savedInstanceState) {
   }
 
   private void finishAppStartSpan() {
-    final @Nullable SentryDate appStartEndTime = AppStartState.getInstance().getAppStartEndTime();
+    final @NotNull TimeSpan appStartTimeSpan = getAppStartTimeSpan();
+    final @Nullable SentryDate appStartEndTime = appStartTimeSpan.getProjectedStopTimestamp();
     if (performanceEnabled && appStartEndTime != null) {
       finishSpan(appStartSpan, appStartEndTime);
     }
   }
+
+  private @NotNull TimeSpan getAppStartTimeSpan() {
+    final @NotNull TimeSpan appStartTimeSpan =
+        options.isEnableStarfish()
+            ? AppStartMetrics.getInstance().getAppStartTimeSpan()
+            : AppStartMetrics.getInstance().getLegacyAppStartTimeSpan();
+    return appStartTimeSpan;
+  }
 }