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 af76124e3f2389866917674958835fb385c08e5d..41470336f9a7b8306f0f188bbb73cbed702f1a0a 100644
--- a/tools/metrics/histograms/histograms.xml
+++ b/tools/metrics/histograms/histograms.xml
@@ -29824,6 +29824,18 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram name="MobileOmnibox.PressedClipboardSuggestionAge" units="ms">
+  <owner>jif@chromium.org</owner>
+  <owner>mpearson@chromium.org</owner>
+  <summary>
+    When a user presses an omnibox suggestion based on the content of the
+    clipboard, this histograms records how long ago Chrome detected a change in
+    the clipboard.

[Ilya Sherman, 2017/04/05 21:53:23]

It might be helpful to document what's recorded if Chrome never detected a
change (or to otherwise clarify what the default/initial state is).

[Mark P, 2017/04/05 22:08:28]

Good idea.  Clarified both.

+
+    Intended to be compared to Omnibox.ClipboardSuggestionShownAge.
+  </summary>
+</histogram>
+
 <histogram name="MobileStartup.MainIntentAction" enum="MobileStartingAction">
   <owner>mariakhomenko@chromium.org</owner>
   <summary>
@@ -44341,6 +44353,20 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram name="Omnibox.ClipboardSuggestionShownAge" units="ms">
+  <owner>mpearson@chromium.org</owner>
+  <summary>
+    Recorded every time the omnibox is focussed and a recent URL from the user's
+    clipboard is suggested.  The value indicates the estimated age of the
+    clipboard.  (If Chrome observed the clipboard modification, this age is
+    exact.  If Chrome did not observe the modification, then it's a conservative
+    estimate: the last time Chrome observed a clipboard modification, which is
+    certainly older than the current clipboard.)
+
+    Intended to be compared with MobileOmnibox.PressedClipboardSuggestionAge.
+  </summary>
+</histogram>
+
 <histogram name="Omnibox.ClipboardSuggestionShownWithCurrentURL"
     enum="BooleanPresent">
   <owner>mpearson@chromium.org</owner>