[Merge M48] "[Merge M49] Add SameVersionStartupCounts suffix to startup HardFault and Temperature h…

components/startup_metric_utils/browser/startup_metric_utils.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef COMPONENTS_STARTUP_METRIC_UTILS_BROWSER_STARTUP_METRIC_UTILS_H_
 #define COMPONENTS_STARTUP_METRIC_UTILS_BROWSER_STARTUP_METRIC_UTILS_H_
 
 #include <string>
 
 #include "base/time/time.h"
@@ skipping 14 matching lines @@
 enum StartupTemperature {
   // The startup was a cold start: nearly all of the binaries and resources were
   // brought into memory using hard faults.
   COLD_STARTUP_TEMPERATURE = 0,
   // The startup was a warm start: the binaries and resources were mostly
   // already resident in memory and effectively no hard faults were observed.
   WARM_STARTUP_TEMPERATURE = 1,
   // The startup type couldn't quite be classified as warm or cold, but rather
   // was somewhere in between.
   LUKEWARM_STARTUP_TEMPERATURE = 2,
-  // This must be after all meaningful values.
+  // This must be after all meaningful values. All new values should be added
+  // above this one.
   STARTUP_TEMPERATURE_COUNT,
   // Startup temperature wasn't yet determined.
   UNDETERMINED_STARTUP_TEMPERATURE
 };
 
 // Registers startup related prefs in |registry|.
 void RegisterPrefs(PrefRegistrySimple* registry);
 
 // Returns true if any UI other than the browser window has been displayed
 // so far.  Useful to test if UI has been displayed before the first browser
@@ skipping 15 matching lines @@
 // On Android, the entry point time is the time at which the Java code starts.
 // In Mojo, the entry point time is the time at which the shell starts.
 void RecordMainEntryPointTime(const base::Time& time);
 
 // Call this with the time when the executable is loaded and main() is entered.
 // Can be different from |RecordMainEntryPointTime| when the startup process is
 // contained in a separate dll, such as with chrome.exe / chrome.dll on Windows.
 void RecordExeMainEntryPointTime(const base::Time& time);
 
 // Call this with the time recorded just before the message loop is started.
-// |is_first_run| - is the current launch part of a first run.
+// |is_first_run| - is the current launch part of a first run. |pref_service| is
+// an optional parameter which, if provided, will be used to store state for
+// stats that span multiple startups; in its absence those stats will not be
+// recorded.
 void RecordBrowserMainMessageLoopStart(const base::TimeTicks& ticks,
-                                       bool is_first_run);
-
-// Logs the Startup.TimeSinceLastStartup histogram. Obtains the timestamp of the
-// last startup from |pref_service| and overwrites it with the timestamp of the
-// current startup. If the startup temperature has been set by
-// RecordBrowserMainMessageLoopStart, the time since last startup is also logged
-// to an histogram suffixed with the startup temperature.
-void RecordTimeSinceLastStartup(PrefService* pref_service);
-
-// Logs the Startup.SameVersionStartupCount histogram. Relies on |pref_service|
-// to know information about the previous startups and store information for
-// future ones.
-void RecordStartupCount(PrefService* pref_service);
+                                       bool is_first_run,
+                                       PrefService* pref_service);
 
 // Call this with the time when the first browser window became visible.
 void RecordBrowserWindowDisplay(const base::TimeTicks& ticks);
 
 // Call this with the time delta that the browser spent opening its tabs.
 void RecordBrowserOpenTabsDelta(const base::TimeDelta& delta);
 
 // Call this with the time when the first web contents loaded its main frame,
 // only if the first web contents was unimpended in its attempt to do so.
 void RecordFirstWebContentsMainFrameLoad(const base::TimeTicks& ticks);
@@ skipping 26 matching lines @@
 base::TimeTicks MainEntryPointTicks();
 
 // Returns the startup type. This is only currently supported on the Windows
 // platform and will simply return UNCERTAIN_STARTUP_TYPE on other platforms.
 // This is only valid after a call to RecordBrowserMainMessageLoopStart().
 StartupTemperature GetStartupTemperature();
 
 }  // namespace startup_metric_utils
 
 #endif  // COMPONENTS_STARTUP_METRIC_UTILS_BROWSER_STARTUP_METRIC_UTILS_H_