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 796cb715e2fb1c1702964b8e1f0872c3ede5a8b1..05d29d91afcee2d0293d0e1d4edf40e262e44c7a 100644
--- a/tools/metrics/histograms/histograms.xml
+++ b/tools/metrics/histograms/histograms.xml
@@ -44495,6 +44495,54 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram
+    name="Omnibox.SuggestionUsed.Search.Experimental.ForegroundToFirstMeaningfulPaint.Prerender"
+    units="ms">
+  <summary>
+    Metrics of the time from page first showing up at foreground to first

[Mark P, 2017/03/29 23:17:07]

minor rephrasings through out, let me know what you think:
Measures the time from the page first appearing in the foreground to its first
meaningful paint. Only recorded on navigations that used a prerender that was to
a search query suggestion selected from the omnibox.

[lpy, 2017/03/31 20:42:03]

Done.

+    meaningful paint when pages were prerendered and from users selecting a
+    search query suggestion from omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.Search.Experimental.NavigationToFirstMeaningfulPaint"
+    units="ms">
+  <summary>
+    Metrics of the time from navigation to first meaningful paint from pages

[Mark P, 2017/03/29 23:17:07]

perhaps (if this correct?  I don't understand the original description means by
saying "from navigation")
Measures the time from the user selecting a suggestion in the omnibox to the
resulting page's first meaningful paint.  Only recorded for search query
suggestion selected from the omnibox.

[lpy, 2017/03/31 20:42:03]

It means from navigation starts. I rephrase it a little bit.

[Bryan McQuade, 2017/04/03 19:34:34]

Right, for better or for worse, page load metrics (both chrome's page load
metrics infra, as well as public metrics APIs exposed to web developers) are
baselined at 'navigation start' which is more or less the time that the
navigation was initiated. In the case of prerender, this can be long before the
user perceived time when they initiated the navigation. Since so much of the
existing page load metrics infra baselines at navigation_start, we continue to
use 'NavigationTo...' as the baseline except for cases where a prerender is
involved, since in those cases, the user perceived delay starts at first
foreground. Hope that helps to give a little more explanation for the subtleties
in baseline times between these histograms.

[Mark P, 2017/04/03 23:19:15]

Thanks for the explanation.  Now I know to mainly look at ForegroundTo for my
purposes.

+    where users select a search query suggestion from omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.Search.ForegroundToFirstContentfulPaint.Prerender"
+    units="ms">
+  <summary>
+    Metrics of the time from page first showing up at foreground to first

[Mark P, 2017/03/29 23:17:07]

Please use the top comment above (possibly with your revisions), then making the
analogous description here.

[lpy, 2017/03/31 20:42:03]

Done.

+    contentful paint when pages were prerendered and from users selecting a
+    search query suggestion from omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.Search.NavigationToFirstContentfulPaint"
+    units="ms">
+  <summary>
+    Metrics of the time from navigation to first contentful paint from pages

[Mark P, 2017/03/29 23:17:07]

Please use the second comment above (possibly with your revisions), then making
the analogous description here.

[lpy, 2017/03/31 20:42:03]

Done.

+    where users select a search query suggestion from omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.Search.NavigationToFirstForeground.Prerender"
+    units="ms">
+  <summary>
+    Metrics of the time from page being loaded in prerender to page first

[Mark P, 2017/03/29 23:17:07]

Again, minor edits suggested:
Measures the time from a page being loaded in prerender to it first showing up
at foreground.  Only recorded on navigations that used a prerender that was to a
search query suggestion selected from the omnibox.
(second sentence is the same as suggested in the first description above)

[lpy, 2017/03/31 20:42:03]

Done.

+    showing up at foreground where pages were from users selecting a search
+    query suggestion from omnibox.
+  </summary>
+</histogram>
+
 <histogram name="Omnibox.SuggestionUsed.SearchVsUrl"
     enum="OmniboxSummarizedResultType">
   <owner>mpearson@google.com</owner>
@@ -44504,6 +44552,53 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram

[Mark P, 2017/03/29 23:17:07]

Below:
analogous descriptions above, just with URL (capitalized) instead of "search
query"

[lpy, 2017/03/31 20:42:03]

Done.

+    name="Omnibox.SuggestionUsed.URL.Experimental.ForegroundToFirstMeaningfulPaint.Prerender"
+    units="ms">
+  <summary>
+    Metrics of the time from page first showing up at foreground to first
+    meaningful paint when pages were prerendered and from users selecting a url
+    suggestion in omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.URL.Experimental.NavigationToFirstMeaningfulPaint"
+    units="ms">
+  <summary>
+    Metrics of the time from navigation to first meaningful paint from pages
+    where users select a url suggestion in omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.URL.ForegroundToFirstContentfulPaint.Prerender"
+    units="ms">
+  <summary>
+    Metrics of the time from page first showing up at foreground to first
+    contentful paint when pages were prerendered and from users selecting a url
+    suggestion in omnibox.
+  </summary>
+</histogram>
+
+<histogram name="Omnibox.SuggestionUsed.URL.NavigationToFirstContentfulPaint"
+    units="ms">
+  <summary>
+    Metrics of the time from navigation to first contentful paint from pages
+    where users select a url suggestion in omnibox.
+  </summary>
+</histogram>
+
+<histogram
+    name="Omnibox.SuggestionUsed.URL.NavigationToFirstForeground.Prerender"
+    units="ms">
+  <summary>
+    Metrics of the time from page being navigated to in prerender to page first
+    showing up at foreground where pages were from users selecting a url
+    suggestion from omnibox.
+  </summary>
+</histogram>
+
 <histogram name="Omnibox.SuggestRequest.Failure.GoogleResponseTime" units="ms">
   <owner>mpearson@chromium.org</owner>
   <summary>