Media Remoting: UMAs to track session events and measurements.

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 82b7e74c3e184504005a7f67cf59a9f8b5a6f047..bda445ef1bddfc8f76fbeb1bc963836cf4501707 100644
--- a/tools/metrics/histograms/histograms.xml
+++ b/tools/metrics/histograms/histograms.xml
@@ -25771,6 +25771,121 @@ http://cs/file:chrome/histograms.xml - but prefer this file for new entries.
   </summary>
 </histogram>
 
+<histogram name="Media.Remoting.AllowedByPage" enum="BooleanEnabled">
+  <owner>miu@chromium.org</owner>
+  <summary>Tracks whether a web page allows content to be remoted.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.AudioBitrate" units="kbps">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Measured audio content transfer bitrate while remoting content.

[xjz, 2017/01/17 05:36:25]

nit: Measured/Estimated or Measures?

[miu, 2017/01/17 21:09:23]

Well, it *is* the measured rate. :) Sure, it's also estimated, but that's
implied by "measurement error."

+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.AudioChannelLayout" enum="ChannelLayout">
+  <owner>miu@chromium.org</owner>
+  <summary>Audio channel layout used while remoting content.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.AudioCodec" enum="AudioCodec">
+  <owner>miu@chromium.org</owner>
+  <summary>Audio codec used while remoting content.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.AudioSamplesPerSecond" enum="AudioSampleRate">
+  <owner>miu@chromium.org</owner>
+  <summary>Audio sampling rate while remoting audio content.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.AudioSamplesPerSecondUnexpected" units="Hz">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Audio sampling rate while remoting audio content (atypical values, in Hz).
+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.PosterDownloadDuration.Fail" units="ms">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Measures the amount of time it took to ultimately fail to download a poster
+    image for an HTML5 video while remoting content.
+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.PosterDownloadDuration.Success" units="ms">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Measures the amount of time it took to successfully download a poster image
+    for an HTML5 video while remoting content.
+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.SessionDuration" units="ms">
+  <owner>miu@chromium.org</owner>
+  <summary>Measures the duration of each remoting session.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.SessionStartTrigger"
+    enum="RemotingStartTrigger">
+  <owner>miu@chromium.org</owner>
+  <summary>Tracks the trigger for starting a remoting session.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.SessionStopTrigger" enum="RemotingStopTrigger">
+  <owner>miu@chromium.org</owner>
+  <summary>Tracks the trigger for stopping a remoting session.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.TimeUntilFirstPlayout" units="ms">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Measures how long, from the start of a remoting session, until content began
+    playing out on the remote device.
+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.TimeUntilRemoteInitialized" units="ms">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Measures how long, from the start of a remoting session, until a message was
+    received from the the remote device indicating initialization succeeded.

[xjz, 2017/01/17 05:36:25]

s/the the/the

[miu, 2017/01/17 21:09:22]

Done.

+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.TrackConfiguration"
+    enum="RemotingTrackConfiguration">
+  <owner>miu@chromium.org</owner>
+  <summary>Tracks whether audio or video or both are remoted.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.VideoAspectRatio" units="%">
+  <owner>miu@chromium.org</owner>
+  <summary>Aspect ratio of video while remoting content.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.VideoBitrate" units="kbps">
+  <owner>miu@chromium.org</owner>
+  <summary>
+    Measured video content transfer bitrate while remoting content.

[xjz, 2017/01/17 05:36:25]

nit: Measured/Estimated or Measures?

[miu, 2017/01/17 21:09:21]

Acknowledged.

+  </summary>
+</histogram>
+
+<histogram name="Media.Remoting.VideoCodec" enum="VideoCodec">
+  <owner>miu@chromium.org</owner>
+  <summary>Video codec used while remoting content.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.VideoCodecProfile" enum="VideoCodecProfile">
+  <owner>miu@chromium.org</owner>
+  <summary>Video codec profile used while remoting content.</summary>
+</histogram>
+
+<histogram name="Media.Remoting.VideoNaturalWidth" units="pixels">
+  <owner>miu@chromium.org</owner>
+  <summary>Video width while remoting content.</summary>
+</histogram>
+
 <histogram name="Media.RTCVideoDecoderError" enum="VideoDecodeAcceleratorError">
   <owner>posciak@chromium.org</owner>
   <summary>Counts of video decode errors reported to RTCVideoDecoder.</summary>
@@ -102259,6 +102374,46 @@ value.
   <int value="6" label="Unknown media type"/>
 </enum>
 
+<enum name="RemotingStartTrigger" type="int">
+  <int value="0" label="Unknown start trigger"/>
+  <int value="1" label="Entered fullscreen"/>
+  <int value="2" label="Became dominant content"/>
+  <int value="3" label="Re-allowed by page"/>
+  <int value="4" label="Sink available"/>
+  <int value="5" label="Play command"/>
+  <int value="6" label="Supported audio codec"/>
+  <int value="7" label="Supported video codec"/>
+  <int value="8" label="CDM ready"/>
+</enum>
+
+<enum name="RemotingStopTrigger" type="int">
+  <int value="0" label="Unknown stop trigger"/>
+  <int value="1" label="Route terminated"/>
+  <int value="2" label="Media element destroyed"/>
+  <int value="3" label="Exited fullscreen"/>
+  <int value="4" label="Became auxiliary content"/>
+  <int value="5" label="Disallowed by page"/>
+  <int value="6" label="Start race"/>
+  <int value="7" label="Unsupported audio codec"/>
+  <int value="8" label="Unsupported video codec"/>
+  <int value="9" label="Decryption/CDM error"/>
+  <int value="10" label="Receiver initialize failed"/>
+  <int value="11" label="Receiver pipeline error"/>
+  <int value="12" label="Frame drop rate high"/>
+  <int value="13" label="Pacing too slowly"/>
+  <int value="14" label="Peers out-of-sync"/>
+  <int value="15" label="RPC invalid"/>
+  <int value="16" label="Data pipe create error"/>
+  <int value="17" label="Mojo pipe error"/>
+</enum>
+
+<enum name="RemotingTrackConfiguration" type="int">
+  <int value="0" label="None"/>
+  <int value="1" label="Audio only"/>
+  <int value="2" label="Video only"/>
+  <int value="3" label="Audio and video"/>
+</enum>
+
 <enum name="RendererSchedulerTaskQueueType" type="int">
   <int value="0" label="Control"/>
   <int value="1" label="Default"/>