tools/metrics/histograms/histograms.xml

Index: tools/metrics/histograms/histograms.xml
diff --git a/tools/metrics/histograms/histograms.xml b/tools/metrics/histograms/histograms.xml
index 565e6e68c7d7b02b9124d4ea686e8fed7bd763ad..36678c77d00e823c3fcec5bf35a804339ec23a00 100644
--- a/tools/metrics/histograms/histograms.xml
+++ b/tools/metrics/histograms/histograms.xml
@@ -49680,6 +49680,20 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram name="Prerender.PerceivedTTFCPRecorded" enum="BooleanRecorded">
+  <owner>droger@chromium.org</owner>
+  <owner>mattcary@chromium.org</owner>
+  <owner>pasko@chromium.org</owner>
+  <summary>
+    Whether the perceived TTFCP was recorded successfully for a prerendered

[Ilya Sherman, 2016/12/27 22:46:06]

It's probably helpful to clarify what TTFCP means, as you do in the other
histogram description, below.

[mattcary, 2016/12/28 09:52:33]

Done.

+    page. Since a prerendered page will start loading before a user navigates to
+    it, the perceived TTFCP does not include an time prior to the user
+    navigation. If true, there is an associated PrefetchTTFCP that records the
+    TTFCP from the swapped-in navigation start. If false, no PrefetchTTFCP was
+    recorded.
+  </summary>
+</histogram>
+
 <histogram name="Prerender.PercentLoadDoneAtSwapin">
   <owner>pasko@chromium.org</owner>
   <summary>
@@ -49705,6 +49719,19 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram name="Prerender.PrefetchTTFCP" units="ms">
+  <owner>droger@chromium.org</owner>
+  <owner>mattcary@chromium.org</owner>
+  <owner>pasko@chromium.org</owner>
+  <summary>
+    Time to first contentful paint (TTFCP) for navigations related to prefetch
+    (including prerender, no-state prefetch, and associated experiments). This
+    measures user-visible TTFCP. For no-state prefetch this is standard
+    navigation-to-FCP; for prerender this is the time from navigation start when
+    the prerender is swapped in to FCP.
+  </summary>
+</histogram>
+
 <histogram name="Prerender.PrerenderCountOf3Max">
   <owner>pasko@chromium.org</owner>
   <summary>
@@ -78125,6 +78152,11 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   <int value="1" label="Received"/>
 </enum>
 
+<enum name="BooleanRecorded" type="int">
+  <int value="0" label="Not Recorded"/>
+  <int value="1" label="Recorded"/>
+</enum>
+
 <enum name="BooleanRegistered" type="int">
   <int value="0" label="Not Registered"/>
   <int value="1" label="Registered"/>
@@ -113990,6 +114022,7 @@ value.
              prefetched pages (bias)."/>
   <suffix name="Warm" label="Prefetch skips revalidation."/>
   <affected-histogram name="Prerender.NoStatePrefetchTTFCP"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP"/>
 </histogram_suffixes>
 
 <histogram_suffixes name="PrerenderPrefetchMainResourceType" separator=".">
@@ -113998,6 +114031,21 @@ value.
   <affected-histogram name="Prerender.NoStatePrefetchTTFCP.Cold"/>
   <affected-histogram name="Prerender.NoStatePrefetchTTFCP.Reference"/>
   <affected-histogram name="Prerender.NoStatePrefetchTTFCP.Warm"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Reference"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm"/>
+</histogram_suffixes>
+
+<histogram_suffixes name="PrerenderPrefetchPaintVisibility" separator=".">
+  <suffix name="Hidden" label="Page was hidden during rendering."/>
+  <suffix name="Visible" label="Page visible for all of rendering."/>
+  <affected-histogram name="Prerender.PerceivedTTFCPRecorded"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold.Cacheable"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold.NoStore"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Reference.Cacheable"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Reference.NoStore"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm.Cacheable"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm.NoStore"/>
 </histogram_suffixes>
 
 <histogram_suffixes name="PrerenderSource" ordering="prefix">
@@ -114051,7 +114099,23 @@ value.
   <affected-histogram name="Prerender.PerceivedPLTMatchedComplete"/>
   <affected-histogram name="Prerender.PerceivedPLTWindowed"/>
   <affected-histogram name="Prerender.PerceivedPLTWindowNotMatched"/>
+  <affected-histogram name="Prerender.PerceivedTTFCPRecorded.Hidden"/>
+  <affected-histogram name="Prerender.PerceivedTTFCPRecorded.Visible"/>
   <affected-histogram name="Prerender.PercentLoadDoneAtSwapin"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold.Cacheable.Hidden"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold.Cacheable.Visible"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold.NoStore.Hidden"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Cold.NoStore.Visible"/>
+  <affected-histogram
+      name="Prerender.PrefetchTTFCP.Reference.Cacheable.Hidden"/>
+  <affected-histogram
+      name="Prerender.PrefetchTTFCP.Reference.Cacheable.Visible"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Reference.NoStore.Hidden"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Reference.NoStore.Visible"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm.Cacheable.Hidden"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm.Cacheable.Visible"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm.NoStore.Hidden"/>
+  <affected-histogram name="Prerender.PrefetchTTFCP.Warm.NoStore.Visible"/>
   <affected-histogram name="Prerender.PrerenderNotSwappedInPLT"/>
   <affected-histogram name="Prerender.PrerendersPerSessionCount"/>
   <affected-histogram name="Prerender.SimulatedLocalBrowsingBaselinePLT"/>