ukm.xml

<!--
Copyright 2017 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.
-->

<!--
This file is used to generate a comprehensive list of Chrome UKM metrics
along with a detailed description for each metric.

See the following doc for details on how to add entries to this file:
https://chromium.googlesource.com/chromium/src.git/+/master/services/metrics/ukm_api.md

Events may be marked with the attribute singular="True" to indicate that
the event will only occur once per source, and multiple entries will just
be describing additional metrics about the same event.
-->

<ukm-configuration>

<event name="AbusiveExperienceHeuristic">
  <owner>csharrison@chromium.org</owner>
  <owner>yaoxia@chromium.org</owner>
  <summary>
    Obsolete. Various metrics recording experiences which are commonly used for
    abusive purposes.
  </summary>
  <metric name="DidTabUnder">
    <summary>
      True if the page attempted a tab-under navigation.
    </summary>
  </metric>
  <metric name="DidWindowOpenFromAdScript">
    <summary>
      True if the page called window.open with an ad script in the stack.
    </summary>
  </metric>
  <metric name="DidWindowOpenFromAdSubframe">
    <summary>
      True if the page called window.open() from an ad subframe.
    </summary>
  </metric>
</event>

<event name="AbusiveExperienceHeuristic.JavaScriptDialog">
  <owner>yaoxia@chromium.org</owner>
  <metric name="DismissalCause">
    <summary>
      An enum that specifies the dismissal reason for JavaScript popup dialog
      that can be triggered by window.alert(), window.confirm() or
      window.prompt(). See JavaScriptDialogTabHelper::DismissalCause for the
      enum elements.
    </summary>
  </metric>
</event>

<event name="AbusiveExperienceHeuristic.TabUnder">
  <owner>csharrison@chromium.org</owner>
  <metric name="DidTabUnder">
    <summary>
      True if the page attempted a tab-under navigation.
    </summary>
  </metric>
</event>

<event name="AbusiveExperienceHeuristic.WindowOpen">
  <owner>yaoxia@chromium.org</owner>
  <summary>
    Recorded whenever window.open() is called when AdTagging is enabled.
  </summary>
  <metric name="FromAdScript">
    <summary>
      True if the page called window.open() with an ad script in the stack.
    </summary>
  </metric>
  <metric name="FromAdSubframe">
    <summary>
      True if the page called window.open() from an ad subframe.
    </summary>
  </metric>
</event>

<event name="AdFrameLoad">
  <owner>johnidel@chromium.org</owner>
  <owner>jkarlin@chromium.org</owner>
  <summary>
    Records metrics associated with a single ad frame for a page load. An ad
    frame includes itself and all of its child frames. Only recorded for frames
    with non-zero bytes. Recorded when a page is destroyed or when the app is
    backgrounded on mobile.
  </summary>
  <metric name="CpuTime.PeakWindowedPercent">
    <summary>
      The peak percentage of CPU utilization attributed to the frame in any 30
      second window prior to user activation. Frames that exist for less than 30
      seconds still use 30 seconds as the denominator for the calculation.
    </summary>
  </metric>
  <metric name="CpuTime.PreActivation">
    <summary>
      Wall time of tasks attributed to the frame after the frame recieved user
      activation. Measured in millseconds.
    </summary>
  </metric>
  <metric name="CpuTime.Total">
    <summary>
      Total wall time of tasks attributed to the frame. Measured in
      milliseconds.
    </summary>
  </metric>
  <metric name="FrameDepth">
    <summary>
      The depth of this frame's frame tree. There is no set limit on a frame's
      maximum depth.
    </summary>
  </metric>
  <metric name="Loading.CacheBytes">
    <obsolete>
      Deprecated 09/2019. Replaced with Loading.CacheBytes2.
    </obsolete>
    <summary>
      Bytes loaded from the cache for all resources loaded within the frame.
      This is rounded down to the nearest exponential bucket (with a bucket
      ratio of 1.3).
    </summary>
  </metric>
  <metric name="Loading.CacheBytes2">
    <summary>
      Bytes loaded from the cache for all resources loaded within the frame.
      This includes bytes loaded from both the HTTP cache and memory cache. This
      is rounded down to the nearest exponential bucket (with a bucket ratio of
      1.3).
    </summary>
  </metric>
  <metric name="Loading.ImageBytes">
    <summary>
      Network bytes loaded for resources with an image mime type within the
      frame. Includes header bytes. This is rounded down to the nearest
      exponential bucket (with a bucket ratio of 1.3).
    </summary>
  </metric>
  <metric name="Loading.JavascriptBytes">
    <summary>
      Network bytes loaded for resources with a javascript mime type within the
      frame. Includes header bytes. This is rounded down to the nearest
      exponential bucket (with a bucket ratio of 1.3).
    </summary>
  </metric>
  <metric name="Loading.NetworkBytes">
    <summary>
      Network bytes loaded for all resources within the frame. Includes header
      bytes. This is rounded down to the nearest exponential bucket (with a
      bucket ratio of 1.3).
    </summary>
  </metric>
  <metric name="Loading.NumResources">
    <summary>
      Total number of resources loaded by the frame, including incomplete
      resources.
    </summary>
  </metric>
  <metric name="Loading.VideoBytes">
    <summary>
      Network bytes loaded for resources with a video/ mime type within the
      frame. Includes header bytes. This is rounded down to the nearest
      exponential bucket (with a bucket ratio of 1.3).
    </summary>
  </metric>
  <metric name="Status.CrossOrigin">
    <summary>
      An enum representing whether the frame was Cross-Origin or Same-Origin to
      it's parent frame. See FrameData::OriginStatus.
    </summary>
  </metric>
  <metric name="Status.Media">
    <summary>
      An enum representing whether media was played in the frame. See
      FrameData::MediaStatus.
    </summary>
  </metric>
  <metric name="Status.UserActivation">
    <summary>
      An enum representing whether the frame received user activation. See
      FrameData::UserActivationStatus.
    </summary>
  </metric>
  <metric name="Timing.FirstContentfulPaint">
    <summary>
      Number of milliseconds before FirstContentfulpaint was reached in the
      frame. This is relative to subframe navigation start.
    </summary>
  </metric>
  <metric name="Timing.Interactive">
    <summary>
      Number of millseconds before Time-To-Interactive was reached in the frame.
      This is relative to subframe navigation start.
    </summary>
  </metric>
  <metric name="Timing.PreActivationForegroundDuration">
    <summary>
      Number of millseconds that the current web contents spent in the
      foreground prior to the frame receiving user activation.
    </summary>
  </metric>
  <metric name="Visibility.FrameHeight">
    <summary>
      Last known height of the iframe in pixels. Not reported accurately when
      &quot;Visiblity.Hidden&quot; is true. This is rounded down to the nearest
      exponential bucket (with a bucket ratio of 1.15).
    </summary>
  </metric>
  <metric name="Visibility.FrameWidth">
    <summary>
      Last known width of the iframe in pixels. Not reported accurately when
      &quot;Visiblity.Hidden&quot; is true. This is rounded down to the nearest
      exponential bucket (with a bucket ratio of 1.15).
    </summary>
  </metric>
  <metric name="Visibility.Hidden">
    <summary>
      A 0 or 1 values representing whether the frame had a display=none styling
      set. Records the last known value.
    </summary>
  </metric>
</event>

<event name="AdPageLoad" singular="True">
  <owner>johnidel@chromium.org</owner>
  <owner>jkarlin@chromium.org</owner>
  <summary>
    Recorded when a page has loadded non-zero ad bytes, and the page is being
    destroyed/navigated.
  </summary>
  <metric name="AdBytes">
    <summary>
      Amount of network bytes used to load ad resource on the page. Includes
      resources that did not finish, and top-level ads. Measured in kilobytes.
    </summary>
  </metric>
  <metric name="AdBytesPerSecond">
    <summary>
      Amount of network bytes used to load ad resources on the page, per second
      the page was alive after commit. Measured in kilobytes per second.
    </summary>
  </metric>
  <metric name="AdBytesPerSecondAfterInteractive">
    <summary>
      Amount of network bytes used to load ad resources on the page per second
      after the page was interactive. Measured in kilobytes.
    </summary>
  </metric>
  <metric name="AdCpuTime">
    <summary>
      Amount of CPU wall time inside of ad iframes over the duration of a page
      load, while the page is in the foreground. Measured in milliseconds.
    </summary>
  </metric>
  <metric name="AdJavascriptBytes">
    <summary>
      Amount of network bytes used to load ad resources with a supported
      javascript mime type on the page. Measured in kilobytes.
    </summary>
  </metric>
  <metric name="AdVideoBytes">
    <summary>
      Amount of network bytes used to load ad resources with a video mime type
      on the page. Measured in kilobytes.
    </summary>
  </metric>
  <metric name="MainframeAdBytes">
    <summary>
      Amount of network bytes used to load ad resources in the main frame.
      Includes resources that did not finish but does not include resources in
      subframes. Measured in bytes. This is rounded to the nearest exponential
      bucket (with a bucket ratio of 1.3).
    </summary>
  </metric>
  <metric name="TotalBytes">
    <summary>
      Amount of network bytes used to load resources on the page. Includes
      resources that did not finish. Measured in kilobytes.
    </summary>
  </metric>
</event>

<event name="AmpPageLoad" singular="True">
  <owner>sullivan@chromium.org</owner>
  <metric name="MainFrameAmpPageLoad">
    <summary>
      True if the page loaded in the main frame is an AMP document (has an amp
      attribute in the html element). Will not be recorded for non-AMP frames.
      Note that most AMP documents are loaded in a subframe from a reader like
      Google Search; this metric measures sites that are using AMP as a
      site-wide framework and not a reader experience.
    </summary>
  </metric>
  <metric name="SubFrame.InteractiveTiming.FirstInputDelay3">
    <obsolete>
      Removed July 2019 in favor of FirstInputDelay4.
    </obsolete>
    <summary>
      Measures First Input Delay, the duration between the hardware timestamp
      and the start of event processing on the main thread for the first
      meaningful input per navigation, in the AMP subframe. See
      https://goo.gl/tr1oTZ for a detailed explanation. In milliseconds.
    </summary>
  </metric>
  <metric name="SubFrame.InteractiveTiming.FirstInputDelay4">
    <summary>
      Measures First Input Delay, the duration between the hardware timestamp
      and the start of event processing on the main thread for the first
      meaningful input per navigation, in the AMP subframe. See
      https://goo.gl/tr1oTZ for a detailed explanation. In milliseconds.
    </summary>
  </metric>
  <metric name="SubFrame.LayoutInstability.CumulativeShiftScore">
    <summary>
      Measures the cumulative layout shift (bit.ly/lsm-explainer) that has
      occurred during the session, in the AMP subframe. This metric's integral
      value is 100x the fractional cumulative layout shift score described in
      the explainer.
    </summary>
  </metric>
  <metric
      name="SubFrame.LayoutInstability.CumulativeShiftScore.BeforeInputOrScroll">
    <summary>
      Measures the cumulative layout shift (bit.ly/lsm-explainer) that has
      occurred in the AMP subframe, before any user input or document scroll.
      This metric's integral value is 100x the fractional cumulative layout
      shift score described in the explainer.
    </summary>
  </metric>
  <metric name="SubFrame.LayoutStability.JankScore">
    <obsolete>
      Removed July 2019 in favor of
      SubFrame.LayoutInstability.CumulativeShiftScore.
    </obsolete>
    <summary>
      Measures the amount of layout jank (bit.ly/lsm-explainer) that has
      occurred during the session, in the AMP subframe. This metric's integral
      value is 100x the fractional jank score described in the explainer.
    </summary>
  </metric>
  <metric name="SubFrame.MainFrameToSubFrameNavigationDelta">
    <summary>
      Measures the time in milliseconds from the navigation in the main frame to
      the navigation in the AMP subframe. Will be negative in cases where the
      AMP subframe was prerendered. Will be positive in cases where the main
      frame was a non-same-document navigation. Should be near-zero when the
      main frame navigation is a same-document navigation and the AMP subframe
      was not prerendered.
    </summary>
  </metric>
  <metric name="SubFrame.PaintTiming.NavigationToFirstContentfulPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints content, in the AMP subframe.
      A contentful paint includes a paint of text, image, SVG, or canvas.
    </summary>
  </metric>
  <metric name="SubFrame.PaintTiming.NavigationToLargestContentfulPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest content (text or
      image) within viewport, in the AMP subframe. See
      http://bit.ly/largest_contentful_paint_explainer for more details.
    </summary>
  </metric>
  <metric name="SubFrame.PaintTiming.NavigationToLargestContentPaint">
    <obsolete>
      Deprecated 7/2019
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest content (text or
      image) within viewport, in the AMP subframe. See
      http://bit.ly/largest_contentful_paint_explainer for more details.
    </summary>
  </metric>
  <metric name="SubFrameAmpPageLoad">
    <summary>
      True if the page loaded in any subframe is an AMP document (has an amp
      attribute in the html element). Will not be recorded for non-AMP frames.
      Note that most AMP documents are loaded in a subframe from a reader like
      Google Search; this metric measures usage of such readers.
    </summary>
  </metric>
</event>

<event name="AppListAppClickData">
  <owner>pdyson@chromium.org</owner>
  <summary>
    AppListAppClickData events contain click history metrics for an app. These
    events are recorded when an app is launched from the launcher on ChromeOS,
    but may be for an app different from the app launched. See event
    AppListAppLaunch for more detail on the keys used.
  </summary>
  <metric name="AppLaunchId">
    <summary>
      The ID of the app launch event.
    </summary>
  </metric>
  <metric name="AppType">
    <summary>
      The type of app. 1: CHROME, 2: PLAY, 3: PWA/Bookmark app.
    </summary>
  </metric>
  <metric name="ClickRank">
    <summary>
      Rank apps by total number of clicks. The app with the most clicks has rank
      1.
    </summary>
  </metric>
  <metric name="ClicksEachHour00">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 12:00am and 1:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour01">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 1:00am and 2:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour02">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 2:00am and 3:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour03">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 3:00am and 4:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour04">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 4:00am and 5:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour05">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 5:00am and 6:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour06">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 6:00am and 7:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour07">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 7:00am and 8:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour08">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 8:00am and 9:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour09">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 9:00am and 10:00am. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour10">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 10:00am and 11:00am. Bucketing: values above 20 rounded down to
      the nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour11">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 11:00am and 12:00pm. Bucketing: values above 20 rounded down to
      the nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour12">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 12:00pm and 1:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour13">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 1:00pm and 2:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour14">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 2:00pm and 3:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour15">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 3:00pm and 4:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour16">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 4:00pm and 5:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour17">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 5:00pm and 6:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour18">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 6:00pm and 7:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour19">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 7:00pm and 8:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour20">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 8:00pm and 9:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour21">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 9:00pm and 10:00pm. Bucketing: values above 20 rounded down to the
      nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour22">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 10:00pm and 11:00pm. Bucketing: values above 20 rounded down to
      the nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksEachHour23">
    <summary>
      The number of clicks on this app in the current session that occurred
      between 11:00pm and 12:00am. Bucketing: values above 20 rounded down to
      the nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksLast24Hours">
    <summary>
      The number of clicks on this app in the last 24 hours. Accurate to 15
      minutes. Bucketing: values above 20 rounded down to the nearest 10.
      Maximum value of 200.
    </summary>
  </metric>
  <metric name="ClicksLastHour">
    <summary>
      The number of clicks on this app in the last hour. Accurate to one minute.
      Bucketing: values above 20 rounded down to the nearest 10. Maximum value
      of 200.
    </summary>
  </metric>
  <metric name="LastLaunchedFrom">
    <summary>
      Where the app was last launched from. 1: GRID, 2: SUGGESTED, 3: SHELF.
    </summary>
  </metric>
  <metric name="MostRecentlyUsedIndex">
    <summary>
      Index recording when in the sequence of app launch clicks the app was last
      clicked on. 0: most recent app clicked on, 1: app clicked immediately
      before the most recent, etc.
    </summary>
  </metric>
  <metric name="SequenceNumber">
    <summary>
      The sequence number of the AppListAppLaunch event that corresponds to this
      AppListAppClickData event. There will be six AppListAppClickData events
      for each sequence number.
    </summary>
  </metric>
  <metric name="TimeSinceLastClick">
    <summary>
      Time since this app was last clicked on to launch. In seconds, bucketed:
      [1, 59] to the nearest second, [60, 599] to the nearest minute, [600,
      1199] to the nearest 5 minutes, [1200, 3599] to the nearest 10 minutes,
      [3600, 17999] to the nearest 30 minutes, [18000, 86400] to the nearest
      hour.
    </summary>
  </metric>
  <metric name="TotalClicks">
    <summary>
      Total number of clicks launching this app in this sesion. Bucketing:
      values above 20 rounded down to the nearest 10. Maximum value of 200.
    </summary>
  </metric>
</event>

<event name="AppListAppLaunch">
  <owner>pdyson@chromium.org</owner>
  <summary>
    Recorded when an app is launched from the launcher on ChromeOS. This can be
    from the suggestion chip, or from the grid of apps. The UKM metrics are not
    keyed by navigational urls. Instead, for Chrome apps the keys are based upon
    the app id, for Play apps the keys are based upon a hash of the package name
    and for PWAs and bookmark apps the keys are the urls associated with the
    PWA/bookmark.
  </summary>
  <metric name="AllClicksLast24Hours">
    <summary>
      Total number of clicks launching logged apps in the last 24 hours.
      Accurate to the nearest 15 minutes. Bucketing: values above 20 rounded
      down to the nearest 10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="AllClicksLastHour">
    <summary>
      Total number of clicks launching logged apps in the last hour. Accurate to
      the nearest minute. Bucketing: values above 20 rounded down to the nearest
      10. Maximum value of 200.
    </summary>
  </metric>
  <metric name="AppType">
    <summary>
      The type of app. 1: CHROME, 2: PLAY, 3: PWA/Bookmark app.
    </summary>
  </metric>
  <metric name="ClickMethod">
    <summary>
      Click method. 1: MOUSE, 2: TOUCH, 3: SYTLUS, 4: KEYBOARD.
    </summary>
  </metric>
  <metric name="DayOfWeek">
    <summary>
      An enum representing the day of the week that the data was logged in the
      local time zone. Sunday = 0.
    </summary>
  </metric>
  <metric name="DeviceMode">
    <summary>
      The mode of the device. 1: CLOSED_LID (Lid is closed), 2: LAPTOP (Lid is
      open, tablet mode off or unsupported) , 3: TABLET (Lid is open, tablet
      mode on or no lid at all).
    </summary>
  </metric>
  <metric name="DeviceType">
    <summary>
      The type of the device. 1: TABLET, 2: LAPTOP.
    </summary>
  </metric>
  <metric name="HourOfDay">
    <summary>
      The hour of the day when the data is logged. Hours since midnight in the
      local time zone.
    </summary>
  </metric>
  <metric name="LaunchedFrom">
    <summary>
      Where the app was launched from. 1: GRID, 2: SUGGESTED, 3: SHELF.
    </summary>
  </metric>
  <metric name="PositionIndex">
    <summary>
      The position of the app within the grid/suggested apps/shelf. 0 is the
      first position.
    </summary>
  </metric>
  <metric name="TotalHours">
    <summary>
      Number of hours in the current session up to this event. Bucketing:
      exponential buckets, increasing in size by 25%, rounded to the nearest
      integer. i.e. 0, 1, 2, 3, 4, 5, 6, 7, 9, 12, 15, 18, 23, 28, 36, 44...
    </summary>
  </metric>
</event>

<event name="AppListNonAppImpression">
  <owner>jiameng@chromium.org</owner>
  <owner>thanhdng@chromium.org</owner>
  <owner>tby@chromium.org</owner>
  <summary>
    Records details of impressions and launches of non-apps in the ChromeOS
    launcher, such as files, omnibox results, and answer cards.
  </summary>
  <metric name="Category" enum="AppListNonAppImpressionCategory">
    <summary>
      The kind of launcher item. Corresponds to the value of
      ChromeSearchResult::result_[sub]type.
    </summary>
  </metric>
  <metric name="DayOfWeek">
    <summary>
      The day of the week that the event was logged on, in the local time zone.
      Sunday is 0.
    </summary>
  </metric>
  <metric name="DeviceMode" enum="AppListNonAppImpressionDeviceMode">
    <summary>
      The mode of the device.
    </summary>
  </metric>
  <metric name="EventId">
    <summary>
      An ID linking together events within a single set of launcher search
      results. One of these may be a launch, and the rest impressions.
    </summary>
  </metric>
  <metric name="FileExtension" enum="AppListNonAppImpressionFileExtension">
    <summary>
      An enum representing the file extension if this event represents a local
      or DriveFS file.
    </summary>
  </metric>
  <metric name="HourOfDay">
    <summary>
      The hour of the day that the event was logged in. Hours measured from
      midnight in the local timezone.
    </summary>
  </metric>
  <metric name="IsLaunched" enum="Boolean">
    <summary>
      True if the item represented by this event was launched, false otherwise.
    </summary>
  </metric>
  <metric name="LaunchesAtHour00">
    <summary>
      The number of launches within the last 24 hours at hour 0. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour01">
    <summary>
      The number of launches within the last 24 hours at hour 1. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour02">
    <summary>
      The number of launches within the last 24 hours at hour 2. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour03">
    <summary>
      The number of launches within the last 24 hours at hour 3. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour04">
    <summary>
      The number of launches within the last 24 hours at hour 4. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour05">
    <summary>
      The number of launches within the last 24 hours at hour 5. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour06">
    <summary>
      The number of launches within the last 24 hours at hour 6. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour07">
    <summary>
      The number of launches within the last 24 hours at hour 7. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour08">
    <summary>
      The number of launches within the last 24 hours at hour 8. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour09">
    <summary>
      The number of launches within the last 24 hours at hour 9. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour10">
    <summary>
      The number of launches within the last 24 hours at hour 10. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour11">
    <summary>
      The number of launches within the last 24 hours at hour 11. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour12">
    <summary>
      The number of launches within the last 24 hours at hour 12. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour13">
    <summary>
      The number of launches within the last 24 hours at hour 13. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour14">
    <summary>
      The number of launches within the last 24 hours at hour 14. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour15">
    <summary>
      The number of launches within the last 24 hours at hour 15. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour16">
    <summary>
      The number of launches within the last 24 hours at hour 16. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour17">
    <summary>
      The number of launches within the last 24 hours at hour 17. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour18">
    <summary>
      The number of launches within the last 24 hours at hour 18. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour19">
    <summary>
      The number of launches within the last 24 hours at hour 19. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour20">
    <summary>
      The number of launches within the last 24 hours at hour 20. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour21">
    <summary>
      The number of launches within the last 24 hours at hour 21. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour22">
    <summary>
      The number of launches within the last 24 hours at hour 22. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesAtHour23">
    <summary>
      The number of launches within the last 24 hours at hour 23. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="LaunchesThisSession">
    <summary>
      How many times this item has been launched during this session. Rounded
      down to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="Position">
    <summary>
      The index of this item in the search results list. Indices start at 0.
    </summary>
  </metric>
  <metric name="QueryLength">
    <summary>
      The length of the raw search query with whitespace trimmed. Rounded down
      to the nearest exponential bucket, with a bucket ratio of 1.15.
    </summary>
  </metric>
  <metric name="RelevanceScore">
    <summary>
      The raw relevance score returned by the relevant search provider for this
      item.
    </summary>
  </metric>
  <metric name="TimeOfLastLaunch">
    <summary>
      The hour when the previous launch of this item occurred. Hours measured
      from midnight in the local timezone. This can be any value 0-23, as the
      last launch could have been on a previous day.
    </summary>
  </metric>
  <metric name="TimeSinceLastLaunch">
    <summary>
      Seconds since this item was last launched in this session. Rounded down to
      the nearest exponential bucket, with a bucket ratio of 1.045. This makes
      the bucket at 24 hour mark approximately 1 hour long.
    </summary>
  </metric>
</event>

<event name="Autofill.CardUploadDecision">
  <owner>sebsg@chromium.org</owner>
  <metric name="UploadDecision">
    <summary>
      Whether the upload was proposed to the user or the reasons why it was not.
      The value is a bitmask of |CardUploadDecisionMetric|.
    </summary>
  </metric>
</event>

<event name="Autofill.DeveloperEngagement">
  <owner>jiahuiguo@google.com</owner>
  <summary>
    Recorded when we parse a form to log whether developer has used autocomplete
    markup or UPI-VPA hints. The value is a bitmask of
    |DeveloperEngagementMetric|.
  </summary>
  <metric name="DeveloperEngagement"/>
  <metric name="FormSignature">
    <summary>
      The signature of the form. This is the hash identifier used to denote this
      form for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="FormTypes">
    <summary>
      Type of form. Stored as bitvector. A set ith bit implies enum FormType's
      ith type was detected. Multiple types are possible.
    </summary>
  </metric>
  <metric name="IsForCreditCard">
    <summary>
      True for credit card forms, false for address/profile forms. See
      |FormStructure::IsCompleteCreditCardForm()|.
    </summary>
  </metric>
</event>

<event name="Autofill.FieldFillStatus">
  <owner>rogerm@chromium.org</owner>
  <summary>
    Recorded when Chrome validates field type predictions (on submit, on leaving
    a form, on receiving a form with autocomplete attributes).
  </summary>
  <metric name="FieldSignature">
    <summary>
      The signature of the field. This is the hash identifier used to denote
      this field for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form. This is the hash identifier used to denote this
      form for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="IsAutofilled">
    <summary>
      The field is currently autofilled.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
  </metric>
  <metric name="PredictionSource">
    <summary>
      The system which generated the prediction: heuristics, server, overall.
    </summary>
  </metric>
  <metric name="ValidationEvent">
    <summary>
      The event which triggered the validation: Submission, Left Form, Form has
      Autocomplete attributes.
    </summary>
  </metric>
  <metric name="WasPreviouslyAutofilled">
    <summary>
      The field was autofilled and subsequently edited.
    </summary>
  </metric>
</event>

<event name="Autofill.FieldTypeValidation">
  <owner>rogerm@chromium.org</owner>
  <summary>
    Recorded when Chrome validates field type predictions (on submit, on leaving
    a form, on receiving a form with autocomplete attributes).
  </summary>
  <metric name="ActualType" enum="AutofillServerFieldType">
    <summary>
      The observed type of the field. See: autofill::ServerFieldType
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="FieldSignature">
    <summary>
      The signature of the field
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.ValidationEvent"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PredictedType" enum="AutofillServerFieldType">
    <summary>
      The predicted type of the field. See: autofill::ServerFieldType
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.ActualType"/>
        <index fields="metrics.ActualType,metrics.PredictionSource"/>
        <index fields="metrics.PredictionSource"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PredictionSource" enum="AutofillPredictionSource">
    <summary>
      The system which generated the prediction: heuristics, server, overall.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.ActualType,metrics.PredictedType"/>
        <index fields="metrics.PredictedType"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ValidationEvent" enum="AutofillQualitiyMetricType">
    <summary>
      The event which triggered the validation: Submission, Left Form, Form has
      Autocomplete attributes.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="Autofill.FormEvent">
  <owner>dlkumar@google.com</owner>
  <summary>
    Recorded when user interacted with autofill.
  </summary>
  <metric name="AutofillFormEvent">
    <summary>
      Logs autofill form events funnel. See |FormEvent|.
    </summary>
  </metric>
  <metric name="FormTypes">
    <summary>
      Type of form. Stored as bitvector. A set ith bit implies enum FormType's
      ith type was detected. Multiple types are possible.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
  </metric>
</event>

<event name="Autofill.FormSubmitted">
  <owner>jiahuiguo@google.com</owner>
  <summary>
    Recorded when user submits a form.
  </summary>
  <metric name="AutofillFormSubmittedState">
    <summary>
      Whether form's fields were all autofilled, some fields were autofilled, or
      none of the field were autofilled. See |AutofillFormSubmittedState|.
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      FormSignature is approximately 10 bit hash of form structure.
    </summary>
  </metric>
  <metric name="FormTypes">
    <summary>
      Type of form. Stored as bitvector. A set ith bit implies enum FormType's
      ith type was detected. Multiple types are possible.
    </summary>
  </metric>
  <metric name="HasUpiVpaField">
    <summary>
      True for forms containing a UPI/VPA field.
    </summary>
  </metric>
  <metric name="IsForCreditCard">
    <summary>
      True for credit card forms, false for address/profile forms. See
      |FormStructure::IsCompleteCreditCardForm()|.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
  </metric>
</event>

<event name="Autofill.HiddenRepresentationalFieldSkipDecision">
  <owner>parastoog@chromium.org</owner>
  <summary>
    Recorded while trying to fill or preview a hidden or a representational
    field.
  </summary>
  <metric name="FieldOverallType">
    <summary>
      Field's overall |ServerFieldType|. See |AutofillField.GetStorableType()|.
    </summary>
  </metric>
  <metric name="FieldSignature">
    <summary>
      The signature of the field. This is the hash identifier used to denote
      this field for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="FieldTypeGroup">
    <summary>
      Field's |FieldTypeGroup|. See |AutofillType.group()|.
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form. This is the hash identifier used to denote this
      form for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="HeuristicType">
    <summary>
      Field's |ServerFieldType| based on heuristics. See
      |AutofillField.heuristic_type()|.
    </summary>
  </metric>
  <metric name="HtmlFieldMode">
    <summary>
      Whether the field's autocomplete hint specified 'billing' or 'shipping'.
      See |AutofillField.html_mode()|.
    </summary>
  </metric>
  <metric name="HtmlFieldType">
    <summary>
      Field's autocomplete field type hint. See |AutofillField.html_type()|.
    </summary>
  </metric>
  <metric name="IsSkipped">
    <summary>
      True if the field was skipped while filling or previewing the form,
      because it was hidden or representational, but not a 'select' one.
    </summary>
  </metric>
  <metric name="ServerType">
    <summary>
      Field's |ServerFieldType| returned by server. See
      |AutofillField.server_type()|.
    </summary>
  </metric>
</event>

<event name="Autofill.InteractedWithForm">
  <owner>jiahuiguo@google.com</owner>
  <summary>
    Recorded when we parse a form to log form metadata and autofill settings
    that apply to all subsequent events for this form.
  </summary>
  <metric name="FormSignature">
    <summary>
      FormSignature is approximately 10 bit hash of form structure.
    </summary>
  </metric>
  <metric name="FormTypes">
    <summary>
      Type of form. Stored as bitvector. A set ith bit implies enum FormType's
      ith type was detected. Multiple types are possible.
    </summary>
  </metric>
  <metric name="IsForCreditCard">
    <summary>
      True for credit card forms, false for address/profile forms.
    </summary>
  </metric>
  <metric name="LocalRecordTypeCount">
    <summary>
      Number of local credit cards or local autofill profiles.
    </summary>
  </metric>
  <metric name="ServerRecordTypeCount">
    <summary>
      Number of masked and full server credit cards or server autofill profiles.
    </summary>
  </metric>
</event>

<event name="Autofill.RepeatedServerTypePredictionRationalized">
  <owner>parastoog@chromium.org</owner>
  <summary>
    Recorded when a field type predicted by server is rationalized because of
    repetition.
  </summary>
  <metric name="FieldNewOverallType">
    <summary>
      Field's overall |ServerFieldType| after rationalization. See
      |AutofillField.GetStorableType()|.
    </summary>
  </metric>
  <metric name="FieldOldOverallType">
    <summary>
      Field's overall |ServerFieldType| before rationalization. See
      |AutofillField.GetStorableType()|.
    </summary>
  </metric>
  <metric name="FieldSignature">
    <summary>
      The signature of the field. This is the hash identifier used to denote
      this field for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="FieldTypeGroup">
    <summary>
      Field's |FieldTypeGroup|. See |AutofillType.group()|.
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form. This is the hash identifier used to denote this
      form for query and voting purposes. See
      components/autofill/core/common/signatures_util.cc for more details.
    </summary>
  </metric>
  <metric name="HeuristicType">
    <summary>
      Field's |ServerFieldType| based on heuristics. See
      |AutofillField.heuristic_type()|.
    </summary>
  </metric>
  <metric name="HtmlFieldMode">
    <summary>
      Whether the field's autocomplete hint specified 'billing' or 'shipping'.
      See |AutofillField.html_mode()|.
    </summary>
  </metric>
  <metric name="HtmlFieldType">
    <summary>
      Field's autocomplete field type hint. See |AutofillField.html_type()|.
    </summary>
  </metric>
  <metric name="ServerType">
    <summary>
      Field's |ServerFieldType| returned by server. See
      |AutofillField.server_type()|.
    </summary>
  </metric>
</event>

<event name="Autofill.SelectedMaskedServerCard">
  <obsolete>
    Deprecated 2/2019
  </obsolete>
  <owner>jiahuiguo@google.com</owner>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Obsolete.

      Time since form parse.
    </summary>
  </metric>
</event>

<event name="Autofill.SuggestionFilled">
  <owner>jiahuiguo@google.com</owner>
  <summary>
    Recorded when user selects a suggestion and we fill the form with that
    suggestion.
  </summary>
  <metric name="FieldSignature">
    <summary>
      The signature of the field
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form.
    </summary>
  </metric>
  <metric name="IsForCreditCard">
    <summary>
      True for credit card forms, false for address/profile forms.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
  </metric>
  <metric name="RecordType">
    <summary>
      Whether the suggestion was from a local card/autofill profile or from a
      server card/autofill profile.
    </summary>
  </metric>
</event>

<event name="Autofill.SuggestionsShown">
  <owner>jiahuiguo@google.com</owner>
  <summary>
    Recorded when a suggestion is shown to user.
  </summary>
  <metric name="FieldSignature">
    <summary>
      The signature of the field
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form.
    </summary>
  </metric>
  <metric name="HeuristicType">
    <summary>
      Field's |ServerFieldType| based on heuristics. See
      |AutofillField.heuristic_type()|.
    </summary>
  </metric>
  <metric name="HtmlFieldType">
    <summary>
      Field's autocomplete field type hint. See |AutofillField.html_type()|.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
  </metric>
  <metric name="ServerType">
    <summary>
      Field's |ServerFieldType| returned by server. See
      |AutofillField.server_type()|.
    </summary>
  </metric>
</event>

<event name="Autofill.TextFieldDidChange">
  <owner>jiahuiguo@google.com</owner>
  <summary>
    Recorded when user edits a text field. The text field may have been
    autofilled.
  </summary>
  <metric name="FieldSignature">
    <summary>
      The signature of the field
    </summary>
  </metric>
  <metric name="FieldTypeGroup">
    <summary>
      Field's |FieldTypeGroup|. See |AutofillType.group()|.
    </summary>
  </metric>
  <metric name="FormSignature">
    <summary>
      The signature of the form.
    </summary>
  </metric>
  <metric name="HeuristicType">
    <summary>
      Field's |ServerFieldType| based on heuristics. See
      |AutofillField.heuristic_type()|.
    </summary>
  </metric>
  <metric name="HtmlFieldMode">
    <summary>
      Whether the field's autocomplete hint specified 'billing' or 'shipping'.
      See |AutofillField.html_mode()|.
    </summary>
  </metric>
  <metric name="HtmlFieldType">
    <summary>
      Field's autocomplete field type hint. See |AutofillField.html_type()|.
    </summary>
  </metric>
  <metric name="IsAutofilled">
    <summary>
      True if the field was autofilled. See |AutofillField.is_autofilled|.
    </summary>
  </metric>
  <metric name="IsEmpty">
    <summary>
      True if the field was empty. See |AutofillField.IsEmpty()|.
    </summary>
  </metric>
  <metric name="MillisecondsSinceFormParsed">
    <summary>
      Time since form parse.
    </summary>
  </metric>
  <metric name="ServerType">
    <summary>
      Field's |ServerFieldType| returned by server. See
      |AutofillField.server_type()|.
    </summary>
  </metric>
</event>

<event name="BackgroundFetch">
  <owner>nator@chromium.org</owner>
  <owner>rayankans@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    A BackgroundFetch event is logged before a background fetch is started from
    a document context.
  </summary>
  <metric name="DeniedDueToPermissions">
    <summary>
      Boolean for whether the background fetch was denied due to permission.
      This includes only the content setting permission.
    </summary>
  </metric>
  <metric name="DownloadTotal">
    <summary>
      The value of downloadTotal provided with the background fetch. This is the
      number of bytes that the developer expects to be downloaded with the
      background fetch. This number is exponentially bucketed for privacy
      reasons, and uses the UKM GetExponentialBucketMin method with a value of
      2.0 for spacing.
    </summary>
  </metric>
  <metric name="HasTitle">
    <summary>
      Boolean for whether a title was provided with the background fetch.
    </summary>
  </metric>
  <metric name="NumIcons">
    <summary>
      Count of icons provided with the background fetch.
    </summary>
  </metric>
  <metric name="NumRequestsInFetch">
    <summary>
      Number of requests in the background fetch. This number is exponentially
      bucketed for privacy reasons, and uses the UKM GetExponentialBucketMin
      method with a value of 2.0 for spacing.
    </summary>
  </metric>
  <metric name="RatioOfIdealToChosenIconSize">
    <summary>
      Ratio of the ideal icon to the chosen icon size, times hundred. This will
      be set to -1 if either ideal icon size is 0, or if none of the provided
      icons are suitable.
    </summary>
  </metric>
</event>

<event name="BackgroundFetchDeletingRegistration">
  <owner>nator@chromium.org</owner>
  <owner>rayankans@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    A BackgroundFetchDeletingRegistration event is logged when a background
    fetch job is being deleted.
  </summary>
  <metric name="UserInitiatedAbort">
    <summary>
      Boolean for whether the background fetch job was cancelled from the UI.
    </summary>
  </metric>
</event>

<event name="BackgroundSyncCompleted">
  <owner>nator@chromium.org</owner>
  <owner>rayankans@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Logged when a Background Sync one-shot registration is completed.
  </summary>
  <metric name="MaxAttempts">
    <summary>
      Integer value of the maximum number of allowed retries.
    </summary>
  </metric>
  <metric name="NumAttempts">
    <summary>
      Integer value of the number of retries / sync events dispatched.
    </summary>
  </metric>
  <metric name="Status">
    <summary>
      The enum value of the completion status, defined in
      blink::ServiceWorkerStatusCode.
    </summary>
  </metric>
</event>

<event name="BackgroundSyncRegistered">
  <owner>nator@chromium.org</owner>
  <owner>rayankans@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Logged when a one-shot Background Sync registration is created.
  </summary>
  <metric name="CanFire">
    <summary>
      Boolean for whether a sync event can be immediately dispatched for this
      registration.
    </summary>
  </metric>
  <metric name="IsReregistered">
    <summary>
      Boolean for whether this is a duplicate registration.
    </summary>
  </metric>
</event>

<event name="Blink.PageLoad">
  <owner>schenney@chromium.org</owner>
  <owner>paint-dev@chromium.org</owner>
  <summary>
    The aggregated time spent in each metric's component from creation of the
    local frame view to the First Contentful Paint signal. The event is reported
    once per page load when First Contentful Paint is signaled.
  </summary>
  <metric name="Animate">
    <summary>
      The time spent in main frame animation, between navigation and First
      Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="Compositing">
    <summary>
      The time spent in main thread compositing, between navigation and First
      Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="CompositingCommit">
    <summary>
      The time spent committing main thread compositing results, between
      navigation and First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="ForcedStyleAndLayout">
    <summary>
      The time spent in forced style recalc and layouts, between navigation and
      First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="HandleInputEvents">
    <summary>
      The time spent in processing rAF-aligned input for the main frame, between
      navigation and First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="IntersectionObservation">
    <summary>
      The time spent computing intersection observer state, between navigation
      and First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="Layout">
    <summary>
      The time spent in layout document lifecycle work, between navigation and
      First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="MainFrame">
    <summary>
      The time spent in ProxyMain::BeginMainFrame, between navigation and First
      Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="Paint">
    <summary>
      The time spent in paint document lifecycle work, between navigation and
      First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="PrePaint">
    <summary>
      The time spent in pre-paint document lifecycle work, between navigation
      and First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="ProxyCommit">
    <summary>
      The time spent committing main thread to impl layer tree information,
      between navigation and First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="ScrollingCoordinator">
    <summary>
      The time spent in ScrollingCoordinator, between navigation and First
      Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="Style">
    <summary>
      The time spent in style document lifecycle work, between navigation and
      First Contentful Paint, in microseconds.
    </summary>
  </metric>
  <metric name="StyleAndLayout">
    <summary>
      The time spent in layout and style document lifecycle work, between
      navigation and First Contentful Paint, in microseconds. Will be obsolete
      in M-82.
    </summary>
  </metric>
  <metric name="UpdateLayers">
    <summary>
      The time spent in for LayerTreeHost::UpdateLayers, between navigation and
      First Contentful Paint, in microseconds.
    </summary>
  </metric>
</event>

<event name="Blink.UpdateTime">
  <owner>schenney@chromium.org</owner>
  <owner>paint-dev@chromium.org</owner>
  <summary>
    Metrics that measure various update times in Blink. This includes paint,
    compositing, and layout update times. The metrics are recorded at first
    lifecycle update and then a random frame with mean interval of 2000 frames.
  </summary>
  <metric name="Animate">
    <summary>
      The time taken for main frame animation in microseconds during the sampled
      frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Animate.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken for main frame animation in microseconds in the
      event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Animate.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken for main frame animation to the total time for the main frame. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="Animate.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken for main frame animation in microseconds in
      the event period.
    </summary>
  </metric>
  <metric name="Animate.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever used for main frame animation
      within the sample window. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="AnimatePercentage">
    <summary>
      The percentage of the main frame time used by main thread animations. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="Compositing">
    <summary>
      The time taken by the compositing phase in microseconds during the sampled
      frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Compositing.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by the compositing phase in microseconds in the
      event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Compositing.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken in the compositing phase to the total time for the main frame. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="Compositing.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken by the compositing phase in microseconds in
      the event period.
    </summary>
  </metric>
  <metric name="Compositing.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever used by the compositing phase
      within the sample window. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="CompositingCommit">
    <summary>
      The time taken by the compositing commit in microseconds during the
      sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="CompositingCommit.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by the compositing commit at the end of the blink
      lifecycle, in microseconds in the event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="CompositingCommit.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken by the compositing commit at the end of the blink lifecycle to the
      total time for the main frame. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="CompositingCommit.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken by the compositing commit at the end of the
      blink lifecycle, in microseconds in the event period.
    </summary>
  </metric>
  <metric name="CompositingCommit.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever taken by the compositing commit at
      the end of the blink lifecycle to the total time for the main frame. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="CompositingCommitPercentage">
    <summary>
      The percentage of the main frame time used by the compositing commit. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="CompositingPercentage">
    <summary>
      The percentage of the main frame time used by the compositing phase. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="ForcedStyleAndLayout">
    <summary>
      The time taken by forced style recalc and layouts in microseconds between
      the end of the last main frame update and the current sampled frame, in
      microseconds.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ForcedStyleAndLayout.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by all forced style recalcs and layouts in
      microseconds in the event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ForcedStyleAndLayout.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken by forced style recalc and layouts at the end of the blink lifecycle
      to the total time for the main frame. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="ForcedStyleAndLayout.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken by a forced style recalc and layout in
      microseconds in the event period.
    </summary>
  </metric>
  <metric name="ForcedStyleAndLayout.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever taken by forced style recalc and
      layouts at the end of the blink lifecycle to the total time for the main
      frame. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="ForcedStyleAndLayoutPercentage">
    <summary>
      The percentage of the main frame time used by forced style updates and
      layouts during the main frame update (not including time outside of the
      frame update. This metric may include time that is also included in the
      AnimatePercentage metric. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="HandleInputEvents">
    <summary>
      The time taken to process rAF-aligned input for the main frame in
      microseconds during the sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="HandleInputEvents.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken to process rAF-aligned input for the main frame in
      microseconds in the event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="HandleInputEvents.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken to process rAF-aligned input for the main frame to the total time
      for the main frame. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="HandleInputEvents.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken to process rAF-aligned input for the main
      frame in microseconds in the event period.
    </summary>
  </metric>
  <metric name="HandleInputEvents.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever taken to process rAF-aligned input
      for the main frame to the total time for the main frame. An int in the
      range [0,100].
    </summary>
  </metric>
  <metric name="HandleInputEventsPercentage">
    <summary>
      The percentage of the main frame time used in processing rAF-aligned
      input. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="IntersectionObservation">
    <summary>
      The time taken to compute intersection observer state for the main frame
      in microseconds during the sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="IntersectionObservation.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken to compute IntersectionObserver observations in
      microseconds in the event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="IntersectionObservation.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken compute IntersectionObserver observations to the total time for the
      main frame. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="IntersectionObservation.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken to compute IntersectionObserver observations
      in microseconds in the event period.
    </summary>
  </metric>
  <metric name="IntersectionObservation.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever taken to compute
      IntersectionObserver observations within the sample window. An int in the
      range [0,100].
    </summary>
  </metric>
  <metric name="IntersectionObservationPercentage">
    <summary>
      The percentage of the main frame time used in computing intersection
      observer state. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="Layout">
    <summary>
      The time taken for layout for the main frame in microseconds during the
      sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="LayoutPercentage">
    <summary>
      The percentage of the main frame time used in layout work. An int in the
      range [0,100].
    </summary>
  </metric>
  <metric name="MainFrame">
    <summary>
      The time between a BeginMainFrame and the commit of paint results for the
      sampled frame, in microseconds.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="MainFrame.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time between a BeginMainFrame and the commit of paint results,
      in microseconds.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="MainFrame.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time between a BeginMainFrame and the commit of paint
      results, in microseconds.
    </summary>
  </metric>
  <metric name="MainFrameIsBeforeFCP" enum="Boolean">
    <summary>
      True if the lifecycle update in this event occurred before FCP (First
      Contentful Paint) was registered.
    </summary>
  </metric>
  <metric name="Paint">
    <summary>
      The time taken to paint for the main frame in microseconds during the
      sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Paint.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by the paint phase in microseconds in the event
      period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Paint.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken in the paint phase to the total time for the main frame. An int in
      the range [0,100].
    </summary>
  </metric>
  <metric name="Paint.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken by the paint phase in microseconds in the
      event period.
    </summary>
  </metric>
  <metric name="Paint.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever used by the paint phase within the
      sample window. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="PaintPercentage">
    <summary>
      The percentage of the main frame time used in paint. An int in the range
      [0,100].
    </summary>
  </metric>
  <metric name="PrePaint">
    <summary>
      The time taken for pre-paint for the main frame in microseconds during the
      sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PrePaint.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by the pre-paint phase in microseconds in the event
      period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PrePaint.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken in the pre-paint phase to the total time for the main frame. An int
      in the range [0,100].
    </summary>
  </metric>
  <metric name="PrePaint.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken by the pre-paint phase in microseconds in
      the event period.
    </summary>
  </metric>
  <metric name="PrePaint.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever used by the pre-paint phase within
      the sample window. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="PrePaintPercentage">
    <summary>
      The percentage of the main frame time used in pre-paint. An int in the
      range [0,100].
    </summary>
  </metric>
  <metric name="ProxyCommit">
    <summary>
      The time taken for the proxy to commit to the impl thread in microseconds
      during the sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ProxyCommitPercentage">
    <summary>
      The percentage of the main frame time used to commit to the impl thread.
      An int in the range [0,100].
    </summary>
  </metric>
  <metric name="ScrollingCoordinator">
    <summary>
      The time taken for scrolling coordinator for the main frame in
      microseconds during the sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ScrollingCoordinator.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by the style and layout phases in microseconds in
      the event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ScrollingCoordinator.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the event period of the ratio of time taken
      to update the scrolling coordinator after painting to the total time for
      the main frame, expressed as a percentage. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="ScrollingCoordinator.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time within the event period that was used to update
      the ScrollingCoordinator after painting (in microseconds).
    </summary>
  </metric>
  <metric name="ScrollingCoordinator.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame within the event period that was used to
      update the ScrollingCoordinator after painting, expressed as a percentage.
      An int in the range [0,100].
    </summary>
  </metric>
  <metric name="ScrollingCoordinatorPercentage">
    <summary>
      The percentage of the main frame time used in scrolling coordinator. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="Style">
    <summary>
      The time taken for style update for the main frame in microseconds during
      the sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="StyleAndLayout">
    <summary>
      The time taken for style and layout for the main frame in microseconds
      during the sampled frame.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="StyleAndLayout.Average">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average time taken by the style and layout phases in microseconds in
      the event period.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="StyleAndLayout.AverageRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The average over frames within the sample window of the ratio of time
      taken to update style and layout to the total time for the main frame. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="StyleAndLayout.WorstCase">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The longest single time taken by the style and layout phases in
      microseconds in the event period.
    </summary>
  </metric>
  <metric name="StyleAndLayout.WorstCaseRatio">
    <obsolete>
      Deprecated as of 03/2019.
    </obsolete>
    <summary>
      The highest proportion of a frame ever used to compute style and layout
      within the sample window. An int in the range [0,100].
    </summary>
  </metric>
  <metric name="StyleAndLayoutPercentage">
    <summary>
      The percentage of the main frame time used in style and layout work. An
      int in the range [0,100].
    </summary>
  </metric>
  <metric name="StylePercentage">
    <summary>
      The percentage of the main frame time used in style work. An int in the
      range [0,100].
    </summary>
  </metric>
  <metric name="UpdateLayers">
    <summary>
      The time taken for LayerTreeHost::UpdateLayers in microseconds during the
      sampled frame
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="UpdateLayersPercentage">
    <summary>
      The percentage of the main frame time used by LayerTreeHost::UpdateLayers.
      An int in the range [0,100].
    </summary>
  </metric>
</event>

<event name="Blink.UseCounter">
  <owner>loonybear@chromium.org</owner>
  <summary>
    Collects data for a subset of UseCounter features. When UMA UseCounter data
    shows a behaviour that is rare but too common to blindly change. This metric
    should be used to reason about whether a breaking change is acceptable or
    not.
  </summary>
  <metric name="Feature" enum="FeatureObserver">
    <summary>
      Opt-in UseCounter feature.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="IsMainFrameFeature" enum="Boolean">
    <summary>
      Emits True(1) or False(0) to indicate whether the Feature recorded is in
      the main frame or not.
    </summary>
  </metric>
</event>

<event name="BloatedRenderer">
  <obsolete>
    Deprecated as of 03/2019.
  </obsolete>
  <owner>ulan@chromium.org</owner>
  <summary>
    Metrics related to a bloated renderer that is close to out-of-memory. They
    are recorded only if the renderer process has a single page.
  </summary>
  <metric name="V8.Heap">
    <summary>
      The total physical size of V8's heap in MB.
    </summary>
  </metric>
  <metric name="V8.Heap.AllocatedObjects">
    <summary>
      The total size of allocated on V8's heap in MB.
    </summary>
  </metric>
  <metric name="V8.Heap.Limit">
    <summary>
      The V8 heap limit in MB.
    </summary>
  </metric>
  <metric name="V8.NearV8HeapLimitHandling">
    <summary>
      An enum that specifies how the near V8 heap limit event was handled. See
      blink::NearV8HeapLimitHandling for the enum elements.
    </summary>
  </metric>
</event>

<event name="ClickInput" singular="True">
  <owner>dougarnett@chromium.org</owner>
  <summary>
    Metrics associated with user click input. In particular, captures when user
    has a burst of clicks at the same location which may be a signal of user
    unhappiness for an experiment if it differs from the baseline data for the
    site.
  </summary>
  <metric name="Experimental.ClickInputBurst">
    <summary>
      The count of the largest burst of click inputs for a page load. Only
      recorded if it meets a minimum threshold to be considered a burst.
    </summary>
  </metric>
</event>

<event name="Compositor.Rendering">
  <owner>khushalsagar@chromium.org</owner>
  <summary>
    Metrics related to rendering in the compositor.
  </summary>
  <metric name="CheckerboardedImagesCount">
    <summary>
      The number of images checker-imaged and re-rasterized on this page.
    </summary>
  </metric>
</event>

<event name="Compositor.UserInteraction">
  <owner>khushalsagar@chromium.org</owner>
  <summary>
    Metrics related to user interaction handled by the compositor. This includes
    user gestures like scrolling, pinch-zoom and page-scale animations triggered
    in response to a double-tap event. The length of the user interaction is
    defined as the time the compositor is running an animation resulting from
    user input.
  </summary>
  <metric name="CheckerboardedContentArea">
    <summary>
      The number of visible pixels per frame checkerboarded during this
      interaction.
    </summary>
  </metric>
  <metric name="CheckerboardedContentAreaRatio">
    <summary>
      The percentage of visible pixels per frame checkerboarded during this
      interaction. This value should be between [0, 100].
    </summary>
  </metric>
  <metric name="CheckerboardedImagesCount">
    <summary>
      The number of images checker-imaged and re-rasterized during this
      interaction.
    </summary>
  </metric>
  <metric name="NumMissingTiles">
    <summary>
      The number of visible tiles per frame checkerboarded during this
      interaction.
    </summary>
  </metric>
</event>

<event name="ContactsPicker.ShareStatistics">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Measures statistics about the contacts shared in the contacts picker (when
    the Contacts Picker dialog is dismissed.)
  </summary>
  <metric name="PropertiesRequested">
    <summary>
      Measures the contact properties requested by the website (names, emails,
      telephone numbers). Bit 1 - telephone numbers, bit 2 - emails, bit 3 -
      names.
    </summary>
  </metric>
  <metric name="SelectCount">
    <summary>
      Measures the total number of contacts selected in the contacts picker.
    </summary>
  </metric>
  <metric name="SelectPercentage">
    <summary>
      Measures the percentage of contacts selected in the contacts picker.
    </summary>
  </metric>
</event>

<event name="ContentIndex.Added">
  <owner>rayankans@chromium.org</owner>
  <summary>
    Collected when a new Content Index entry is registered.
  </summary>
  <metric name="Category" enum="ContentIndexCategory">
    <summary>
      The type of the content registered. Corresponds to
      blink.mojom.ContentCategory.
    </summary>
  </metric>
</event>

<event name="ContentIndex.DeletedByUser">
  <owner>rayankans@chromium.org</owner>
  <summary>
    Collected when a Content Index entry is deleted by the user from the
    Downloads page.
  </summary>
  <metric name="Deleted" enum="Boolean">
    <summary>
      Always true.
    </summary>
  </metric>
</event>

<event name="ContentIndex.Opened">
  <owner>rayankans@chromium.org</owner>
  <summary>
    Collected when a Content Index entry is opened from the Downloads page.
  </summary>
  <metric name="IsOffline" enum="Boolean">
    <summary>
      Whether the browser was offline when the content was opened.
    </summary>
  </metric>
</event>

<event name="ContextualSearch">
  <owner>donnd@chromium.org</owner>
  <summary>
    Metrics related to a Contextual Search Tap event on a page, for use with
    Ranker. These metrics are recorded each time the user triggers the
    Contextual Search UI via a tap gesture (when enabled).
  </summary>
  <metric name="DidOptIn">
    <summary>
      Emits a 1 or 0 to indicate whether the user has Opted-in to the privacy
      conditions for Contextual Search or not.
    </summary>
  </metric>
  <metric name="DurationAfterScrollMs">
    <summary>
      Duration in MS between showing the UI and a subsequent scroll event, or
      not recorded if there was no subsequent scroll.
    </summary>
  </metric>
  <metric name="EntityImpressionsCount">
    <summary>
      Emits an integer in the range of 0 - N that represents the number of
      impressions of an Entity that were shown in the Bar, aggregated in Android
      device storage for this user, starting in M-69.
    </summary>
  </metric>
  <metric name="EntityOpensCount">
    <summary>
      Emits an integer in the range of 0 - N that represents the number of times
      an Entity was shown in the Bar and the panel was opened, aggregated in
      Android device storage for this user, starting in M-69.
    </summary>
  </metric>
  <metric name="FontSize">
    <summary>
      Emits a value from 0-10 representing the effective font size on the
      screen. A value of 0 means the font size cannot be obtained. A value of 1
      represents a very small font and a value of 10 represents a large font.
    </summary>
  </metric>
  <metric name="IsEntity">
    <summary>
      Emits a 1 or 0 to indicate whether the word tapped appears to be part of
      an entity, given simple English language rules that check capitalization
      and punctuation.
    </summary>
  </metric>
  <metric name="IsEntityEligible">
    <summary>
      Emits a 1 or 0 to indicate whether the IsEntity boolean ever had a chance
      of being true or not. When we're dealing with languages other than ones
      where our simple entity-detection can work this signal is false.
    </summary>
  </metric>
  <metric name="IsHttp">
    <summary>
      Emits a 1 or 0 to indicate whether the base page is HTTP (insecure).
    </summary>
  </metric>
  <metric name="IsLanguageMismatch">
    <summary>
      Emits a 1 or 0 to indicate whether the language of the base page is a
      mismatch from the list of languages the user knows, so they might want
      translation.
    </summary>
  </metric>
  <metric name="IsLongWord">
    <summary>
      Emits a 1 or 0 to indicate whether the word tapped was considered long (at
      least 10 chars in length).
    </summary>
  </metric>
  <metric name="IsSecondTapOverride">
    <summary>
      Emits a 1 or 0 to indicate whether the tap was an override of normal tap
      suppression because it was considered a second tap on a word after the
      first tap was suppressed.
    </summary>
  </metric>
  <metric name="IsShortWord">
    <summary>
      Emits a 1 or 0 to indicate whether the word tapped was considered short
      (less than 4 characters in length).
    </summary>
  </metric>
  <metric name="IsWordEdge">
    <summary>
      Emits a 1 or 0 to indicate whether the tap gesture was on the edge of a
      word, rather than in the middle 50% of the word.
    </summary>
  </metric>
  <metric name="OpenCount">
    <summary>
      Emits an integer in the range of 0 - N that represents the total number of
      times the user opened the panel, aggregated in Android device storage for
      this user since M-69.
    </summary>
  </metric>
  <metric name="OutcomeRankerDidPredict">
    <summary>
      Emits a 1 or 0 to indicate whether Ranker was able to make a prediction.
    </summary>
  </metric>
  <metric name="OutcomeRankerPrediction">
    <summary>
      Emits a 1 or 0 to indicate what Ranker's prediction was for this record.
      Recorded only when OutcomeRankerDidPredict is true.
    </summary>
  </metric>
  <metric name="OutcomeRankerPredictionScore">
    <summary>
      Emits a single-precision float to indicate the score for the Ranker
      prediction for this record. Recorded only when OutcomeRankerDidPredict is
      true.
    </summary>
  </metric>
  <metric name="OutcomeWasCardsDataShown">
    <summary>
      Emits a 1 or 0 to indicate whether any Contextual Cards data was shown in
      the Contextual Search Bar.
    </summary>
  </metric>
  <metric name="OutcomeWasPanelOpened">
    <summary>
      Emits a 1 or 0 to indicate whether the user opened the overlay panel. This
      is the primary outcome metric.
    </summary>
  </metric>
  <metric name="OutcomeWasQuickActionClicked">
    <summary>
      Emits a 1 or 0 to indicate whether the user clicked within the overlay
      panel when a Quick-Action was shown. This is a secondary outcome metric.
    </summary>
  </metric>
  <metric name="OutcomeWasQuickAnswerSeen">
    <summary>
      Emits a 1 or 0 to indicate whether the user could see a Quick-Answer
      caption within the overlay panel. This is a tertiary outcome metric.
    </summary>
  </metric>
  <metric name="PortionOfElement">
    <summary>
      Emits an integer in the range 0-10 inclusive that expresses the portion of
      the enclosing element that is the word tapped. A zero will be emitted if
      the ratio cannot be calculated. A value of 10 means the word spans the
      entire element, and a value of 1 means the word is 10% or less than the
      entire element.
    </summary>
  </metric>
  <metric name="Previous28DayCtrPercent">
    <summary>
      The CTR of the overlay panel for this user, aggregated in Android device
      storage over a previous 28 day period, expressed as an integer between
      0-99, since M-60.
    </summary>
  </metric>
  <metric name="Previous28DayImpressionsCount">
    <summary>
      The count of views of the overlay panel for this user, aggregated in
      Android device storage over a previous 28 day period, since M-60.
    </summary>
  </metric>
  <metric name="PreviousWeekCtrPercent">
    <summary>
      The CTR of the overlay panel for this user, aggregated in Android device
      storage over the previous week, expressed as an integer between 0-99,
      since M-60.
    </summary>
  </metric>
  <metric name="PreviousWeekImpressionsCount">
    <summary>
      The count of views of the overlay panel for this user, aggregated in
      Android device storage over the previous week, since M-60.
    </summary>
  </metric>
  <metric name="QuickActionImpressionsCount">
    <summary>
      Emits an integer in the range of 0 - N that represents the total number of
      times the user saw a quick action in the caption of the Bar, e.g. a phone
      number to dial. Aggregated in Android device storage since M-69 for this
      user.
    </summary>
  </metric>
  <metric name="QuickActionsIgnored">
    <summary>
      Emits an integer in the range of 0 - N that represents the total number of
      times the user ignored a quick action but opened the Bar instead, e.g. a
      phone number was available but not dialed. Aggregated in Android device
      storage starting at M-69.
    </summary>
  </metric>
  <metric name="QuickActionsTaken">
    <summary>
      Emits an integer in the range of 0 - N that represents the total number of
      times the user activated a quick action by tapping on a quick action shown
      in the Bar, e.g. dialed a phone number. Aggregated in Android device
      storage since M-69 for this user.
    </summary>
  </metric>
  <metric name="QuickAnswerCount">
    <summary>
      Emits an integer in the range of 0 - N that represents the total number of
      times the user saw a quick answer in the caption of the Bar. Typically
      these quick answers represent an automatic translation of the selection.
      Aggregated in Android device storage for all time for this user, since
      M-57.
    </summary>
  </metric>
  <metric name="ScreenTopDps">
    <summary>
      The location of the tap relative to the top of the screen, expressed in
      DPs.
    </summary>
  </metric>
  <metric name="TapCount">
    <summary>
      Emits an integer in the range of 0 - N that represents the total number of
      taps that triggered the Bar, aggregated in Android device storage for this
      user, since M-43.
    </summary>
  </metric>
  <metric name="TapDurationMs">
    <summary>
      The duration of the tap gesture expressed as an integer in milliseconds.
    </summary>
  </metric>
  <metric name="WasScreenBottom">
    <summary>
      The location of the tap relative to the bottom of the screen, expressed as
      an integer with 0 meaning not at the bottom and 1 meaning at the bottom.
    </summary>
  </metric>
</event>

<event name="ContextualSuggestions">
  <obsolete>
    This feature was deprecated in M74
  </obsolete>
  <owner>donnd@chromium.org</owner>
  <owner>fgorski@chromium.org</owner>
  <owner>twellington@chromium.org</owner>
  <owner>zea@chromium.org</owner>
  <summary>
    Metrics related to Contextual Suggestions shown in the Chrome Assistive
    Surface, aka EoC shown in CAS. These metrics are recorded each time the
    Contextual Suggestions UI is dismissed. Each record always contains a value
    for every metric known at the time of the implementation.
  </summary>
  <metric name="AnyDownloaded">
    <summary>
      Emits an integer in the range 0-1 to indicate whether the user downloaded
      any suggestions.
    </summary>
  </metric>
  <metric name="AnySuggestionTaken">
    <summary>
      Emits an integer in the range 0-1 to indicate whether any suggestion link
      was taken.
    </summary>
  </metric>
  <metric name="ClosedFromPeek">
    <summary>
      Emits an integer in the range 0-1 to indicate whether the peeking sheet
      was closed by tapping on the close button.
    </summary>
  </metric>
  <metric name="EverOpened">
    <summary>
      Emits an integer in the range 0-1 to indicate whether the sheet was ever
      opened.
    </summary>
  </metric>
  <metric name="FetchState">
    <summary>
      Emits an integer in the range 0-7 to indicate the ending state of the data
      fetcher and results returned. A value of 0 indicates not-started, a 7
      indicates fetch-completed with suggestions. See the code for details.
    </summary>
  </metric>
  <metric name="ShowDurationBucketMin">
    <summary>
      Emits an integer in the range 0-N to indicate the duration that the sheet
      was shown before a positive or negative action was taken. A value of 0
      indicates that the UI was never shown. A value greater than 0 indicates
      that some user interaction occurred taking at least the indicated number
      of milliseconds, but less than twice that amount. This exponential
      bucketing is done for privacy reasons, and uses the UKM
      GetExponentialBucketMin method with a value of 2.0 for spacing.
    </summary>
  </metric>
  <metric name="TriggerEvent">
    <summary>
      Emits an integer in the range 0-2 to indicate whether the contextual
      suggestions UI was ever triggered and how it was triggered. A value of 0
      indicates never-shown, a 1 indicates peeked in response to a
      reverse-scroll (deprecated), and 2 indicates that the toolbar button was
      shown (the only trigger currently supported).
    </summary>
  </metric>
</event>

<event name="CPUUsageMeasurement">
  <owner>chrisha@chromium.org</owner>
  <owner>siggi@chromium.org</owner>
  <summary>
    A CPU usage measurement that corresponds to a tick in a CPU usage
    time-series. There is also some metadata stored to determine how faithful
    the CPU usage measurement is (e.g. NumberOfCoresidentTabs).
  </summary>
  <metric name="CPUUsage">
    <summary>
      CPU usage measurement. This is in units of clock-cycles. For example, 1.2
      seconds of 100% CPU usage on a 2.5GHz CPU corresponds to a value of 1.2 x
      1.0 x 2.5e9 = 3e6.
    </summary>
  </metric>
  <metric name="EventType">
    <summary>
      The event associated with the measurement. This is an integer value
      corresponding to the enum defined in
      resource_coordinator::RenderProcessProbe.
    </summary>
  </metric>
  <metric name="IsVisible">
    <summary>
      Indicates if any frame hosted in this tab is visible at the moment the
      measurement is taken.
    </summary>
  </metric>
  <metric name="NumberOfCoresidentTabs">
    <summary>
      Number of co-resident tabs in all of the render processes a tab is
      associated with when the CPU usage measurement is taken.
    </summary>
  </metric>
  <metric name="ObservationWindowSizeMs">
    <summary>
      The size of the observation window (time since last CPU measurement) in
      milliseconds.
    </summary>
  </metric>
  <metric name="ProcessUptimeMs">
    <summary>
      The uptime of the process being measured, in milliseconds.
    </summary>
  </metric>
</event>

<event name="DataReductionProxy" singular="True">
  <owner>robertogden@chromium.org</owner>
  <summary>
    Data Reduction Proxy related metrics associated with a page load. See
    //components/data_reduction_proxy/.
  </summary>
  <metric name="DataSaverPageUUID">
    <summary>
      A unique identifier of this page load to the proxy server. Recorded for
      each navigation that uses the proxy.
    </summary>
  </metric>
  <metric name="EstimatedOriginalNetworkBytes">
    <summary>
      The estimated number of bytes that would have been used if that proxy was
      disabled on this page load. Recorded for each navigation that uses the
      proxy.
    </summary>
  </metric>
</event>

<event name="Document.OutliveTimeAfterShutdown">
  <owner>hajimehoshi@chromium.org</owner>
  <owner>keishi@chromium.org</owner>
  <summary>
    Recorded when a Document object survives certain number of garbage
    collections after detached. It is expected that regular Document objects are
    destroyed soon after detached, and if a document outlives longer, probably
    this can be leaked.
  </summary>
  <metric name="GCCount">
    <summary>
      Measures the numbers of garbarge collection after the document is
      detached. This is recorded when the number reached certain numbers like 5
      or 10.
    </summary>
  </metric>
</event>

<event name="DocumentCreated">
  <owner>beccahughes@chromium.org</owner>
  <summary>
    Recorded when a Document object is created and records the source ID of the
    navigation and whether the document was in the main frame. This can be used
    to link subframe UKM events to the parent document.
  </summary>
  <metric name="IsCrossOriginFrame">
    <summary>
      Whether the document was in a cross origin iframe. This can either be 0 or
      1.
    </summary>
  </metric>
  <metric name="IsMainFrame">
    <summary>
      Whether the document was in the main frame. This is can either be 0 or 1.
    </summary>
  </metric>
  <metric name="NavigationSourceId">
    <summary>
      Contains the UKM source id of the navigation as an integer.
    </summary>
  </metric>
</event>

<event name="Download.Completed">
  <owner>jming@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
  <summary>
    Metrics taken when a download completes. Its parent event is
    Download.Started.
  </summary>
  <metric name="BytesWasted">
    <summary>
      The number of bytes that have been used in an excess (ie. download
      restarting the middle of a download).
    </summary>
  </metric>
  <metric name="DownloadId">
    <summary>
      The id of the download that is used to associate separate events.
    </summary>
  </metric>
  <metric name="ResultingFileSize">
    <summary>
      The size of the file that is downloaded, expressed in kilobytes with
      exponentially growing buckets.
    </summary>
  </metric>
  <metric name="TimeSinceStart">
    <summary>
      The difference in the time between when the download finished and when it
      began, expressed in miliseconds.
    </summary>
  </metric>
</event>

<event name="Download.Interrupted">
  <owner>jming@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
  <summary>
    Metrics taken when a download is interrupted. Its parent event is
    Download.Started.
  </summary>
  <metric name="BytesWasted">
    <summary>
      The number of bytes that have been used in an excess (ie. download
      restarting the middle of a download).
    </summary>
  </metric>
  <metric name="ChangeInFileSize">
    <summary>
      The difference in the size of the file that is downloaded compared to the
      initial reported size, expressed in kilobytes with exponentially growing
      buckets.
    </summary>
  </metric>
  <metric name="DownloadId">
    <summary>
      The id of the download that is used to associate separate events.
    </summary>
  </metric>
  <metric name="Reason">
    <summary>
      The reason the download was interrupted, expressed as an enum defined in
      DownloadInterruptReason.
    </summary>
  </metric>
  <metric name="ResultingFileSize">
    <summary>
      The size of the file that is downloaded, expressed in kilobytes with
      exponentially growing buckets.
    </summary>
  </metric>
  <metric name="TimeSinceStart">
    <summary>
      The difference in the time between when the download interrupted and when
      it began, expressed in miliseconds.
    </summary>
  </metric>
</event>

<event name="Download.Resumed">
  <owner>jming@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
  <summary>
    Metrics taken when a download is resumed. Its parent event is
    Download.Started.
  </summary>
  <metric name="DownloadId">
    <summary>
      The id of the download that is used to associate separate events.
    </summary>
  </metric>
  <metric name="Mode">
    <summary>
      The mode by which the download was resumed, expressed as an enum defined
      in ResumeMode.
    </summary>
  </metric>
  <metric name="TimeSinceStart">
    <summary>
      The difference in the time between when the download resumed and when it
      began, expressed in miliseconds.
    </summary>
  </metric>
</event>

<event name="Download.Started">
  <owner>jming@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
  <summary>
    Metrics taken when a download begins. It has one Download.Ended and none to
    multiple Download.Interrupted/Download.Resumed events associated with it.
  </summary>
  <metric name="DownloadConnectionSecurity">
    <summary>
      The state of the security of the final download URL and all the redirects
      leading to it. Expressed as an enum defined in DownloadConnectionSecurity.
    </summary>
  </metric>
  <metric name="DownloadId">
    <summary>
      The id of the download that is used to associate separate events.
    </summary>
  </metric>
  <metric name="DownloadSource">
    <summary>
      The source of the download, expressed as an enum defined in DownloadEntry.
    </summary>
  </metric>
  <metric name="FileType">
    <summary>
      The type of file that is downloaded, expressed as an enum defined in
      DownloadContentType.
    </summary>
  </metric>
  <metric name="IsSameHostDownload">
    <summary>
      A boolean denoting if the final download URL is the same host as the
      initiating frame (i.e., whether the initiating site likely controls the
      download itself).
    </summary>
  </metric>
</event>

<event name="Event.ScrollBegin.Touch">
  <owner>nzolghadr@chromium.org</owner>
  <summary>
    Metrics related to first scroll action caused by the generated ScrollUpdate
    gesture event.
  </summary>
  <metric name="IsMainThread">
    <summary>
      Whether the event is handled on the main thread or not.
    </summary>
  </metric>
  <metric name="TimeToHandled">
    <summary>
      The time in microseconds between initial creation of a touch event and the
      first generated ScrollUpdate gesture event in a given scroll gesture event
      sequence is handled on main/impl thread. If no swap was induced by the
      ScrollUpdate gesture event, no recording is made.
    </summary>
  </metric>
  <metric name="TimeToScrollUpdateSwapBegin">
    <summary>
      The time in microseconds between initial creation of a touch event and the
      start of the frame swap on the GPU service caused by the generated
      ScrollUpdate gesture event if that ScrollUpdate is the first such event in
      a given scroll gesture event sequence. If no swap was induced by the
      event, no recording is made.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.country,profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="Event.ScrollBegin.Wheel">
  <owner>nzolghadr@chromium.org</owner>
  <summary>
    Metrics related to first scroll action caused by the generated ScrollUpdate
    gesture event.
  </summary>
  <metric name="IsMainThread">
    <summary>
      Whether the event is handled on the main thread or not.
    </summary>
  </metric>
  <metric name="TimeToHandled">
    <summary>
      The time in microseconds between initial creation of a wheel event and the
      first generated ScrollUpdate gesture event in a given scroll gesture event
      sequence is handled on main/impl thread. If no swap was induced by the
      ScrollBegin gesture event, no recording is made.
    </summary>
  </metric>
  <metric name="TimeToScrollUpdateSwapBegin">
    <summary>
      The time in microseconds between the initial creation of a wheel event and
      the start of the frame swap on the GPU service caused by the generated
      ScrollUpdate gesture event if that ScrollUpdate is the first such event in
      a given scroll gesture event sequence. If no swap was induced by the
      event, no recording is made.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.country,profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="Event.ScrollUpdate.Touch">
  <owner>nzolghadr@chromium.org</owner>
  <summary>
    Metrics related to a scroll action caused by the generated ScrollUpdate
    gesture event.
  </summary>
  <metric name="IsMainThread">
    <summary>
      Whether the event is handled on the main thread or not.
    </summary>
  </metric>
  <metric name="TimeToHandled">
    <summary>
      The time in microseconds between initial creation of a touch event and the
      generated ScrollUpdate gesture event is handled on main/impl thread. If no
      swap was induced by the ScrollUpdate gesture event, no recording is made.
    </summary>
  </metric>
  <metric name="TimeToScrollUpdateSwapBegin">
    <summary>
      The time in microseconds between the initial creation of a touch event and
      the start of the frame swap on the GPU service. If no swap was induced by
      the event, no recording is made. The first GSU of every scrolling sequence
      is excluded from this metric.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.country,profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="Event.ScrollUpdate.Wheel">
  <owner>nzolghadr@chromium.org</owner>
  <owner>tdresser@chromium.org</owner>
  <summary>
    Metrics related to a scroll action caused by the generated ScrollUpdate
    gesture event.
  </summary>
  <metric name="IsMainThread">
    <summary>
      Whether the event is handled on the main thread or not.
    </summary>
  </metric>
  <metric name="TimeToHandled">
    <summary>
      The time in microseconds between initial creation of a wheel event and the
      generated ScrollUpdate gesture event is handled on main/impl thread. If no
      swap was induced by the ScrollUpdate gesture event, no recording is made.
      The first GSU of every scrolling sequence is excluded from this metric.
    </summary>
  </metric>
  <metric name="TimeToScrollUpdateSwapBegin">
    <summary>
      The time in microseconds between the initial creation of a wheel event and
      the start of the frame swap on the GPU service. If no swap was induced by
      the event, no recording is made. The first GSU of every scrolling sequence
      is excluded from this metric.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.country,profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="FontMatchAttempts">
  <owner>caraitto@chromium.org</owner>
  <owner>pauljensen@chromium.org</owner>
  <owner>privacy-sandbox-dev@chromium.org</owner>
  <summary>
    Records font family match attempts, broken down by system fonts and web
    fonts. Multiple match attempts using the same font family name are
    de-duplicated. Matching of @font-face src:local fonts isn't currently
    supported.
  </summary>
  <metric name="LoadContext" enum="FontLoadContext">
    <summary>
      If the font family name was matched in the top-level frame or a sub-frame.
    </summary>
  </metric>
  <metric name="SystemFontFamilyFailures">
    <summary>
      The count of system font family match attempts that failed.
    </summary>
  </metric>
  <metric name="SystemFontFamilySuccesses">
    <summary>
      The count of system font family match attempts that succeeded.
    </summary>
  </metric>
  <metric name="WebFontFamilyFailures">
    <summary>
      The count of web font family match attempts that failed.
    </summary>
  </metric>
  <metric name="WebFontFamilySuccesses">
    <summary>
      The count of web font family match attempts that succeeded.
    </summary>
  </metric>
</event>

<event name="Graphics.Smoothness.Throughput">
  <owner>animations-dev@chromium.org</owner>
  <owner>sadrul@chromium.org</owner>
  <summary>
    Tracks the throughput of a particular sequence of frames such as during
    scroll or animation. Throughput is measured by tracking the number of frames
    the sequence was expected to produce, and the number of frames that were
    actually displayed on screen. Throughput is the ratio of actual to expected,
    converted to a percentage.
  </summary>
  <metric name="CompositorThread.CompositorAnimation">
    <summary>
      The throughput of the compositor thread during a compositor animation.
    </summary>
  </metric>
  <metric name="CompositorThread.MainThreadAnimation">
    <summary>
      The throughput of the compositor thread during a main thread animation.
    </summary>
  </metric>
  <metric name="CompositorThread.PinchZoom">
    <summary>
      The throughput of the compositor thread during pinch-zoom interactions.
    </summary>
  </metric>
  <metric name="CompositorThread.RAF">
    <summary>
      The throughput of the compositor thread during rAF callback driven
      animation.
    </summary>
  </metric>
  <metric name="CompositorThread.TouchScroll">
    <summary>
      The throughput of the compositor thread during touchscroll driven
      interactions.
    </summary>
  </metric>
  <metric name="CompositorThread.Universal">
    <summary>
      The throughput of the compositor thread for all frame production.
    </summary>
  </metric>
  <metric name="CompositorThread.Video">
    <summary>
      The throughput of the compositor thread during video play.
    </summary>
  </metric>
  <metric name="CompositorThread.WheelScroll">
    <summary>
      The throughput of the compositor thread during mousewheel scroll driven
      interactions.
    </summary>
  </metric>
  <metric name="MainThread.CompositorAnimation">
    <summary>
      The throughput of the main thread during a compositor animation.
    </summary>
  </metric>
  <metric name="MainThread.MainThreadAnimation">
    <summary>
      The throughput of the main thread during a main thread animation.
    </summary>
  </metric>
  <metric name="MainThread.PinchZoom">
    <summary>
      The throughput of the main thread during pinch-zoom interactions.
    </summary>
  </metric>
  <metric name="MainThread.RAF">
    <summary>
      The throughput of the main thread during rAF callback driven animation.
    </summary>
  </metric>
  <metric name="MainThread.TouchScroll">
    <summary>
      The throughput of the main thread during touchscroll driven interactions.
    </summary>
  </metric>
  <metric name="MainThread.Universal">
    <summary>
      The throughput of the main thread for all frame production.
    </summary>
  </metric>
  <metric name="MainThread.Video">
    <summary>
      The throughput of the main thread during video play.
    </summary>
  </metric>
  <metric name="MainThread.WheelScroll">
    <summary>
      The throughput of the main thread during mousewheel scroll driven
      interactions.
    </summary>
  </metric>
  <metric name="SlowerThread.CompositorAnimation">
    <summary>
      The worse throughput of the main and the compositor thread during a
      compositor animation.
    </summary>
  </metric>
  <metric name="SlowerThread.MainThreadAnimation">
    <summary>
      The worse throughput of the main and the compositor thread during a main
      thread animation.
    </summary>
  </metric>
  <metric name="SlowerThread.PinchZoom">
    <summary>
      The worse throughput of the main and the compositor thread during
      pinch-zoom interactions.
    </summary>
  </metric>
  <metric name="SlowerThread.RAF">
    <summary>
      The worse throughput of the main and the compositor thread during rAF
      callback driven animation.
    </summary>
  </metric>
  <metric name="SlowerThread.TouchScroll">
    <summary>
      The worse throughput of the main and the compositor thread during
      touchscroll driven interactions.
    </summary>
  </metric>
  <metric name="SlowerThread.Universal">
    <summary>
      The worse throughput of the main and the compositor thread for all frame
      production.
    </summary>
  </metric>
  <metric name="SlowerThread.Video">
    <summary>
      The worse throughput of the main and the compositor thread during video
      play.
    </summary>
  </metric>
  <metric name="SlowerThread.WheelScroll">
    <summary>
      The worse throughput of the main and the compositor thread during
      mousewheel scroll driven interactions.
    </summary>
  </metric>
</event>

<event name="HistoryManipulationIntervention">
  <owner>shivanisha@chromium.org</owner>
  <summary>
    Logged when an entry in the back-forward list is marked to be skipped on
    subsequent back/forward button clicks as part of the history manipulation
    intervention. This is logged when the entry is navigated away from.
  </summary>
</event>

<event name="HistoryNavigation" singular="True">
  <owner>altimin@chromium.org</owner>
  <owner>arthursonzogni@chromium.org</owner>
  <summary>
    Metrics recorded each time we commit a history navigation, which are needed
    to estimate benefits of back-forward cache.
  </summary>
  <metric name="CrossOriginSubframesFeatures">
    <summary>
      Bitmask of features used by the cross origin subframes of the previous
      page load. See blink::SchedulingPolicy::Feature for the meaning for the
      individual features.
    </summary>
  </metric>
  <metric name="LastCommittedSourceIdForTheSameDocument">
    <summary>
      For history navigations and reloads, the source id of the previous
      navigation which loaded the page we're trying to navigate back to.
    </summary>
  </metric>
  <metric name="MainFrameFeatures">
    <summary>
      Bitmask of features used by the main frames of the previous page load. See
      blink::SchedulingPolicy::Feature for the meaning for the individual
      features.
    </summary>
  </metric>
  <metric name="NavigatedToTheMostRecentEntryForDocument">
    <summary>
      Boolean for whether we navigated to the same navigation entry as the one
      which was last visible.

      It can be false when subframes or same-document navigations are present.
      For example, after navigating from http://foo to http://foo#bar and then
      http://bar and then going back by 2 entries will mean we went to
      http://foo while the last committed entry from this document was
      http://foo#bar.

      It's expected to be rare, but might be problematic for back-forward cache.
    </summary>
  </metric>
  <metric name="SameOriginSubframesFeatures">
    <summary>
      Bitmask of features used by the same origin subframes of the previous page
      load. See blink::SchedulingPolicy::Feature for the meaning for the
      individual features.
    </summary>
  </metric>
  <metric name="TimeSinceNavigatedAwayFromDocument">
    <summary>
      Time in milliseconds from the moment the current navigation stopped being
      active to the start of the current navigation.

      This is clamped to hours for values greater than 3 hours, to minutes for
      values greater than 3 minutes, to seconds for values greater than 5
      seconds.
    </summary>
  </metric>
</event>

<event name="Intervention.DocumentWrite.ScriptBlock" singular="True">
  <owner>bmcquade@chromium.org</owner>
  <summary>
    Recorded for page loads where the document.write script block intervention
    could apply.
  </summary>
  <metric name="Disabled.Reload">
    <summary>
      Records '1' if the document.write script block intervention could have
      applied, but was disabled due to the page being reloaded.
    </summary>
  </metric>
  <metric name="ParseTiming.ParseBlockedOnScriptExecutionFromDocumentWrite">
    <summary>
      Measures the time in milliseconds that the HTML parser spent blocked on
      the execution of scripts inserted from document.write, for main frame
      documents that finished parsing.
    </summary>
  </metric>
  <metric name="ParseTiming.ParseBlockedOnScriptLoadFromDocumentWrite">
    <summary>
      Measures the time in milliseconds that the HTML parser spent blocked on
      the load of scripts inserted from document.write, for main frame documents
      that finished parsing.
    </summary>
  </metric>
</event>

<event name="IOS.FindInPageSearchMatches">
  <owner>thegreenfrog@chromium.org</owner>
  <owner>michaeldo@chromium.org</owner>
  <summary>
    Logged when the FindInPage returns a user search request result.
  </summary>
  <metric name="HasMatches" enum="Boolean">
    <summary>
      True if there were matches.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="IOS.RendererGone">
  <owner>olivierrobin@chromium.org</owner>
  <summary>
    Logged when WKWebView process is reported gone. Metrics will give
    information of the context in which some website present sad tabs. It will
    help debug some renderer issues either in Chrome or in WebKit.
  </summary>
  <metric name="AliveRecentlyRendererCount">
    <summary>
      The number of WKWebView alive in the last 2 seconds.
    </summary>
  </metric>
  <metric name="AliveRendererCount">
    <summary>
      The number of WKWebView alive at the moment this renderer is gone.
    </summary>
  </metric>
  <metric name="InForeground" enum="TabForegroundState">
    <summary>
      Whether the app/tab was in foregound or background. 0: tab in foreground,
      app in foreground, 1: tab in background, app in foreground, 2: tab in
      foreground, app in background, 3: tab in background, app in background.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="SawMemoryWarning" enum="Boolean">
    <summary>
      Whether a memory warning was received less than 5 seconds before the
      renderer process is gone.
    </summary>
  </metric>
</event>

<event name="IOS.URLMismatchInLegacyAndSlimNavigationManager">
  <owner>eugenebut@chromium.org</owner>
  <owner>danyao@chromium.org</owner>
  <summary>
    Logged when LegacyNavigationManager and KWKBasedNavigationManager have
    different last committed URLs. This means that either old or new navigation
    system has a URL spoofing bug.
  </summary>
  <metric name="HasMismatch">
    <summary>
      True if there was a mismatch.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="Layout.DisplayCutout.StateChanged">
  <owner>beccahughes@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Recorded every time the ViewportFit that is supplied by a frame changes or
    the fullscreen state of a frame or its parent WebContents changes.
  </summary>
  <metric name="IsMainFrame">
    <summary>
      Records '1' if the frame that triggered this event is the main frame.
    </summary>
  </metric>
  <metric name="SafeAreasPresent">
    <summary>
      Records whether each safe area was present. It will contain the first flag
      (1) if the top safe area is present. Likewise the second for the left, the
      third for the bottom and the forth for the right. If the safe area is
      updated whilst we are allowed to extend into the cutout then we will use
      the newest safe area values.
    </summary>
  </metric>
  <metric name="ViewportFit.Applied">
    <summary>
      Contains the ViewportFit value that was applied by the WebContents. The
      frame that is fullscreen will always propagate it's ViewportFit value.
      This is stored as a ViewportFit enum (see display_cutout.mojom).
    </summary>
  </metric>
  <metric name="ViewportFit.IgnoredReason">
    <summary>
      Records the reason why the ViewportFit value of this frame was not the
      applied value. It will be '0' if the value was allowed. It will be '1' if
      the ViewportFit value from the frame was blocked because the WebContents
      was not fullscreen. It will be '2' flag if the ViewportFit value from the
      frame was blocked because another frame is fullscreen.
    </summary>
  </metric>
  <metric name="ViewportFit.Supplied">
    <summary>
      Contains the ViewportFit value that was supplied by the frame that
      triggered the event. This is stored as a ViewportFit enum (see
      display_cutout.mojom). It can never be kAuto as we ignore events when the
      page is not trying to use the viewport fit API.
    </summary>
  </metric>
</event>

<event name="LocalNetworkRequests">
  <owner>uthakore@chromium.org</owner>
  <owner>invernizzi@chromium.org</owner>
  <summary>
    Metrics that describe the resource request behavior of pages for which
    navigation successfully commits. A separate entry is generated for every
    unique IP address or localhost port number to which the loaded page makes a
    resource request.
  </summary>
  <metric name="Count.Failed">
    <summary>
      The count of requests made by the page to the given resource for which a
      response is not received or a network error occurs (i.e. |net_error| !=
      |net::OK|) between the time navigation to the page commits and the time it
      completes.
    </summary>
  </metric>
  <metric name="Count.Successful">
    <summary>
      The count of requests made by the page to the given resource for which a
      successful response is received (i.e. |net_error| == |net::OK|) between
      the time navigation to the page commits and the time it completes.
    </summary>
  </metric>
  <metric name="PortType">
    <summary>
      An enum value representing the type of port for requests to localhost. The
      enum is defined in |LocalNetworkRequestsPageLoadMetricsObserver|. Possible
      values are 1 for common web server ports, 2 for common database server
      ports, 4 for common print server ports, 8 for common development server
      ports, and 0 for all other ports.
    </summary>
  </metric>
  <metric name="ResourceType">
    <summary>
      An enum value representing the type of resource requested. The enum is
      defined in |LocalNetworkRequestsPageLoadMetricsObserver|. Possible values
      are 0 for public resources requested by private pages, 1 for private
      resources requested by public pages, 2 for private resources within the
      same reserved IP space as the loaded private page, 4 for for private
      resources within a different reserved IP space than the loaded private
      page, 8 for resources requested by public pages that are suspected to be
      routers, and 16 for localhost resources.
    </summary>
  </metric>
</event>

<event name="LookalikeUrl.NavigationSuggestion" singular="True">
  <owner>meacer@chromium.org</owner>
  <owner>cthomp@chromium.org</owner>
  <summary>
    Metrics recorded when a navigated URL's domain name is visually similar to a
    popular domain or a domain that the user engaged with.
  </summary>
  <metric name="MatchType">
    <summary>
      An enum value representing the type of the match (popular domain, engaged
      domain, etc.). The enum is defined in |LookalikeUrlInterstitialPage|.
    </summary>
  </metric>
  <metric name="UserAction">
    <summary>
      An enum value representing the decision the user made when shown an
      interstitial (ignored, suggestion_accepted, etc.). The enum is defined in
      |LookalikeUrlInterstitialPage|.
    </summary>
  </metric>
</event>

<event name="MainFrameDownload">
  <obsolete>
    Deprecated as of 03/2019.
  </obsolete>
  <owner>yaoxia@chromium.org</owner>
  <summary>
    Measurement for top frame download. It is only recorded for downloads
    originated from navigations or from HTML anchor download attributes.
  </summary>
  <metric name="HasGesture">
    <summary>
      A boolean denoting whether the download involves a transient user gesture.
    </summary>
  </metric>
  <metric name="HasSandbox">
    <summary>
      A boolean denoting whether the download occurs in a sandboxed browsing
      context.
    </summary>
  </metric>
</event>

<event name="Media.Autoplay.Attempt">
  <owner>mlamouri@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Event recorded when there is an attempt to autoplay (ie. no user gesture).
    It will be recorded regardless of the result of this attempt.
  </summary>
  <metric name="AudioTrack">
    <summary>
      Whether the element had an audio track when autoplay was attempted.
    </summary>
  </metric>
  <metric name="HighMediaEngagement">
    <summary>
      Whether the document has a high media engagement.
    </summary>
  </metric>
  <metric name="Muted">
    <summary>
      Whether the element was muted when autoplay was attempted.
    </summary>
  </metric>
  <metric name="Source">
    <summary>
      Source of the autoplay attempt: 0 for attribute; 1 for play().
    </summary>
  </metric>
  <metric name="UserGestureRequired">
    <summary>
      Whether a user gesture was required per autoplay rules at the time of
      attempt. By definition there is no user gesture on the stack when the
      attempt is registered.
    </summary>
  </metric>
  <metric name="UserGestureStatus">
    <summary>
      Reflects the current status of user gesture/activation. This is a bit
      field with the following values: - 0b0001 if there is a user gesture on
      the stack; - 0b0010 if there was a user gesture on the page (ie. was
      activated); - 0b0100 if there was a user gesture propogated after a
      navigation.
    </summary>
  </metric>
  <metric name="VideoTrack">
    <summary>
      Whether the element had a video track when autoplay was attempted.
    </summary>
  </metric>
</event>

<event name="Media.Autoplay.AudioContext">
  <owner>mlamouri@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Records the AudioContext autoplay information.
  </summary>
  <metric name="SourceNodeStarted">
    <summary>
      A boolean indicating if start() was called for any source node associated
      to the AudioContext.
    </summary>
  </metric>
  <metric name="Status">
    <summary>
      Status of this AudioContext when the autoplay policy applies. It will
      match the values from AudioContext::AutoplayStatus.
    </summary>
  </metric>
  <metric name="UnlockType">
    <summary>
      How the AudioContext was unlocked if it was. It will match the values from
      AudioContext::AutoplayUnlockType unless the AudioContext was never
      unlocked in which case it will be equal to -1.
    </summary>
  </metric>
</event>

<event name="Media.Autoplay.Muted.UnmuteAction">
  <owner>mlamouri@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Event recorded when there is an attempt to unmute an media that was
    autoplaying following the rules of autoplay muted.
  </summary>
  <metric name="Result">
    <summary>
      0 means that the unmute failed because it happened without a user gesture.
      1 means that it succeeded because it had a user gesture.
    </summary>
  </metric>
  <metric name="Source">
    <summary>
      Similar to &quot;Source&quot; in &quot;Media.Autoplay.Attempt&quot; with
      the addition of a value for both sources being used: 0 for attribute; 1
      for play(); 2 for both attempted.
    </summary>
  </metric>
</event>

<event name="Media.BasicPlayback">
  <owner>dalecurtis@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Core metrics associated with a media playback through WebMediaPlayerImpl.
    Reported at the time of WatchTimeRecorder destruction or render process
    termination; whichever comes first. There will be multiple entries for a
    given playback; one for every PlaybackProperties change as well as one for
    foreground and background. Records may be aggregated based on PlayerID and
    correlated with the Media.WebMediaPlayerState event.
  </summary>
  <metric name="AudioCodec">
    <summary>
      media::AudioCodec enum value. Can be kUnknownAudioCodec even when HasAudio
      is true because we don't always know the codec.
    </summary>
  </metric>
  <metric name="AudioDecoderName">
    <summary>
      Enumeration of audio decoder names, zero if none or unknown (Cast, HLS,
      etc). See WatchTimeRecorder::AudioDecoderName enum for expected values.
    </summary>
  </metric>
  <metric name="AudioEncryptionScheme">
    <summary>
      media::EncryptionMode enum value. Can be kUnencrypted if IsEME is false or
      if the audio track is unencrypted.
    </summary>
  </metric>
  <metric name="AutoplayInitiated">
    <summary>
      Boolean value indicating whether the initial playback was initiated via
      autoplay. Multilpe chunk records of the same player should have the same
      value. Autoplay is defined as a playback starting before there was a user
      activation on the page or without a user initiated same-domain navigation.
    </summary>
  </metric>
  <metric name="CompletedRebuffersCount">
    <summary>
      Integer count of the number of times a previous rebuffer succeeded and
      playback continued.
    </summary>
  </metric>
  <metric name="CompletedRebuffersDuration">
    <summary>
      Sum in milliseconds of all completed rebuffering events. Only reported if
      a rebuffering completion occurred.
    </summary>
  </metric>
  <metric name="Duration">
    <summary>
      Duration in milliseconds, rounded to the most significant digit, of the
      media being played. May be missing if the duration is unknown or infinite.
    </summary>
  </metric>
  <metric name="HasAudio">
    <summary>
      Boolean value indicating the presence of audio.
    </summary>
  </metric>
  <metric name="HasVideo">
    <summary>
      Boolean value indicating the presence of video.
    </summary>
  </metric>
  <metric name="IsBackground">
    <summary>
      Boolean value indicating if this event is for a background playback.
    </summary>
  </metric>
  <metric name="IsEME">
    <summary>
      Boolean value indicating if this event is for an EME playback.
    </summary>
  </metric>
  <metric name="IsMSE">
    <summary>
      Boolean value indicating if this event is for an MSE playback. If false it
      means this was a SRC playback.
    </summary>
  </metric>
  <metric name="IsMuted">
    <summary>
      Boolean value indicating if this event is for a muted playback.
    </summary>
  </metric>
  <metric name="IsTopFrame">
    <summary>
      Flag indicating whether the report comes from the top frame or some inner
      frame. For privacy, metrics from inner frames are recorded with the top
      frame's origin, so this flag helps separate top frame vs. embedded
      playbacks.
    </summary>
  </metric>
  <metric name="LastPipelineStatus">
    <summary>
      media::PipelineStatus enum value. Always 0 if the playback succeeded; all
      other values indicate the playback ended in an error.
    </summary>
  </metric>
  <metric name="MeanTimeBetweenRebuffers">
    <summary>
      Average number of milliseconds between rebuffering events. Only reported
      if a rebuffering event occurred. Computed by dividing total watch time by
      the number of rebuffering events.
    </summary>
  </metric>
  <metric name="PlayerID">
    <summary>
      ID which corresponds to a given WebMediaPlayerImpl instance. May be linked
      with Media.WebMediaPlayerState events to understand playback more deeply.
    </summary>
  </metric>
  <metric name="RebuffersCount">
    <summary>
      Integer count of the number of times playback experienced rebuffering.
    </summary>
  </metric>
  <metric name="VideoCodec">
    <summary>
      media::VideoCodec enum value. Can be kUnknownVideoCodec even when HasVideo
      is true because we don't always know the codec.
    </summary>
  </metric>
  <metric name="VideoCodecProfile">
    <summary>
      media::VideoCodecProfile enum value. Can be VIDEO_CODEC_PROFILE_UNKNOWN
      even when HasVideo is true because we don't always know the codec profile.
    </summary>
  </metric>
  <metric name="VideoDecoderName">
    <summary>
      Enumeration of video decoder names, zero if none or unknown (Cast, HLS,
      etc). See WatchTimeRecorder::VideoDecoderName enum for expected values.
    </summary>
  </metric>
  <metric name="VideoEncryptionScheme">
    <summary>
      media::EncryptionMode enum value. Can be kUnencrypted if IsEME is false or
      if the video track is unencrypted.
    </summary>
  </metric>
  <metric name="VideoFramesDecoded">
    <summary>
      Integer count of the video frames decoded in this record.
    </summary>
  </metric>
  <metric name="VideoFramesDropped">
    <summary>
      Integer count of the video frames dropped in this record. Should not
      exceed VideoFramesDecoded.
    </summary>
  </metric>
  <metric name="VideoNaturalHeight">
    <summary>
      Integer value indicating the natural height of the playback.
    </summary>
  </metric>
  <metric name="VideoNaturalWidth">
    <summary>
      Integer value indicating the natural width of the playback.
    </summary>
  </metric>
  <metric name="WatchTime">
    <summary>
      Watch time in milliseconds for this playback. See Media.WatchTime UMA
      metrics.
    </summary>
  </metric>
  <metric name="WatchTime.AC">
    <summary>
      Watch time on AC power in milliseconds for this playback. See
      Media.WatchTime UMA metrics.
    </summary>
  </metric>
  <metric name="WatchTime.Battery">
    <summary>
      Watch time on battery power in milliseconds for this playback. See
      Media.WatchTime UMA metrics.
    </summary>
  </metric>
  <metric name="WatchTime.DisplayFullscreen">
    <summary>
      Watch time for fullscreen in milliseconds for this playback. See
      Media.WatchTime UMA metrics. Only reported for foreground playbacks.
    </summary>
  </metric>
  <metric name="WatchTime.DisplayInline">
    <summary>
      Watch time for inline display in milliseconds for this playback. See
      Media.WatchTime UMA metrics. Only reported for foreground playbacks.
    </summary>
  </metric>
  <metric name="WatchTime.DisplayPictureInPicture">
    <summary>
      Watch time for picture in picture display in milliseconds for this
      playback. See Media.WatchTime UMA metrics. Only reported for foreground
      playbacks.
    </summary>
  </metric>
  <metric name="WatchTime.NativeControlsOff">
    <summary>
      Watch time with no controls in milliseconds for this playback. See
      Media.WatchTime UMA metrics. Only reported for foreground playbacks.
    </summary>
  </metric>
  <metric name="WatchTime.NativeControlsOn">
    <summary>
      Watch time with native controls in milliseconds for this playback. See
      Media.WatchTime UMA metrics. Only reported for foreground playbacks.
    </summary>
  </metric>
</event>

<event name="Media.EME.RequestMediaKeySystemAccess">
  <owner>xhwang@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Event recorded when RequestMediaKeySystemAccess() is called as part of
    Encrypted Media Extensions (EME) API.
  </summary>
  <metric name="KeySystem">
    <summary>
      The key system passed in requestMediaKeySystemAccess() call.
    </summary>
  </metric>
  <metric name="VideoCapabilities">
    <summary>
      Whether there are any &quot;videoCapabilities&quot;.
    </summary>
  </metric>
  <metric name="VideoCapabilities.HasEmptyRobustness">
    <summary>
      Whether there are any &quot;videoCapabilities&quot; with empty robustness.
    </summary>
  </metric>
  <metric name="VideoCapabilities.HasHwSecureAllRobustness">
    <summary>
      Whether there are any &quot;videoCapabilities&quot; with robustness being
      &quot;HW_SECURE_ALL&quot;.
    </summary>
  </metric>
</event>

<event name="Media.Engagement.SessionFinished">
  <owner>beccahughes@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    The Media Engagement index stores the number of significant media playbacks
    per origin and the number of visits. From that we calculate a Media
    Engagement Score.

    To tweak the scoring function we are logging the total number of significant
    media playbacks, the total number of visits, the calculated engagement score
    and the new number of significant media playbacks that occured this visit.
  </summary>
  <metric name="Engagement.IsHigh">
    <summary>
      Whether the Media Engagement Service considers the score to be high (we
      are using a two threshold approach so there is one threshold to be
      considered high and another one to lose that status to reduce jitter).
    </summary>
  </metric>
  <metric name="Engagement.IsHigh.Changed">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      Whether the IsHigh bit changed during the current session.
    </summary>
  </metric>
  <metric name="Engagement.IsHigh.Changes">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      Counts of IsHigh changing (from 0 to 1 or 1 to 0).
    </summary>
  </metric>
  <metric name="Engagement.IsPreloaded">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      Whether the origin was preloaded (from the chrome://component) as a high
      engagement origin.
    </summary>
  </metric>
  <metric name="Engagement.Score">
    <summary>
      The calculated Media Engagement score for the current origin. The score is
      calculated by dividing the number of significant media playbacks by the
      number of visits. If the number of visits is below 5 then the score will
      be zero. This score is taken from MediaEngagementService.
    </summary>
  </metric>
  <metric name="Playbacks.AudioContextTotal">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      The total number of significant media playbacks on this origin that came
      from WebAudio / AudioContext.
    </summary>
  </metric>
  <metric name="Playbacks.Delta">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      The number of significant media playbacks on this origin during this
      session (a visit to an origin on the same tab). A playback is determined
      significant if it meets certain criteria such as a video size of at least
      200x140px, is not muted, is playing, etc.
    </summary>
  </metric>
  <metric name="Playbacks.MediaElementTotal">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      The total number of significant media playbacks on this origin that came
      from media elements.
    </summary>
  </metric>
  <metric name="Playbacks.SecondsSinceLast">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      The number of seconds between significant media playback on the last visit
      and significant media playback on the current visit. If there was no
      previous visit or significant media playback this visit it will be 0.
    </summary>
  </metric>
  <metric name="Playbacks.Total">
    <summary>
      The total number of significant media playbacks on this origin.
    </summary>
  </metric>
  <metric name="Player.Audible.Delta">
    <summary>
      The number of unique audio/video players on a page that was audible (made
      sound) during a visit.
    </summary>
  </metric>
  <metric name="Player.Audible.Total">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      The delta from above but instead of a single visit, the total of all
      deltas for all visits on this origin.
    </summary>
  </metric>
  <metric name="Player.Significant.Delta">
    <summary>
      The number of unique audio/video players on a page that was audible (made
      sound) and considered significant (played for at least 7 seconds) during a
      visit.
    </summary>
  </metric>
  <metric name="Player.Significant.Total">
    <obsolete>
      Deprecated 8/19 as part of https://crbug.com/998685
    </obsolete>
    <summary>
      The delta from above but instead of a single visit, the total of all
      deltas for all visits on this origin.
    </summary>
  </metric>
  <metric name="Visits.Total">
    <summary>
      The total number of visits to this origin.
    </summary>
  </metric>
</event>

<event name="Media.Engagement.ShortPlaybackIgnored">
  <owner>beccahughes@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    The Media Engagement index stores the number of significant media playbacks
    per origin and the number of audible players. From that we calculate a Media
    Engagement Score.

    Media with a short playback length is ignored so we are logging any time the
    player is ignored with the length in msec. This will allow us to identify
    whether sites are being penalized or there is abuse and allow us to tweak
    the length considered &quot;short&quot;.
  </summary>
  <metric name="Length"/>
</event>

<event name="Media.Learning.PredictionRecord">
  <owner>liberato@chromium.org</owner>
  <summary>
    A record of some predicted value vs. an observation. If the prediction is
    for a regression-style task (e.g., &quot;predict a number&quot; rather than
    &quot;predict an enum value&quot;), then the predicted and observed values
    are the numeric values, scaled by default to be in the integer range 0-100.

    The exact scaling used depends on the particular regression problem. Please
    see the LearningTask structure for the task of interest to find out how it
    maps values into the [0, 100] output range.

    A record is created for every prediction separately.

    For example, in the MediaCapabilities experiments, each playback generates a
    record. The predicted / observed values are the ratio of dropped to decoded
    frames, expressed as a percentage scaled to 0-100.
  </summary>
  <metric name="LearningTask">
    <summary>
      The learning task to which this record applies. This is a persistent hash
      of the |name| field in the LearningTask. Presumably, you'll want to
      include only records of a particular task when analyzing results.
    </summary>
  </metric>
  <metric name="ObservedValue">
    <summary>
      Observed value for this sample, scaled into the range [0, 100]. The exact
      scaling factor depends on the particular task.

      MediaCapabilities, for example, reports 100 * percentage_of_dropped_frames
      in this field.
    </summary>
  </metric>
  <metric name="PredictedValue">
    <summary>
      Predicted value for this sample, scaled into the range [0, 100]. The exact
      scaling factor depends on the particular task.

      MediaCapabilities, for example, reports 100 * percentage_of_dropped_frames
      in this field.
    </summary>
  </metric>
  <metric name="TrainingDataSize">
    <summary>
      Number of training examples that were used to train this model.
    </summary>
  </metric>
  <metric name="TrainingDataTotalWeight">
    <summary>
      Total weight of all examples that were used to train this model.
    </summary>
  </metric>
</event>

<event name="Media.SiteMuted" singular="True">
  <owner>steimel@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Event recorded when a website tries to play audio but is muted by the sound
    content setting.
  </summary>
  <metric name="MuteReason">
    <summary>
      Enum value giving the reason the site was muted. Defined as
      |SoundContentSettingObserver::MuteReason|.
    </summary>
  </metric>
</event>

<event name="Media.VideoDecodePerfRecord">
  <owner>chcunningham@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    A record of decoding performance metrics from a video playback with the
    given stream characteristics (profile, resolution, fps). Also includes what
    Media Capabilities API would claim for such a stream as a means of assessing
    the API's accuracy.
  </summary>
  <metric name="Perf.ApiWouldClaimIsPowerEfficient">
    <summary>
      Boolean signaling whether MediaCapabilities would classify streams with
      these characteristics as power efficient prior to considering this latest
      record. MediaCapabilities prediction is accurate when this value matches
      RecordIsPowerEfficient.
    </summary>
  </metric>
  <metric name="Perf.ApiWouldClaimIsSmooth">
    <summary>
      Boolean signaling whether MediaCapabilities would classify streams with
      these characteristics as smooth prior to considering this latest record.
      MediaCapabilities prediction is accurate when this value matches
      RecordIsSmooth.
    </summary>
  </metric>
  <metric name="Perf.PastVideoFramesDecoded">
    <summary>
      Integer count of past video frames decoded for the given video type.
    </summary>
  </metric>
  <metric name="Perf.PastVideoFramesDropped">
    <summary>
      Integer count of past video frames dropped for the given video type.
    </summary>
  </metric>
  <metric name="Perf.PastVideoFramesPowerEfficient">
    <summary>
      Integer count of past video frames power efficient for the given video
      type.
    </summary>
  </metric>
  <metric name="Perf.RecordIsPowerEfficient">
    <summary>
      Boolean signaling whether MediaCapabilities would classify this isolated
      playback record as power efficient.
    </summary>
  </metric>
  <metric name="Perf.RecordIsSmooth">
    <summary>
      Boolean signaling whether MediaCapabilities would classify this isolated
      playback record as smooth.
    </summary>
  </metric>
  <metric name="Perf.VideoFramesDecoded">
    <summary>
      Integer count of the video frames decoded in this record.
    </summary>
  </metric>
  <metric name="Perf.VideoFramesDropped">
    <summary>
      Integer count of the video frames dropped in this record. Should not
      exceed VideoFramesDecoded.
    </summary>
  </metric>
  <metric name="Perf.VideoFramesPowerEfficient">
    <summary>
      Integer count of the video frames decoded via power efficient means in
      this record. Should not exceed VideoFramesDecoded.
    </summary>
  </metric>
  <metric name="Video.CodecProfile">
    <summary>
      media::VideoCodecProfile enum value. Can be VIDEO_CODEC_PROFILE_UNKNOWN if
      we don't know the video codec.
    </summary>
  </metric>
  <metric name="Video.EME.KeySystem">
    <summary>
      Name of the KeySystem used during for an encrypted (EME) playback. Will be
      unset when EME is not used.
    </summary>
  </metric>
  <metric name="Video.EME.UseHwSecureCodecs">
    <summary>
      Boolean indicating whether content decryption module (CDM) was configured
      to use hardware secure decoding. May be true or false for EME playbacks.
      Will be unset for non-EME playbacks.
    </summary>
  </metric>
  <metric name="Video.FramesPerSecond">
    <summary>
      Integer representing video frames per second. This is the cadence of video
      frames as described by stream timestamps multiplied by
      HTMLMediaELement.playbackRate.
    </summary>
  </metric>
  <metric name="Video.InTopFrame">
    <summary>
      Flag indicating whether the record comes from the top frame or some inner
      frame. For privacy, metrics from inner frames are recorded with the top
      frame's origin, so this flag helps separate top frame vs. embedded
      playbacks.
    </summary>
  </metric>
  <metric name="Video.NaturalHeight">
    <summary>
      Integer representing height of video natural size.
    </summary>
  </metric>
  <metric name="Video.NaturalWidth">
    <summary>
      Integer representing width of video natural size.
    </summary>
  </metric>
  <metric name="Video.PlayerID">
    <summary>
      ID which corresponds to a given WebMediaPlayerImpl instance. May be linked
      with Media.WebMediaPlayerState events to understand playback more deeply.
    </summary>
  </metric>
</event>

<event name="Media.WatchTime">
  <obsolete>
    Deprecated 8/2017 in favor Media.BasicPlayback
  </obsolete>
  <owner>dalecurtis@chromium.org</owner>
  <summary>
    Watch time is defined as the amount of elapsed media time for audio+video
    media aggregated per player instance. A minimum of 7 seconds of unmuted,
    foreground media must be watched to start watch time monitoring. Watch time
    is checked on a regular basis and reported upon one of the stop events
    mentioned below or at player destruction if none occur prior.

    Any one of paused, hidden, or muted is sufficient to stop watch time metric
    reports. Each of these has a hysteresis where if the state change is undone
    within some time, the watch time will be counted as uninterrupted.

    Power events (on/off battery power) have a similar hysteresis, but unlike
    the aforementioned properties, will not stop metric collection.

    Native controls events have a similar behavior than power events.

    Each seek event will result in a new watch time metric being started and the
    old metric finalized as accurately as possible.
  </summary>
  <metric name="Audio.AC"/>
  <metric name="Audio.All"/>
  <metric name="Audio.Battery"/>
  <metric name="Audio.EME"/>
  <metric name="Audio.MSE"/>
  <metric name="Audio.NativeControlsOff"/>
  <metric name="Audio.NativeControlsOn"/>
  <metric name="Audio.SRC"/>
  <metric name="AudioVideo.AC"/>
  <metric name="AudioVideo.All"/>
  <metric name="AudioVideo.Background.AC"/>
  <metric name="AudioVideo.Background.All"/>
  <metric name="AudioVideo.Background.Battery"/>
  <metric name="AudioVideo.Background.EME"/>
  <metric name="AudioVideo.Background.MSE"/>
  <metric name="AudioVideo.Background.SRC"/>
  <metric name="AudioVideo.Battery"/>
  <metric name="AudioVideo.DisplayFullscreen"/>
  <metric name="AudioVideo.DisplayInline"/>
  <metric name="AudioVideo.DisplayPictureInPicture"/>
  <metric name="AudioVideo.EME"/>
  <metric name="AudioVideo.MSE"/>
  <metric name="AudioVideo.NativeControlsOff"/>
  <metric name="AudioVideo.NativeControlsOn"/>
  <metric name="AudioVideo.SRC"/>
</event>

<event name="Media.WebAudio.AudioContext.AudibleTime">
  <owner>hongchan@chromium.org</owner>
  <owner>rtoy@chromium.org</owner>
  <owner>webaudio-dev@chromium.org</owner>
  <summary>
    Records the AudioContext audible time information.
  </summary>
  <metric name="AudibleTime">
    <summary>
      Audible time in milliseconds for this event.
    </summary>
  </metric>
  <metric name="IsMainFrame">
    <summary>
      Indicates whether the event is fired from main frame.
    </summary>
  </metric>
</event>

<event name="Media.WebMediaPlayerState">
  <owner>dalecurtis@chromium.org</owner>
  <owner>media-dev@chromium.org</owner>
  <summary>
    Final state of WebMediaPlayerImpl instance. Records only immutable playback
    properties. Contains a PlaybackID which links to Media.BasicPlayback events.
  </summary>
  <metric name="ContainerName">
    <summary>
      media::container_names::MediaContainerName enum value. Only recorded for
      !IsMSE src=URL playbacks, this is the container of the media being played
      back; E.g., mp4, avi, mp3, etc.
    </summary>
  </metric>
  <metric name="FinalPipelineStatus">
    <summary>
      media::PipelineStatus enum value. Always 0 if the playback succeeded; all
      other values indicate the playback ended in an error.
    </summary>
  </metric>
  <metric name="IsEME">
    <summary>
      Boolean value indicating if this event is for an EME playback. Note: EME
      can be attached anytime during the lifecycle of a WebMediaPlayerImpl, but
      once attached can't be removed.
    </summary>
  </metric>
  <metric name="IsMSE">
    <summary>
      Boolean value indicating if this event is for an MSE playback. If false it
      means this was a SRC playback.
    </summary>
  </metric>
  <metric name="IsTopFrame">
    <summary>
      Flag indicating whether the report comes from the top frame or some inner
      frame. For privacy, metrics from inner frames are recorded with the top
      frame's origin, so this flag helps separate top frame vs. embedded
      playbacks.
    </summary>
  </metric>
  <metric name="PlayerID">
    <summary>
      ID which corresponds to a given WebMediaPlayerImpl instance. May be linked
      with Media.BasicPlayback events to understand a playback more deeply.
    </summary>
  </metric>
  <metric name="TimeToFirstFrame">
    <summary>
      Time in milliseconds from when WebMediaPlayerImpl starts loading until the
      first video frame has been shown.
    </summary>
  </metric>
  <metric name="TimeToMetadata">
    <summary>
      Time in milliseconds from when WebMediaPlayerImpl starts loading until
      metadata is known.
    </summary>
  </metric>
  <metric name="TimeToPlayReady">
    <summary>
      Time in milliseconds from when WebMediaPlayerImpl starts loading until it
      has buffered enough to start playback.
    </summary>
  </metric>
  <metric name="URLScheme">
    <summary>
      media::mojom::MediaURLScheme enum value. Only recorded for !IsMSE src=URL
      playbacks, this is the scheme of that URL; E.g., http, https, filesystem,
      etc.
    </summary>
  </metric>
</event>

<event name="MediaRouter.TabMirroringStarted">
  <owner>takumif@chromium.org</owner>
  <owner>openscreen-eng@google.com</owner>
  <summary>
    Recorded whenever user starts a tab mirroring session via Media Router.
  </summary>
  <metric name="AudioState" enum="WebContentsAudioState">
    <summary>
      The audio playback state of the WebContents at the start of the tab
      mirroring session.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="Memory.Experimental">
  <owner>erikchen@chromium.org</owner>
  <owner>ssid@chromium.org</owner>
  <summary>
    Metrics associated with memory consumption, in MB.
  </summary>
  <metric name="ArrayBuffer">
    <summary>
      Measure of memory consumed by Array Buffer.
    </summary>
  </metric>
  <metric name="BlinkGC">
    <summary>
      Measure of memory consumed by Oilpan.
    </summary>
  </metric>
  <metric name="BlinkGC.AllocatedObjects">
    <summary>
      Measure of memory consumed by live allocations made from Oilpan.
    </summary>
  </metric>
  <metric name="CommandBuffer">
    <summary>
      Measure of memory consumed by GL command buffer.
    </summary>
  </metric>
  <metric name="Discardable">
    <summary>
      Measure of memory consumed by Discardable memory service.
    </summary>
  </metric>
  <metric name="DownloadService">
    <summary>
      Measure of memory used by download service.
    </summary>
  </metric>
  <metric name="Extensions.ValueStore">
    <summary>
      Measure of memory consumed by Key Value Store databases of extensions.
    </summary>
  </metric>
  <metric name="FontCaches">
    <summary>
      Measure of memory used by font platform and shape caches in renderer
      process.
    </summary>
  </metric>
  <metric name="GpuMemory">
    <summary>
      Measure of GPU memory used by Chrome.
    </summary>
  </metric>
  <metric name="History">
    <summary>
      Approximate measure of memory consumed by History service.
    </summary>
  </metric>
  <metric name="IsVisible">
    <summary>
      Indicates whether the tab is visible or not at the time of metric
      collection.
    </summary>
  </metric>
  <metric name="JavaHeap">
    <summary>
      Measure of memory consumed by java heap on Android.
    </summary>
  </metric>
  <metric name="LevelDatabase">
    <summary>
      Measure of memory consumed by unaccounted level databases.
    </summary>
  </metric>
  <metric name="Malloc">
    <summary>
      Measure of memory allocated by malloc, that is not classified by other
      metrics.
    </summary>
  </metric>
  <metric name="Malloc.AllocatedObjects">
    <summary>
      Measure of total memory used by objects allocated using malloc.
    </summary>
  </metric>
  <metric name="Net">
    <summary>
      Measure of memory allocated by network sockets and caches.
    </summary>
  </metric>
  <metric name="Net.UrlRequestContext">
    <summary>
      Measure of memory allocated by all network requests.
    </summary>
  </metric>
  <metric name="NumberOfAdSubframes">
    <summary>
      The number of ad subframes that the associated renderer owns.
    </summary>
  </metric>
  <metric name="NumberOfDetachedScriptStates">
    <summary>
      The number of detached ScriptState that the associated renderer owns.
    </summary>
  </metric>
  <metric name="NumberOfDocuments">
    <summary>
      The number of documents that the associated renderer owns.
    </summary>
  </metric>
  <metric name="NumberOfExtensions">
    <summary>
      The number of extensions that are served from the associated renderer
      process.
    </summary>
  </metric>
  <metric name="NumberOfFrames">
    <summary>
      The number of frames that the associated renderer owns.
    </summary>
  </metric>
  <metric name="NumberOfLayoutObjects">
    <summary>
      The number of layout objects that the associated renderer owns.
    </summary>
  </metric>
  <metric name="NumberOfMojoHandles">
    <summary>
      The number of mojo handles stored in HandleTable.
    </summary>
  </metric>
  <metric name="NumberOfNodes">
    <summary>
      The number of nodes that the associated renderer owns.
    </summary>
  </metric>
  <metric name="OmniboxSuggestions">
    <summary>
      Measure of memory used due to URL indexing and autocomplete suggestions.
    </summary>
  </metric>
  <metric name="PartitionAlloc">
    <summary>
      Measure of memory allocated by PartitionAlloc allocator.
    </summary>
  </metric>
  <metric name="PartitionAlloc.AllocatedObjects">
    <summary>
      Measure of total memory used by objects allocated using PartitionAlloc.
    </summary>
  </metric>
  <metric name="PartitionAlloc.Partitions.ArrayBuffer">
    <summary>
      Measure of memory used by Array Buffer partition in PartitionAlloc.
    </summary>
  </metric>
  <metric name="PartitionAlloc.Partitions.Buffer">
    <summary>
      Measure of memory used by Buffer partition in PartitionAlloc.
    </summary>
  </metric>
  <metric name="PartitionAlloc.Partitions.FastMalloc">
    <summary>
      Measure of memory used by Fast Malloc partition in PartitionAlloc.
    </summary>
  </metric>
  <metric name="PartitionAlloc.Partitions.Layout">
    <summary>
      Measure of memory used by Layout partition in PartitionAlloc.
    </summary>
  </metric>
  <metric name="PrivateMemoryFootprint">
    <summary>
      Measure of total private memory consumed by process.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.ProcessType"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PrivateSwapFootprint">
    <summary>
      Measure of private swap memory consumed by a process. Available on Linux
      and Android.
    </summary>
  </metric>
  <metric name="ProcessType">
    <summary>
      Type of process (e.g. browser, renderer, GPU --- see
      services/resource_coordinator/public/mojom/memory_instrumentation/memory_instrumentation.mojom)
      of associated metrics.
    </summary>
    <aggregation>
      <history>
        <statistics export="False">
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Resident">
    <summary>
      Size of process' working set.
    </summary>
  </metric>
  <metric name="SharedMemoryFootprint">
    <summary>
      Measure of total shared memory consumed by process.
    </summary>
  </metric>
  <metric name="SiteStorage">
    <summary>
      Measure of memory used due to web storage APIs in browser process.
    </summary>
  </metric>
  <metric name="SiteStorage.BlobStorage">
    <summary>
      Measure of memory used by in-memory blob file API in browser process.
    </summary>
  </metric>
  <metric name="SiteStorage.IndexDB">
    <summary>
      Measure of memory used due to IndexedDB API in browser process.
    </summary>
  </metric>
  <metric name="SiteStorage.LocalStorage">
    <summary>
      Measure of memory used due to Local Storage API in browser process.
    </summary>
  </metric>
  <metric name="SiteStorage.SessionStorage">
    <summary>
      Measure of memory used due to Session Storage API in browser process.
    </summary>
  </metric>
  <metric name="Skia">
    <summary>
      Measure of memory used by Skia.
    </summary>
  </metric>
  <metric name="Skia.SkGlyphCache">
    <summary>
      Measure of memory used by Skia Glyph Cache.
    </summary>
  </metric>
  <metric name="Skia.SkResourceCache">
    <summary>
      Measure of memory used by Skia Resource Cache.
    </summary>
  </metric>
  <metric name="Sqlite">
    <summary>
      Measure of memory used by all sqlite databases.
    </summary>
  </metric>
  <metric name="Sync">
    <summary>
      Measure of memory used by Sync storage.
    </summary>
  </metric>
  <metric name="TabRestore">
    <summary>
      Approximate measure of memory used by Tab restore service.
    </summary>
  </metric>
  <metric name="TimeSinceLastNavigation">
    <summary>
      The time in seconds since the Tab navigated. Only emitted for tabs that
      are not sharing a process.
    </summary>
  </metric>
  <metric name="TimeSinceLastVisibilityChange">
    <summary>
      The time in seconds since the Tab changed visibility. Only emitted for
      tabs that are not sharing a process.
    </summary>
  </metric>
  <metric name="Total2.PrivateMemoryFootprint">
    <summary>
      Measure of total private memory consumed by all processes.
    </summary>
  </metric>
  <metric name="Total2.SharedMemoryFootprint">
    <summary>
      Measure of total shared memory consumed by all processes.
    </summary>
  </metric>
  <metric name="UI">
    <summary>
      Measure of memory used by Android UI bitmaps.
    </summary>
  </metric>
  <metric name="Uptime">
    <summary>
      Process uptime.
    </summary>
  </metric>
  <metric name="V8">
    <summary>
      Measure of memory consumed by V8.
    </summary>
  </metric>
  <metric name="V8.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in V8.
    </summary>
  </metric>
  <metric name="V8.Main">
    <summary>
      Measure of memory consumed by the main isolate of V8.
    </summary>
  </metric>
  <metric name="V8.Main.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the main isolate of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap">
    <summary>
      Measure of memory consumed by the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.CodeLargeObjectSpace">
    <summary>
      Measure of memory consumed by the code large object space of the main heap
      of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.CodeLargeObjectSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the code large object space
      of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.CodeSpace">
    <summary>
      Measure of memory consumed by the code space of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.CodeSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the code space of the main
      heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.LargeObjectSpace">
    <summary>
      Measure of memory consumed by the large object space of the main heap of
      V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.LargeObjectSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the large object space of
      the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.MapSpace">
    <summary>
      Measure of memory consumed by the map space of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.MapSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the map space of the main
      heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.NewLargeObjectSpace">
    <summary>
      Measure of memory consumed by the new large object space of the main heap
      of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.NewLargeObjectSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the new large object space
      of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.NewSpace">
    <summary>
      Measure of memory consumed by the new space of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.NewSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the new space of the main
      heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.OldSpace">
    <summary>
      Measure of memory consumed by the old space of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.OldSpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the old space of the main
      heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.ReadOnlySpace">
    <summary>
      Measure of memory consumed by the read-only space of the main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Heap.ReadOnlySpace.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in the read-only space of the
      main heap of V8.
    </summary>
  </metric>
  <metric name="V8.Main.Malloc">
    <summary>
      Measure of memory allocated by malloc in the main isolate of V8.
    </summary>
  </metric>
  <metric name="V8.Workers">
    <summary>
      Measure of memory consumed by worker isolates of V8.
    </summary>
  </metric>
  <metric name="V8.Workers.AllocatedObjects">
    <summary>
      Measure of memory consumed by live objects in worker isolates of V8.
    </summary>
  </metric>
  <metric name="WebCache">
    <summary>
      Measure of memory consumed by all resources in Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.CSSStylesheetResources">
    <summary>
      Measure of memory consumed by CSS Stylesheet resources in Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.EncodedSizeDuplicatedInDataUrls">
    <summary>
      Measure of memory consumed by data URLs of Image resources in Blink Web
      Cache.
    </summary>
  </metric>
  <metric name="WebCache.FontResources">
    <summary>
      Measure of memory consumed by Font resources in Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.ImageResources">
    <summary>
      Measure of memory consumed by Image resources in Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.OtherResources">
    <summary>
      Measure of memory consumed by other resources in Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.ScriptResources">
    <summary>
      Measure of memory consumed by Script resources in Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.V8CodeCache">
    <summary>
      Measure of memory consumed by V8 code cache held by Script resources in
      Blink Web Cache.
    </summary>
  </metric>
  <metric name="WebCache.XSLStylesheetResources">
    <summary>
      Measure of memory consumed by XSL Stylesheet resources in Blink Web Cache.
    </summary>
  </metric>
</event>

<event name="Memory.TabFootprint">
  <owner>tommckee@chromium.org</owner>
  <summary>
    Measure of memory used by the processes that host an instance of a tab.
    Intended as a high-level metric for analyzing effective memory use of
    individual sites.
  </summary>
  <metric name="MainFrameProcessPMF">
    <summary>
      Measure of private memory, in MB, consumed by the render process dedicated
      to hosting the main frame. Undefined if the main frame is hosted by a
      render process used by other tabs. If this is undefined, TabPMF will be
      undefined.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="SubFrameProcessPMF.Excluded">
    <summary>
      Number of render processes that were blocked from contributing to
      SubFrameProcessPMF.Total. A process can have its contribution blocked if
      the process has responsiblities outside the scope of the relevant tab. If
      this is non-zero, TabPMF will be undefined.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="SubFrameProcessPMF.Included">
    <summary>
      Number of render processes that contributed to SubFrameProcessPMF.Total.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="SubFrameProcessPMF.Total">
    <summary>
      Measure of total private memory, in MB, consumed by the render processes
      dedicated to hosting sub-frames of the tab. Note that, if a render process
      hosts frames of other tabs, it isn't considered to be 'dedicated' and so
      it doesn't contribute to this total.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="TabPMF">
    <summary>
      Measure of private memory, in MB, consumed by all render processes
      dedicated to hosting some part of a tab. Undefined if there are processes
      responsible for hosting parts of this tab while hosting parts of other
      tabs.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="MixedContentAutoupgrade.ResourceRequest">
  <owner>carlosil@chromium.org</owner>
  <summary>
    Status and Network error or HTTP response code for a resource request that
    was autoupgraded to HTTPS as part of the mixed content autoupgrade
    experiment.
  </summary>
  <metric name="Code">
    <summary>
      The HTTP response or network error code for an autoupgraded request.
    </summary>
  </metric>
  <metric name="Status">
    <summary>
      An enum with 0 representing started, 1 failed, and 2 response received.
    </summary>
  </metric>
</event>

<event name="MobileMenu.FindInPage">
  <owner>frechette@chromium.org</owner>
  <summary>
    User pressed 'Find in page' in the app menu.
  </summary>
  <metric name="HasOccurred" enum="Boolean">
    <summary>
      A boolean signaling that the event has occurred (typically only records
      true values).
    </summary>
  </metric>
</event>

<event name="NavigationPredictorAnchorElementMetrics">
  <owner>ryansturm@chromium.org</owner>
  <summary>
    Metrics that describe an anchor element's data. This event is emitted at
    most 10 times per page load, once for each of the top n URLs on a page, and
    the order of the events is randomized. If there is no nth anchor element, no
    value is returned.
  </summary>
  <metric name="AnchorIndex">
    <summary>
      The index of the clicked-on anchor element in NavigationPredictor's
      |top_urls_|.
    </summary>
  </metric>
  <metric name="ContainsImage">
    <summary>
      1 if the anchor element contains an image.
    </summary>
  </metric>
  <metric name="IsInIframe">
    <summary>
      1 if the anchor element is in an iframe.
    </summary>
  </metric>
  <metric name="IsURLIncrementedByOne">
    <summary>
      1 if the anchor element's target URL and the document's source URL only
      differ by one number, and the target URL increments that number in the
      source URL by 1.
    </summary>
  </metric>
  <metric name="PercentClickableArea">
    <summary>
      The percent of the total document area that this anchor element's
      clickable area occupies.
    </summary>
  </metric>
  <metric name="PercentVerticalDistance">
    <summary>
      How far down the document the top of the anchor element is, expressed as a
      ratio with the total document height.
    </summary>
  </metric>
  <metric name="SameOrigin">
    <summary>
      1 if the anchor element's target URL and the document's source URL are the
      same origin.
    </summary>
  </metric>
</event>

<event name="NavigationPredictorPageLinkClick">
  <owner>ryansturm@chromium.org</owner>
  <summary>
    Sent on an in-page link click. An integer from 0-10 (1-indexed),
    corresponding to the index of that anchor element in the list of top ten
    anchor elements on that page, sorted by their navigation scores. If an
    anchor element is clicked that is not on the top ten list, 0 is returned.
  </summary>
  <metric name="AnchorElementIndex"/>
</event>

<event name="NavigationPredictorPageLinkMetrics" singular="True">
  <owner>ryansturm@chromium.org</owner>
  <summary>
    Metrics that describe aggregate information about the links within a page.
    Some anchor elements present on a page may not be represented in these
    metrics, if they are outside the viewport or if their placement in the page
    is after the 40th anchor element. This event is emitted at most once per
    page load. Unless otherwise specified, each of the aggregate metrics is
    bucketted with exponential buckets of size 1.3.
  </summary>
  <metric name="MedianLinkLocation">
    <summary>
      The median vertical link location in the viewport, as a ratio of the
      distance from the top of the link to the visible top of the page.
      Bucketted with a linear bucket size of 10.
    </summary>
  </metric>
  <metric name="NumberOfAnchors.ContainsImage">
    <summary>
      The total number of links in the page that are images.
    </summary>
  </metric>
  <metric name="NumberOfAnchors.InIframe">
    <summary>
      The total number of links in the page in any iframe.
    </summary>
  </metric>
  <metric name="NumberOfAnchors.SameHost">
    <summary>
      The total number of links in the page that point to the same origin as the
      current page's origin.
    </summary>
  </metric>
  <metric name="NumberOfAnchors.Total">
    <summary>
      The total number of links within a page.
    </summary>
  </metric>
  <metric name="NumberOfAnchors.URLIncremented">
    <summary>
      The total number of links on the page, where each link only differs from
      the current page's URL by a number, and that number is incremented by 1 in
      the link.
    </summary>
  </metric>
  <metric name="TotalClickableSpace">
    <summary>
      The total clickable space in the entire page, expressed as a ratio of the
      visible clickable region to the entire viewport region.
    </summary>
  </metric>
  <metric name="Viewport.Height">
    <summary>
      The height of the viewport, in pixels.
    </summary>
  </metric>
  <metric name="Viewport.Width">
    <summary>
      The width of the viewport, in pixels.
    </summary>
  </metric>
</event>

<event name="Net.LegacyTLSVersion">
  <owner>davidben@chromium.org</owner>
  <summary>
    Recorded when a resource is loaded using TLS 1.0 or TLS 1.1.
  </summary>
  <metric name="IsAdResource">
    <summary>
      Boolean value representing whether the request is for an ad resource. Only
      set if IsSubresource is true.
    </summary>
  </metric>
  <metric name="IsMainFrame">
    <summary>
      Boolean value representing whether the request is in the main frame or not
      (if false, the request is from a subframe).
    </summary>
  </metric>
  <metric name="IsSubresource">
    <summary>
      Boolean value representing whether the request is for a subresource. If
      false, then the request was a main frame page load.
    </summary>
  </metric>
</event>

<event name="NoStatePrefetch" singular="True">
  <owner>tbansal@chromium.org</owner>
  <summary>
    Metrics related to NoStatePrefetch that are recorded using the same UKM IDs
    as PageLoad.
  </summary>
  <metric name="PrefetchedRecently.FinalStatus">
    <summary>
      Final status of the nostate prefetch if one was recently attempted for
      either the committed URL of this navigation or for any URL in the redirect
      chain for the main frame resource for this navigation. page. Recorded as
      enum PrerenderFinalStatus in //tools/metrics/histograms/enums.xml.
    </summary>
  </metric>
  <metric name="PrefetchedRecently.Origin">
    <summary>
      Triggering origin of the nostate prefetch if one was recently attempted
      for either the committed URL of this navigation or for any URL in the
      redirect chain for the main frame resource for this navigation. Recorded
      as enum PrerenderOrigin in //tools/metrics/histograms/enums.xml.
    </summary>
  </metric>
  <metric name="PrefetchedRecently.PrefetchAge">
    <summary>
      Records the time (in milliseconds) from the start of the nostate prefetch
      to the time of commit of this navigation. Metric is recorded down to the
      nearest power of 2. Recorded only if a nostate prefetch was recently
      attempted for either the committed URL of this navigation or for any URL
      in the redirect chain for the main frame resource for this navigation.
    </summary>
  </metric>
</event>

<event name="Notification">
  <owner>peter@chromium.org</owner>
  <summary>
    A notification event corresponds with the entire lifespan of a single
    notification, and will be logged to UKM when the notification is deleted
    from the notification database.
  </summary>
  <metric name="ClosedReason">
    <summary>
      Enum for how the notification was closed. {user, developer, unknown}
    </summary>
  </metric>
  <metric name="DidReplaceAnotherNotification">
    <summary>
      Boolean value representing whether a tag is present and a previously shown
      notification has been replaced. For UKM logging, we treat a replacement
      notification as a new notification.
    </summary>
  </metric>
  <metric name="DidUserOpenSettings">
    <summary>
      Boolean value indicating whether the user accessed the Chrome provided
      settings from the notification.
    </summary>
  </metric>
  <metric name="HasBadge">
    <summary>
      Boolean value representing if a badge URL was included.
    </summary>
  </metric>
  <metric name="HasIcon">
    <summary>
      Boolean value representing if an icon URL was included.
    </summary>
  </metric>
  <metric name="HasImage">
    <summary>
      Boolean value representing if an image URL was included.
    </summary>
  </metric>
  <metric name="HasRenotify">
    <summary>
      Boolean value representing whether default notification indicators (sound,
      vibration, light) should be played again if the notification is replacing
      an older notification.
    </summary>
  </metric>
  <metric name="HasTag">
    <summary>
      Boolean value representing if a tag is present.
    </summary>
  </metric>
  <metric name="IsSilent">
    <summary>
      Boolean value representing whether default notification indicators (sound,
      vibration, light) should be suppressed.
    </summary>
  </metric>
  <metric name="NumActionButtonClicks">
    <summary>
      Number of clicks on developer provided action buttons.
    </summary>
  </metric>
  <metric name="NumActions">
    <summary>
      Number of developer specified actions that can be taken.
    </summary>
  </metric>
  <metric name="NumClicks">
    <summary>
      Number of clicks, excluding action buttons. I.e. clicks on the
      notification itself.
    </summary>
  </metric>
  <metric name="RequireInteraction">
    <summary>
      Boolean value representing whether the notification should remain onscreen
      indefinitely, rather than being auto-minimized to the notification center
      (if allowed by platform).
    </summary>
  </metric>
  <metric name="TimeUntilClose">
    <summary>
      The length of time, in ms, between when the notification was triggered and
      when it was closed.
    </summary>
  </metric>
  <metric name="TimeUntilFirstClick">
    <summary>
      Time, in ms, between when the notification is shown and the first click.
    </summary>
  </metric>
  <metric name="TimeUntilLastClick">
    <summary>
      Time, in ms, between when the notification is shown and the last click.
    </summary>
  </metric>
</event>

<event name="OfflinePages.SavePageRequested">
  <obsolete>
    Deprecated 03/2019
  </obsolete>
  <owner>petewil@chromium.org</owner>
  <metric name="RequestedFromForeground">
    <summary>
      Metrics that measure which URLs the user is requesting offline page copies
      of, and whether they were requested from the foreground or background UI.
      The value is 1 if requested from the foreground, 0 from background.
    </summary>
  </metric>
</event>

<event name="OptimizationGuide" singular="True">
  <owner>sophiechang@chromium.org</owner>
  <summary>
    Optimization guide metrics associated with a page load. It is recorded when
    the optimization guide was consulted in making a decision for the page load.
    See //components/optimization_guide/.
  </summary>
  <metric name="HintGenerationTimestamp">
    <summary>
      The timestamp, in seconds from epoch, that the server generated the hint
      for the optimization applied on the page load.
    </summary>
  </metric>
  <metric name="HintSource">
    <summary>
      The |optimization_guide::proto::HintSource| for the optimization that was
      applied on the page load.
    </summary>
  </metric>
  <metric name="PainfulPageLoadModelPredictionScore">
    <summary>
      The score output after evaluating the painful page load model. If
      populated, this is 100x the fractional value output by the model
      evaluation. This will be a value between 0 and 100.
    </summary>
  </metric>
  <metric name="PainfulPageLoadModelVersion">
    <summary>
      The server-generated version of the painful page load model that was
      evaluated for the page load.
    </summary>
  </metric>
</event>

<event name="PageDomainInfo">
  <owner>uthakore@chromium.org</owner>
  <owner>invernizzi@chromium.org</owner>
  <summary>
    Metrics that describe the domain of pages that successfully commit. One
    event is generated per page load that commits. Currently associated with
    LocalNetworkRequests UKM metric collection.
  </summary>
  <metric name="DomainType">
    <summary>
      An enum value representing the type of domain of the loaded page. The enum
      is defined in |LocalNetworkRequestsPageLoadMetricsObserver|. Possible
      values are 0 for unknown (should never be logged), 1 for pages with public
      domains, 2 for pages with private domains (IP addresses that are part of a
      reserved IP space not including localhost), or 4 for localhost.
    </summary>
  </metric>
</event>

<event name="PageForegroundSession">
  <owner>sullivan@chromium.org</owner>
  <summary>
    Total time in foreground in milliseconds, recorded each time the page is
    backgrounded. May be recorded multiple times for a single page visit.
  </summary>
  <metric name="ForegroundDuration">
    <summary>
      Total time in foreground in milliseconds, recorded each time the page is
      backgrounded.
    </summary>
  </metric>
</event>

<event name="PageInfoBubble">
  <owner>chlily@chromium.org</owner>
  <summary>
    Recorded when an action on the Page Info Bubble (aka Origin Info Bubble or
    WebsiteSettings Bubble) is taken. May be recorded multiple times for a
    single page visit.
  </summary>
  <metric name="ActionTaken" enum="WebsiteSettingsAction">
    <summary>
      Records an enum value representing which action on the Page Info Bubble
      was taken.
    </summary>
  </metric>
</event>

<event name="PageLoad" singular="True">
  <owner>bmcquade@chromium.org</owner>
  <summary>
    Core metrics associated with web page loads.
  </summary>
  <metric name="CpuTime">
    <summary>
      Amount of CPU wall time over the duration of a page load, while the page
      is in the foreground. Measured in milliseconds.
    </summary>
  </metric>
  <metric name="DocumentTiming.NavigationToDOMContentLoadedEventFired">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time the DOMContentLoaded event is fired, for main frame
      documents.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="DocumentTiming.NavigationToLoadEventFired">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time the load event is fired, for main frame documents.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Experimental.InputToNavigationStart">
    <summary>
      Measures the time in milliseconds from when the OS level input event
      occurred which triggered a navigation, until the navigation was started.
      Only set if the code can trace back to the original input event. Some
      known cases where it is missing: crbug.com/889223 crbug.com/893162
      crbug.com/897837 crbug.com/897840
    </summary>
  </metric>
  <metric name="Experimental.Navigation.UserInitiated">
    <summary>
      True if this navigation was initiated by user input. For renderer
      navigations, only true if the code can trace back to the original input
      event. Some known cases where it is missing: crbug.com/889223
      crbug.com/897837 crbug.com/897840
    </summary>
  </metric>
  <metric name="Experimental.NavigationToInteractive">
    <summary>
      Measures Time to Interactive, a metric based on main thread and network
      heuristics to approximate the point in time when the page feels
      interactive to the user. See https://goo.gl/TFw6xz for detailed
      explanation. This histogram uses First Meaningful Paint as the lower bound
      for quiescent windows. The unit of time is ms.
    </summary>
  </metric>
  <metric name="Experimental.PaintTiming.NavigationToFirstMeaningfulPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the first meaningful paint (http://bit.ly/ttfmp-doc), for main
      frame documents.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Experimental.PaintTiming.NavigationToLargestContentPaint">
    <obsolete>
      Deprecated 7/2019, replaced by
      PaintTiming.NavigationToLargestContentfulPaint.MainFrame.
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest content (text or
      image) within viewport. See http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric
      name="Experimental.PaintTiming.NavigationToLargestContentPaintAllFrames">
    <obsolete>
      Deprecated 7/2019, replaced by
      PaintTiming.NavigationToLargestContentfulPaint
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest content (text or
      image) within viewport. Compared with NavigationToLargestContentPaint,
      this is the aggregate results from all frames, while
      NavigationToLargestContentPaint is only for main frame. See
      http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric name="Experimental.PaintTiming.NavigationToLargestImagePaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest image within
      viewport after the image finishes loading. The value is recorded at the
      end of each page load. See http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric
      name="Experimental.PaintTiming.NavigationToLargestImagePaint.BeforeUserInput">
    <obsolete>
      Deprecated 01/2019
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest image within
      viewport after the image finishes loading, before user input. See
      http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric name="Experimental.PaintTiming.NavigationToLargestTextPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest text within
      viewport. The value is recorded at the end of each page load. See
      http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric
      name="Experimental.PaintTiming.NavigationToLargestTextPaint.BeforeUserInput">
    <obsolete>
      Deprecated 01/2019
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest text within
      viewport, before user input. See http://bit.ly/fcp_plus_plus for more
      details.
    </summary>
  </metric>
  <metric name="Experimental.PaintTiming.NavigationToLastImagePaint">
    <obsolete>
      Deprecated on March 2019. This metric as a page load metric hasn't shown a
      good correlation with user experience.
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the last image within
      viewport after the image finishes loading. The value is recorded at the
      end of each page load. See http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric name="Experimental.PaintTiming.NavigationToLastTextPaint">
    <obsolete>
      Deprecated on March 2019. This metric as a page load metric hasn't shown a
      good correlation with user experience.
    </obsolete>
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the last Text within
      viewport. The value is recorded at the end of each page load. See
      http://bit.ly/fcp_plus_plus for more details.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputDelay">
    <obsolete>
      Deprecated on January 2019 in favor of InteractiveTiming.FirstInputDelay2,
      which correctly excludes some scrolling cases that were previously not
      excluded from this metric.
    </obsolete>
    <summary>
      Measures First Input Delay, the duration between the hardware timestamp
      and the start of event processing on the main thread for the first
      meaningful input per navigation. See https://goo.gl/tr1oTZ for a detailed
      explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputDelay.SkipFilteringComparison">
    <summary>
      For comparing FirstInputDelay metrics in the SkipTouchEventFilter
      experiment. Measures First Input Delay, the duration between the hardware
      timestamp and the start of event processing on the main thread for the
      first meaningful input per navigation. See https://goo.gl/tr1oTZ for a
      detailed explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputDelay2">
    <obsolete>
      Removed on February 2019 in favor of InteractiveTiming.FirstInputDelay3
      which brings the metric more in line with the EventTiming API.
    </obsolete>
    <summary>
      Measures First Input Delay, the duration between the hardware timestamp
      and the start of event processing on the main thread for the first
      meaningful input per navigation. See https://goo.gl/tr1oTZ for a detailed
      explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputDelay3">
    <obsolete>
      Removed in July 2019 in favor of InteractiveTiming.FirstInputDelay4 which
      includes events which were previously filtered.
    </obsolete>
    <summary>
      Measures First Input Delay, the duration between the hardware timestamp
      and the start of event processing on the main thread for the first
      meaningful input per navigation. See https://goo.gl/tr1oTZ for a detailed
      explanation. In ms.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="InteractiveTiming.FirstInputDelay4">
    <summary>
      Measures First Input Delay, the duration between the hardware timestamp
      and the start of event processing on the main thread for the first
      meaningful input per navigation. See https://goo.gl/tr1oTZ for a detailed
      explanation. In ms.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="InteractiveTiming.FirstInputTimestamp">
    <obsolete>
      Deprecated on January 2019 in favor of
      InteractiveTiming.FirstInputTimestamp2, which correctly excludes some
      scrolling cases that were previously not excluded from this metric.
    </obsolete>
    <summary>
      The duration between navigation start and the hardware timestamp of the
      first meaningful input per navigation. See https://goo.gl/tr1oTZ for a
      detailed explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputTimestamp.SkipFilteringComparison">
    <summary>
      The duration between navigation start and the hardware timestamp of the
      first meaningful input per navigation. See https://goo.gl/tr1oTZ for a
      detailed explanation. In ms.

      This metric is used for comparing FirstInputTimestamp metrics in the
      SkipTouchEventFilter experiment.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputTimestamp2">
    <obsolete>
      Removed on February 2019 in favor of
      InteractiveTiming.FirstInputTimestamp3 which brings the metric more in
      line with the EventTiming API.
    </obsolete>
    <summary>
      The duration between navigation start and the hardware timestamp of the
      first meaningful input per navigation. See https://goo.gl/tr1oTZ for a
      detailed explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputTimestamp3">
    <obsolete>
      Removed in July 2019 in favor of InteractiveTiming.FirstInputTimestamp4
      which includes events which were previously filtered.
    </obsolete>
    <summary>
      The duration between navigation start and the hardware timestamp of the
      first meaningful input per navigation. See https://goo.gl/tr1oTZ for a
      detailed explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.FirstInputTimestamp4">
    <summary>
      The duration between navigation start and the hardware timestamp of the
      first meaningful input per navigation. See https://goo.gl/tr1oTZ for a
      detailed explanation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.LongestInputDelay">
    <obsolete>
      Deprecated on January 2019 in favor of
      InteractiveTiming.LongestInputDelay2, which correctly excludes some
      scrolling cases that were previously not excluded from this metric.
    </obsolete>
    <summary>
      Measures longest Input Delay, the longest duration between the hardware
      timestamp and the start of event processing on the main thread for the
      meaningful input per navigation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.LongestInputDelay2">
    <obsolete>
      Removed on February 2019 in favor of InteractiveTiming.LongestInputDelay3
      which brings the metric more in line with the EventTiming API.
    </obsolete>
    <summary>
      Measures longest Input Delay, the longest duration between the hardware
      timestamp and the start of event processing on the main thread for the
      meaningful input per navigation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.LongestInputDelay3">
    <obsolete>
      Removed on September 2019 in favor of InteractiveTiming.LongestInputDelay4
      which includes events which otherwise would have been filtered.
    </obsolete>
    <summary>
      Measures longest Input Delay, the longest duration between the hardware
      timestamp and the start of event processing on the main thread for the
      meaningful input per navigation. In ms.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="InteractiveTiming.LongestInputDelay4">
    <summary>
      Measures longest Input Delay, the longest duration between the hardware
      timestamp and the start of event processing on the main thread for the
      meaningful input per navigation. In ms.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="InteractiveTiming.LongestInputTimestamp">
    <obsolete>
      Deprecated on January 2019 in favor of
      InteractiveTiming.LongestInputTimestamp2, which correctly excludes some
      scrolling cases that were previously not excluded from this metric.
    </obsolete>
    <summary>
      The duration between navigation start and the hardware timestamp of the
      meaningful input with longest queuing delay per navigation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.LongestInputTimestamp2">
    <obsolete>
      Removed on February 2019 in favor of
      InteractiveTiming.LongestInputTimestamp3 which brings the metric more in
      line with the EventTiming API.
    </obsolete>
    <summary>
      The duration between navigation start and the hardware timestamp of the
      meaningful input with longest queuing delay per navigation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.LongestInputTimestamp3">
    <obsolete>
      Removed on February 2019 in favor of
      InteractiveTiming.LongestInputTimestamp4 which includes inputs which would
      have previously been filtered.
    </obsolete>
    <summary>
      The duration between navigation start and the hardware timestamp of the
      meaningful input with longest queuing delay per navigation. In ms.
    </summary>
  </metric>
  <metric name="InteractiveTiming.LongestInputTimestamp4">
    <summary>
      The duration between navigation start and the hardware timestamp of the
      meaningful input with longest queuing delay per navigation. In ms.
    </summary>
  </metric>
  <metric name="IsCrossProcessNavigation">
    <owner>altimin@chromium.org</owner>
    <owner>arthursonzogni@chromium.org</owner>
    <summary>
      Whether the navigation resulted in the main frame being hosted in a
      different renderer process than the current document or not.
    </summary>
  </metric>
  <metric name="IsSignedExchangeInnerResponse">
    <summary>
      Set to 1 if the main resource is an inner response of a signed exchange.
    </summary>
  </metric>
  <metric name="LayoutInstability.CumulativeShiftScore">
    <summary>
      Measures the cumulative layout shift (bit.ly/lsm-explainer) that has
      occurred on the page (including all subframes) during the session. This
      metric's integral value is 100x the fractional cumulative layout shift
      score described in the explainer.
    </summary>
  </metric>
  <metric name="LayoutInstability.CumulativeShiftScore.MainFrame">
    <summary>
      Measures the cumulative layout shift (bit.ly/lsm-explainer) that has
      occurred in the main frame during the session. This metric's integral
      value is 100x the fractional cumulative layout shift score described in
      the explainer.
    </summary>
  </metric>
  <metric
      name="LayoutInstability.CumulativeShiftScore.MainFrame.BeforeInputOrScroll">
    <summary>
      Measures the cumulative layout shift (bit.ly/lsm-explainer) that has
      occurred in the main frame during the session, before any user input or
      document scroll. This metric's integral value is 100x the fractional
      cumulative layout shift score described in the explainer.
    </summary>
  </metric>
  <metric name="LayoutStability.JankScore">
    <obsolete>
      Removed July 2019 in favor of LayoutInstability.CumulativeShiftScore.
    </obsolete>
    <summary>
      Measures the amount of layout jank (bit.ly/lsm-explainer) that has
      occurred on the page (including all subframes) during the session. This
      metric's integral value is 100x the fractional jank score described in the
      explainer.
    </summary>
  </metric>
  <metric name="LayoutStability.JankScore.MainFrame">
    <obsolete>
      Removed July 2019 in favor of
      LayoutInstability.CumulativeShiftScore.MainFrame.
    </obsolete>
    <summary>
      Measures the amount of layout jank (bit.ly/lsm-explainer) that has
      occurred in the main frame during the session. This metric's integral
      value is 100x the fractional jank score described in the explainer.
    </summary>
  </metric>
  <metric name="LayoutStability.JankScore.MainFrame.BeforeInputOrScroll">
    <obsolete>
      Removed July 2019 in favor of
      LayoutInstability.CumulativeShiftScore.MainFrame.BeforeInputOrScroll.
    </obsolete>
    <summary>
      Measures the amount of layout jank (bit.ly/lsm-explainer) that has
      occurred in the main frame during the session, before any user input or
      document scroll. This metric's integral value is 100x the fractional jank
      score described in the explainer.
    </summary>
  </metric>
  <metric name="MainDocumentSequenceNumber">
    <owner>altimin@chromium.org</owner>
    <owner>arthursonzogni@chromium.org</owner>
    <summary>
      An id for the main frame's document associated with the current
      navigation. It doesn't change for same-document navigations and when
      navigating back to the same document. Unique during the browsing session.
    </summary>
  </metric>
  <metric name="MainFrameResource.ConnectDelay">
    <summary>
      The duration between the start of the connection establishment to the end
      of the connection establishment to the origin of the main frame request.
      In ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.DNSDelay">
    <summary>
      The duration between the start of the DNS resolution to the end for the
      origin of the main frame request. In ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.HttpProtocolScheme">
    <summary>
      HTTP Protocol scheme of the connection using which the main frame response
      was fetched. Recorded as HttpProtocolScheme enum in
      tools/metrics/histograms/enum.xml.
    </summary>
  </metric>
  <metric name="MainFrameResource.NavigationStartToReceiveHeadersStart">
    <summary>
      The duration from the start of the navigation to the start of the response
      headers being received. In ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.NavigationStartToRequestStart">
    <summary>
      The duration from the start of the navigation to the start of the main
      frame request. This includes the time to process any redirects on the main
      frame request. In ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.RedirectCount">
    <summary>
      The number of main frame redirects that occurred before commit. Unset if
      there were no redirects.
    </summary>
  </metric>
  <metric name="MainFrameResource.RequestStartToReceiveHeadersEnd">
    <summary>
      The duration from when the request was started to the time when its
      response headers were received. Recorded only for the main frame request.
      In ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.RequestStartToSendStart">
    <summary>
      The duration from when the request was started to the time when its
      request headers were sent. Recorded only for the main frame request. In
      ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.SendStartToReceiveHeadersEnd">
    <summary>
      The duration from when the request headers were sent to when its response
      headers were received. Recorded only for the main frame request. In ms.
    </summary>
  </metric>
  <metric name="MainFrameResource.SocketReused">
    <summary>
      True if the socket was reused when establishing connection to the origin
      of the main frame request.
    </summary>
  </metric>
  <metric name="Navigation.PageEndReason">
    <summary>
      The |page_load_metrics::PageEndReason| for the main frame navigation of
      this page load.
    </summary>
  </metric>
  <metric name="Navigation.PageTransition">
    <summary>
      The |ui::PageTransition| for the main frame navigation of this page load.
    </summary>
  </metric>
  <metric name="NavigationEntryOffset">
    <owner>altimin@chromium.org</owner>
    <owner>arthursonzogni@chromium.org</owner>
    <summary>
      Difference between the last committed navigation entry index before and
      after the commit of this navigation.
    </summary>
  </metric>
  <metric name="Net.CacheBytes">
    <obsolete>
      Deprecated 06/2019 in favor of Net.CacheBytes2.
    </obsolete>
    <summary>
      The total number of body bytes loaded from cache for all resources on the
      page. This is rounded down to the nearest exponential bucket (with a
      bucket spacing factor of 1.3).
    </summary>
  </metric>
  <metric name="Net.CacheBytes2">
    <summary>
      The total number of body bytes loaded from cache for all resources on the
      page. This includes the http and memory cache. This is rounded down to the
      nearest exponential bucket (with a bucket spacing factor of 1.3).
    </summary>
  </metric>
  <metric name="Net.DownstreamKbpsEstimate.OnNavigationStart">
    <owner>tbansal@chromium.org</owner>
    <summary>
      The downstream throughput (in kilobits per second) for this page load, at
      the time the navigation for this page load was initiated.
    </summary>
  </metric>
  <metric name="Net.EffectiveConnectionType.OnNavigationStart">
    <obsolete>
      Deprecated 7/2017 in favor of
      Net.EffectiveConnectionType2.OnNavigationStart.
    </obsolete>
    <summary>
      The |net::EffectiveConnectionType| at the time the navigation for this
      page load was initiated.
    </summary>
  </metric>
  <metric name="Net.EffectiveConnectionType2.OnNavigationStart">
    <summary>
      The |SystemProfileProto::Network::EffectiveConnectionType| at the time the
      navigation for this page load was initiated.
    </summary>
  </metric>
  <metric name="Net.ErrorCode.OnFailedProvisionalLoad">
    <summary>
      The |net::Error| code for this page load. Only logged for failed
      provisional navigations.
    </summary>
  </metric>
  <metric name="Net.HttpResponseCode">
    <summary>
      The HTTP response code (e.g., 200, 404, etc.) associated with the main
      frame page load.
    </summary>
  </metric>
  <metric name="Net.HttpRttEstimate.OnNavigationStart">
    <summary>
      The HTTP round trip time estimate for this page load, at the time the
      navigation for this page load was initiated.
    </summary>
  </metric>
  <metric name="Net.NetworkBytes">
    <obsolete>
      Deprecated 03/2019 in favor of Net.NetworkBytes2.
    </obsolete>
    <summary>
      The total number of body bytes loaded from the network for all resources
      on the page. This is rounded down to the nearest exponential bucket (with
      a bucket spacing factor of 1.3).
    </summary>
  </metric>
  <metric name="Net.NetworkBytes2">
    <summary>
      The total number of bytes loaded from the network for all resources on the
      page, including incomplete resources and headers. This is rounded down to
      the nearest exponential bucket (with a bucket spacing factor of 1.3). On
      mobile this only records bytes up until the page/app is backgrounded.
    </summary>
  </metric>
  <metric name="Net.TransportRttEstimate.OnNavigationStart">
    <summary>
      The transport round trip time estimate for this page load, at the time the
      navigation for this page load was initiated.
    </summary>
  </metric>
  <metric name="PageTiming.ForegroundDuration">
    <summary>
      For page loads that start in the foreground, measures the duration of time
      in milliseconds until one of the following events occurs: the load of the
      main resource fails, the page load is stopped, the tab hosting the page is
      closed, the render process hosting the page goes away, a new navigation
      which later commits is initiated in the same tab, or the tab hosting the
      page is backgrounded. This metric has a very long tail, for pages that
      spend a long period of time in the foreground. As such, use of the mean or
      tail values are not recommended.
    </summary>
  </metric>
  <metric name="PageTiming.NavigationToFailedProvisionalLoad">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time the provisional load failed. Only measures provisional
      loads that failed in the foreground.
    </summary>
  </metric>
  <metric name="PaintTiming.NavigationToFirstContentfulPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints content. A contentful paint
      includes a paint of text, image, SVG, or canvas.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PaintTiming.NavigationToFirstPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time the first paint is performed.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="PaintTiming.NavigationToLargestContentfulPaint">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest content (text or
      image) within viewport, across all frames. See http://bit.ly/fcp_plus_plus
      for more details.
    </summary>
  </metric>
  <metric name="PaintTiming.NavigationToLargestContentfulPaint.MainFrame">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time when the page first paints the largest content (text or
      image) within viewport, in the main frame. See http://bit.ly/fcp_plus_plus
      for more details.
    </summary>
  </metric>
  <metric name="ParseTiming.NavigationToParseStart">
    <summary>
      Measures the time in milliseconds from navigation timing's navigation
      start to the time the parser started, for main frame documents.
    </summary>
  </metric>
  <metric name="SiteEngagementScore">
    <owner>mcrouse@chromium.org</owner>
    <owner>tbansal@chromium.org</owner>
    <summary>
      Measures the Site Engagement Score for the commited URL rounded to the
      nearest 10.
    </summary>
  </metric>
  <metric name="ThirdPartyCookieBlockingEnabledForSite">
    <summary>
      Records whether third party cookie blocking was enabled for a site. Only
      recorded for users who enabled the cookie controls ui.
    </summary>
  </metric>
  <metric name="WasCached">
    <summary>
      Set to 1 if the main resource was served from cache.
    </summary>
  </metric>
</event>

<event name="PageLoad.FromGoogleSearch" singular="True">
  <owner>bmcquade@chromium.org</owner>
  <owner>mushan@chromium.org</owner>
  <summary>
    Recorded for page loads that were navigated to via Google Search.
  </summary>
</event>

<event name="PageLoad.ServiceWorkerControlled" singular="True">
  <owner>bmcquade@chromium.org</owner>
  <owner>falken@chromium.org</owner>
  <summary>
    Recorded for page loads controlled by a service worker.
  </summary>
</event>

<event name="PageLoadCapping" singular="True">
  <obsolete>
    Deprecated as of 3/2019.
  </obsolete>
  <owner>ryansturm@chromium.org</owner>
  <summary>
    Metrics related to PageLoadCapping that are recorded using the same UKM IDs
    as PageLoad.
  </summary>
  <metric name="FinalState">
    <summary>
      Set to 1 when the InfoBar was shown, but not acted upon. Set to 2 when the
      page was paused, but not resumed. Set to 3 when the page was resumed. If
      the InfoBar was not shown, this metrics is not recorded.
    </summary>
  </metric>
</event>

<event name="PageWithPassword">
  <owner>battre@chromium.org</owner>
  <summary>
    Metrics about websites that contain password forms and the user's
    interactions with them. No events are created for pages that don't contain
    password forms.
  </summary>
  <metric name="FormManagerAvailable">
    <summary>
      Records whether Chrome was sufficiently aware of forms during various
      stages of saving a credential on the site, or whether saving was aborted
      due to absence of the corresponding form manager. Values correspond to the
      enum PasswordManagerMetricsRecorder::FormManagerAvailable.
    </summary>
  </metric>
  <metric name="PageLevelUserAction">
    <summary>
      Records if the user interacts with the password manager in a way that
      cannot (reliably) be attributed to a specific PasswordFormManager. Values
      correspond to the enum
      PasswordManagerMetricsRecorder::PageLevelUserAction.
    </summary>
  </metric>
  <metric name="ProvisionalSaveFailure">
    <summary>
      Records a provisional save failure in case the password manager cannot
      offer to save a credential. Recorded values correspond to the enum
      PasswordManagerMetricsRecorder::ProvisionalSaveFailure.
    </summary>
  </metric>
  <metric name="UserModifiedPasswordField">
    <summary>
      Records a 1 for every page on which a user has modified a password text
      field - regardless of how many password fields a page contains or the user
      modifies.
    </summary>
  </metric>
</event>

<event name="PasswordForm">
  <owner>battre@chromium.org</owner>
  <summary>
    Metrics about password forms on websites and the user's interactions with
    them. A separate event is generated for each password form discovered on a
    site.
  </summary>
  <metric name="Context.FormSignature">
    <summary>
      Records a low entropy hash of the form signature in order to be able to
      distinguish two forms on the same site.
    </summary>
  </metric>
  <metric name="DynamicFormChanges">
    <summary>
      Records a bitmask of password form changes after the first time this form
      is seen by Password Manager. Recorded once per a form when the form is
      removed from DOM. Bit 0 - changes in number of fields, bit 1 - changes in
      fields renderer ids, bit 2 - changes in autocomplete attributes, bit 3 -
      changes in form control types.
    </summary>
  </metric>
  <metric name="Fill.FirstFillingResultInRenderer"
      enum="PasswordManagerFirstRendererFillingResult">
    <summary>
      Records whether the PasswordAutofillAgent in the renderer manages to fill
      credentials as instructed by the browser or records a failure reason
      otherwise. Only the outcome of the first attempt to fill is recorded.

      This is replicated as PasswordManager.FirstFillingResultInRenderer in UMA.
    </summary>
  </metric>
  <metric name="Fill.FirstWaitForUsernameReason"
      enum="PasswordManagerFirstWaitForUsernameReason">
    <summary>
      This metric records why the browser instructs the renderer not to fill the
      credentials on page load but to wait for the user to confirm the
      credential to be filled. Only the value of the first decision to fill is
      recorded.

      This is replicated as PasswordManager.FirstWaitForUsernameReason in UMA.
    </summary>
  </metric>
  <metric name="FillOnLoad">
    <summary>
      Deprecated in November 2018, because the decision this metric supported
      was made. Records the comparison of the old and new decision about filling
      a form on load. Should only be logged for fillig with non-PSL matched
      credentials, in non-Incognito mode. Values are from
      password_manager::PasswordFormMetricsRecorder::FillOnLoad.
    </summary>
  </metric>
  <metric name="Generation.GeneratedPassword">
    <summary>
      Records '1' if the user has generated a password on this form.
    </summary>
  </metric>
  <metric name="Generation.GeneratedPasswordModified">
    <summary>
      Records '1' if the user has modified a generated a password on this form.
    </summary>
  </metric>
  <metric name="Generation.PopupShown">
    <summary>
      Records a PasswordFormMetricsRecorder::PasswordGenerationPopupShown entry
      if (and only if) a popup was shown.
    </summary>
  </metric>
  <metric name="Generation.SpecPriority">
    <obsolete>
      Deprecated 09/2019.
    </obsolete>
    <summary>
      Reports the priority of a PasswordGenerationRequirementsSpec for a
      generated password. This can be used for debugging as a 0 means that no
      spec was used, a 10 means that the spec came from autofill and was crowd
      sourced, a 20 means that it was overridden per domain and a 30 means that
      is was overridden for the form.
    </summary>
  </metric>
  <metric name="ManagerFill.Action">
    <summary>
      Records for each password form (and HTTP auth), whether the password
      manager has filled/provided credentials. Recorded values correspond to the
      enum ManagerAutofillEvent.
    </summary>
  </metric>
  <metric name="ManagerFill.Assistance">
    <summary>
      Records for each successful submission the degree to which the user has
      been assisted by the password manager. Recorded values correspond to the
      enum password_manager::PasswordFormMetricsRecorder::FillingAssistance.
    </summary>
  </metric>
  <metric name="ParsingComparison">
    <obsolete>
      Deprecated 09/2019.
    </obsolete>
    <summary>
      Records comparison result of old and new password form parsing algorithms.
      Metric is recorded on a password form detection. Recorded values
      correspond to the enum
      password_manager::PasswordFormMetricsRecorder::ParsingComparisonResult.
    </summary>
  </metric>
  <metric name="ParsingOnSavingDifference">
    <obsolete>
      Deprecated 09/2019.
    </obsolete>
    <summary>
      Records the comparison of the old and new password form parsing for
      saving. Multiple values from the
      password_manager::PasswordFormMetricsRecorder::ParsingOnSavingDifference
      bitmask can be combined.
    </summary>
  </metric>
  <metric name="ReadonlyWhenFilling">
    <summary>
      Records the readonly status encoded with parsing success after parsing for
      filling. The |value| is constructed as follows: The least significant bit
      says whether parsing succeeded (1) or not (0). The rest, shifted by one
      bit to the right is the FormDataParser::ReadonlyPasswordFields
      representation of the readonly status.
    </summary>
  </metric>
  <metric name="ReadonlyWhenSaving">
    <summary>
      Records the readonly status encoded with parsing success after parsing for
      creating pending credentials. The |value| is constructed the same way as
      for ReadonlyWhenFilling.
    </summary>
  </metric>
  <metric name="Saving.Prompt.Interaction">
    <summary>
      Records how the user interacted with a saving prompt. Recorded values
      correspond to the enum PasswordFormMetricsRecorder::BubbleDismissalReason.
    </summary>
  </metric>
  <metric name="Saving.Prompt.Shown">
    <summary>
      Records, for each password form seen by the password manager, whether the
      user was shown a prompt that asked for permission to save new credentials.
      In case a store() via the Credential Management API, a virtual password
      form is created, for which this metric is recorded. Recorded values are 0
      and 1 for false and true.
    </summary>
  </metric>
  <metric name="Saving.Prompt.Trigger">
    <summary>
      Records the trigger of each password save bubble that was shown to the
      user to ask for permission to save new credentials. Recorded values
      correspond to the enum PasswordFormMetricsRecorder::BubbleTrigger.
    </summary>
  </metric>
  <metric name="Saving.ShowedManualFallbackForSaving">
    <summary>
      Records if a manual fallback for saving option was shown to the user (on
      Android this is recorded, even though the UI does not exist at the
      moment). This is a bit mask. 1 means a prompt was shown, 2 means the
      prompt was due to a generated password, 4 means the prompt was due to an
      update.
    </summary>
  </metric>
  <metric name="Submission.Indicator">
    <summary>
      Records the event that led the password manager to believe the submission
      was successful. Metrics is recorded only when the password is saved.
      Recorded values correspond to the enum
      autofill::mojom::SubmissionIndicatorEvent.
    </summary>
  </metric>
  <metric name="Submission.Observed">
    <summary>
      Records whether a submission of a password form has been observered. The
      values 0 and 1 correspond to false and true respectively.
    </summary>
  </metric>
  <metric name="Submission.SubmissionResult">
    <summary>
      Records the outcome of a password form submission. The values are numbered
      according to PasswordFormMetricsRecorder::SubmitResult. Note that no
      metric is recorded for kSubmitResultNotSubmitted.
    </summary>
  </metric>
  <metric name="Submission.SubmittedFormType">
    <summary>
      Records the classification of a form at submission time. The values
      correspond to PasswordFormMetricsRecorder::SubmittedFormType. Note that no
      metric is recorded for kSubmittedFormTypeUnspecified.
    </summary>
  </metric>
  <metric name="SuppressedAccount.Generated.HTTPSNotHTTP">
    <obsolete>
      Deprecated 03/2019.
    </obsolete>
    <summary>
      Records, for each password form seen by the password manager, whether
      there were `suppressed` credentials, meaning stored credentials that were
      not filled, that were suppressed because they were stored for an HTTPS
      origin while the password form was seen on an HTTP origin. If there were
      such credentials, the histogram also records whether the username and
      password of such suppressed credentials matched those submitted. This
      recording happens only for credentials that were originally auto-generated
      (as opposed to user typed). Recorded values correspond to the enum
      SuppressedAccountExistence.
    </summary>
  </metric>
  <metric name="SuppressedAccount.Generated.PSLMatching">
    <obsolete>
      Deprecated 03/2019.
    </obsolete>
    <summary>
      Records, for each password form seen by the password manager, whether
      there were `suppressed` credentials, meaning stored credentials that were
      not filled, that were suppressed because they were for an origin that was
      only PSL-matching the origin of the observed form (see the suffix
      description for the possible classes of such near-matches). If there were
      such credentials, the histogram also records whether the username and
      password of such suppressed credentials matched those submitted. This
      recording happens only for credentials that were originally auto-generated
      (as opposed to user typed). Recorded values correspond to the enum
      SuppressedAccountExistence.
    </summary>
  </metric>
  <metric name="SuppressedAccount.Generated.SameOrganizationName">
    <obsolete>
      Deprecated 03/2019.
    </obsolete>
    <summary>
      Records, for each password form seen by the password manager, whether
      there were `suppressed` credentials, meaning stored credentials that were
      not filled, that were suppressed because they were for an origin that was
      only matching the visited origin if the TLD is stripped. If there were
      such credentials, the histogram also records whether the username and
      password of such suppressed credentials matched those submitted. This
      recording happens only for credentials that were originally auto-generated
      (as opposed to user typed). Recorded values correspond to the enum
      SuppressedAccountExistence.
    </summary>
  </metric>
  <metric name="SuppressedAccount.Manual.HTTPSNotHTTP">
    <obsolete>
      Deprecated 03/2019.
    </obsolete>
    <summary>
      Records, for each password form seen by the password manager, whether
      there were `suppressed` credentials, meaning stored credentials that were
      not filled, that were suppressed because they were stored for an HTTPS
      origin while the password form was seen on an HTTP origin. If there were
      such credentials, the histogram also records whether the username and
      password of such suppressed credentials matched those submitted. This
      recording happens only for credentials that were originally entered by the
      user (as opposed to auto-generated). Recorded values correspond to the
      enum SuppressedAccountExistence.
    </summary>
  </metric>
  <metric name="SuppressedAccount.Manual.PSLMatching">
    <obsolete>
      Deprecated 03/2019.
    </obsolete>
    <summary>
      Records, for each password form seen by the password manager, whether
      there were `suppressed` credentials, meaning stored credentials that were
      not filled, that were suppressed because they were for an origin that was
      only PSL-matching the origin of the observed form (see the suffix
      description for the possible classes of such near-matches). If there were
      such credentials, the histogram also records whether the username and
      password of such suppressed credentials matched those submitted. This
      recording happens only for credentials that were originally entered by the
      user (as opposed to auto-generated). Recorded values correspond to the
      enum SuppressedAccountExistence.
    </summary>
  </metric>
  <metric name="SuppressedAccount.Manual.SameOrganizationName">
    <obsolete>
      Deprecated 03/2019.
    </obsolete>
    <summary>
      Records, for each password form seen by the password manager, whether
      there were `suppressed` credentials, meaning stored credentials that were
      not filled, that were suppressed because they were for an origin that was
      only matching the visited origin if the TLD is stripped. If there were
      such credentials, the histogram also records whether the username and
      password of such suppressed credentials matched those submitted. This
      recording happens only for credentials that were originally entered by the
      user (as opposed to auto-generated). Recorded values correspond to the
      enum SuppressedAccountExistence.
    </summary>
  </metric>
  <metric name="Updating.Prompt.Interaction">
    <summary>
      Records how the user interacted with an updating prompt. Recorded values
      correspond to the enum PasswordFormMetricsRecorder::BubbleDismissalReason.
    </summary>
  </metric>
  <metric name="Updating.Prompt.Shown">
    <summary>
      Records, for each password form seen by the password manager, whether the
      user was shown a prompt that asked for permission to update existing
      credentials. Recorded values are 0 and 1 for false and true.
    </summary>
  </metric>
  <metric name="Updating.Prompt.Trigger">
    <summary>
      Records the trigger of each password update bubble that was shown to the
      user to ask for permission to update existing credentials. Recorded values
      correspond to the enum PasswordFormMetricsRecorder::BubbleTrigger.
    </summary>
  </metric>
  <metric name="User.Action">
    <obsolete>
      Deprecated. Use new user actions (&quot;User.Action....&quot;) instead.
    </obsolete>
    <summary>
      Records what the user does with all UI entry points of the password
      manager UI, like bubbles, context menus, forms, form fields, etc. in
      relation to a given form. Recorded values correspond to the enum
      PasswordFormMetricsRecorder::DetailedUserAction. In contrast to
      User.ActionSimplified, this metric is intended to be extended over time.
    </summary>
  </metric>
  <metric name="User.Action.CorrectedUsernameInForm">
    <summary>
      Counts how many times the user corrected a username in a password form.
      This is only populated if events happened.
    </summary>
  </metric>
  <metric name="User.Action.EditedUsernameInBubble">
    <summary>
      Counts how many times the user edited a username in a password save/update
      bubble. This is only populated if events happened.
    </summary>
  </metric>
  <metric name="User.Action.SelectedDifferentPasswordInBubble">
    <summary>
      Counts how many times the user selected a different password in a
      save/update bubble. This is only populated if events happened.
    </summary>
  </metric>
  <metric name="User.Action.TriggeredManualFallbackForSaving">
    <summary>
      Counts how many times the user triggered the manual fallback for password
      saving. This is only populated if events happened.
    </summary>
  </metric>
  <metric name="User.Action.TriggeredManualFallbackForUpdating">
    <obsolete>
      Deprecated. Use TriggeredManualFallbackForSaving instead.
    </obsolete>
    <summary>
      Counts how many times the user triggered the manual fallback for password
      updating. This is only populated if events happened.
    </summary>
  </metric>
  <metric name="User.ActionSimplified">
    <summary>
      Records what the user does with a form. Recorded values correspond to the
      enum password_manager::UserAction.
    </summary>
  </metric>
</event>

<event name="PaymentRequest.CheckoutEvents">
  <owner>sebsg@chromium.org</owner>
  <metric name="CompletionStatus">
    <summary>
      How the Payment Request ended. Values defined in the CompletionStatus enum
      of components/payments/core/journey_logger.h.
    </summary>
  </metric>
  <metric name="Events">
    <summary>
      Bitfield representing the events that occurred during the Payment Request.
      Values defined in the Event enum of
      components/payments/core/journey_logger.h.
    </summary>
  </metric>
</event>

<event name="Pepper.Broker" singular="True">
  <owner>raymes@chromium.org</owner>
  <summary>
    Event recorded when a flash instance connects to the broker, resulting in a
    channel being opened to the broker process.
  </summary>
</event>

<event name="PeriodicBackgroundSyncEventCompleted">
  <owner>nator@chromium.org</owner>
  <owner>rayankans@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    A website can register to periodically update itself in the background using
    a service worker. Updates can be done in response to the periodicsync event.
    Logged when a periodicsync event completes and returns a status. We collect
    information about retries of this event.
  </summary>
  <metric name="MaxAttempts">
    <summary>
      Integer value of the maximum number of allowed retries.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="NumAttempts">
    <summary>
      Integer value of the number of retries / sync events dispatched.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Status" enum="ServiceWorkerEventStatus">
    <summary>
      The enum value of the completion status, defined in
      blink::ServiceWorkerStatusCode.
    </summary>
  </metric>
</event>

<event name="PeriodicBackgroundSyncRegistered">
  <owner>nator@chromium.org</owner>
  <owner>rayankans@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    A website can register to periodically update itself in the background using
    a service worker. Updates can be done in response to the periodicsync event
    after a periodic Background Sync registration has been created. Logged when
    a periodic Background Sync registration is created. We collect information
    about this registration request.
  </summary>
  <metric name="IsReregistered" enum="Boolean">
    <summary>
      Boolean for whether a registration with this tag has already been created.
    </summary>
  </metric>
  <metric name="MinIntervalMs">
    <summary>
      Integer value of the minimum interval, in milliseconds, of periodicsync
      events requested by the origin for this registration. This number is
      exponentially bucketed and uses the UKM GetExponentialBucketMin method
      with a value of 2.0 for spacing.
    </summary>
  </metric>
</event>

<event name="Permission">
  <owner>timloh@chromium.org</owner>
  <summary>
    Metrics for a user's permission actions, logged when a permission prompt is
    resolved or when a permission is revoked. Grouped (microphone+camera)
    permission prompts are reported separately.
  </summary>
  <metric name="Action">
    <summary>
      An enum of type PermissionAction. One of GRANTED, DENIED, DISMISSED or
      IGNORED.
    </summary>
  </metric>
  <metric name="Gesture">
    <summary>
      An enum of type PermissionRequestGestureType, whether the prompt was
      initiated by a user gesture.
    </summary>
  </metric>
  <metric name="PermissionType">
    <summary>
      An enum of type ContentSettingsType.
    </summary>
  </metric>
  <metric name="PriorDismissals">
    <summary>
      The number of dismissed prompts for the given (origin, permission) pair,
      capped at 10 dismissals.
    </summary>
  </metric>
  <metric name="PriorIgnores">
    <summary>
      The number of ignored prompts for the given (origin, permission) pair,
      capped at 10 ignores.
    </summary>
  </metric>
  <metric name="Source">
    <summary>
      An enum of type PermissionSourceUI. The UI surface for this action.
    </summary>
  </metric>
</event>

<event name="Plugins.FlashInstance">
  <owner>tommycli@chromium.org</owner>
  <summary>
    Recorded when a Flash object instance is created.
  </summary>
</event>

<event name="Popup.Closed">
  <owner>csharrison@chromium.org</owner>
  <owner>jkarlin@chromium.org</owner>
  <summary>
    A popup window was closed.
  </summary>
  <metric name="EngagementTime">
    <summary>
      The time (in ms, rounded down to the nearest power of 2) a popup
      WebContents is visible / foregrounded, until it is closed. Keyed by the
      popup opener's URL (not the URL of the popup).
    </summary>
  </metric>
  <metric name="NumInteractions">
    <summary>
      Integer value representing how many user interactions the popup had. This
      is capped at 100. See IsUserInteractionInputType in web_contents_impl for
      what an interaction is. Currently it is a mouse, scroll begin, touch
      start, or raw key down event.
    </summary>
  </metric>
  <metric name="Trusted">
    <summary>
      Boolean value representing whether the popup was opened via some trusted
      event (e.g. context menu, ctrl-click, etc).
    </summary>
  </metric>
  <metric name="UserInitiatedClose">
    <summary>
      Boolean value to represent whether the popup was closed by user gesture.
    </summary>
  </metric>
</event>

<event name="PrefetchProxy" singular="True">
  <owner>robertogden@chromium.org</owner>
  <owner>ryansturm@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <summary>
    Metrics related to the privacy-preserving prefetch proxy. Recorded only for
    Lite mode (AKA Data Saver) users.
  </summary>
  <metric name="count_css_js_loaded_cache_before_fcp">
    <summary>
      The number of CSS or JS files that were loaded from the cache before first
      contentful paint, with a maximum of 10. Always set when this event is
      recorded.
    </summary>
  </metric>
  <metric name="count_css_js_loaded_network_before_fcp">
    <summary>
      The number of CSS or JS files that were loaded from the network before
      FCP, with a maximum of 10. Always set when this event is recorded.
    </summary>
  </metric>
  <metric name="days_since_last_visit_to_origin">
    <summary>
      The number of days since the user has last visited any page on this
      origin, either during a redirect or a committed page. Records -1 if the
      origin has never been visited before. Metrics for origins that have been
      visited before are capped at 180 then exponentially bucketed into 10
      buckets with values (1,2,3,5,9,15,25,42,70,119). Only set when a query
      result was received from the history service before event recording.
    </summary>
  </metric>
  <metric name="mainpage_request_had_cookies" enum="Boolean">
    <summary>
      A boolean indicating if any mainpage request in the redirect chain or
      committed request had cookies set on it. Only set when a query result was
      received from the cookie manager before event recording.
    </summary>
  </metric>
</event>

<event name="Previews" singular="True">
  <owner>ryansturm@chromium.org</owner>
  <summary>
    Previews related metrics associated with a page load. See
    //components/previews/.
  </summary>
  <metric name="client_lofi">
    <obsolete>
      Deprecated June 2019
    </obsolete>
    <summary>
      Set to 1 when a user is shown a client lo-fi image in a page load.
    </summary>
  </metric>
  <metric name="coin_flip_result">
    <obsolete>
      Replaced by the PreviewsCoinFlip event in M78.
    </obsolete>
    <summary>
      Set to 0 if there was no attempted preview for this page load, or the coin
      flip holdback is disabled in this session. Set to 1 if a preview was
      attempted and was allowed to proceed by the coin flip. Set to 2 if a
      preview would have been attempted but was held back by the coin flip. Note
      that a non-zero value in this field implies previews_likely.
    </summary>
  </metric>
  <metric name="defer_all_script" enum="Boolean">
    <summary>
      Set to 1 when a user is shown a DeferAllScript preview on a page load.
    </summary>
  </metric>
  <metric name="defer_all_script_eligibility_reason"
      enum="PreviewsEligibilityReason">
    <summary>
      Set to the value of the last known reason a DeferAllScript preview was not
      eligible on this page load. The value of this metric corresponds to the
      PreviewsEligibilityReason enum. This metric is only set when it is
      non-zero.
    </summary>
  </metric>
  <metric name="lite_page">
    <summary>
      Set to 1 when a user is shown a lite page in page load.
    </summary>
  </metric>
  <metric name="lite_page_redirect">
    <summary>
      Set to 1 when a user is shown a lite page redirect in page load.
    </summary>
  </metric>
  <metric name="lite_page_redirect_eligibility_reason">
    <summary>
      Set to the value of the last known reason a Lite Page Redirect preview was
      not eligible on this page load. The value of this metric corresponds to
      the PreviewsEligibilityReason enum. This metric is only set when it is
      non-zero.
    </summary>
  </metric>
  <metric name="navigation_restart_penalty">
    <summary>
      Set to the number of milliseconds spent restarting navigations when a Lite
      Page Redirect preview is attempted, whether or not it is committed, during
      the page load.
    </summary>
  </metric>
  <metric name="noscript">
    <summary>
      Set to 1 when a user is shown a NoScript preview on a page load.
    </summary>
  </metric>
  <metric name="noscript_eligibility_reason">
    <summary>
      Set to the value of the last known reason a NoScript preview was not
      eligible on this page load. The value of this metric corresponds to the
      PreviewsEligibilityReason enum. This metric is only set when it is
      non-zero.
    </summary>
  </metric>
  <metric name="offline_eligibility_reason">
    <summary>
      Set to the value of the last known reason an Offline preview was not
      eligible on this page load. The value of this metric corresponds to the
      PreviewsEligibilityReason enum. This metric is only set when it is
      non-zero.
    </summary>
  </metric>
  <metric name="offline_preview">
    <summary>
      Set to 1 when a user is shown an offline preview page in page load.
    </summary>
  </metric>
  <metric name="opt_out">
    <summary>
      Set to 1 when a user clicks &quot;Show Original&quot; on a preview page
      load using the infobar. Set to 2 when a user opts out of a Preview using
      the omnibox.
    </summary>
  </metric>
  <metric name="origin_opt_out">
    <summary>
      Set to 1 when previews were enabled but no preview was attempted because
      the origin provided a Cache-Control:no-transform header in the main frame
      response. This is a directive from the origin to not perform any
      transformation so in the context of the Previews feature, it is an opt-out
      by the origin site (rather than the user).
    </summary>
  </metric>
  <metric name="previews_likely">
    <summary>
      Set to 1 when a preview will be attempted for this page load. Otherwise
      this is not set. This does not imply that a preview will be committed,
      only that one will be attempted. This is set to 1 even if this page load
      is impacted by the coin flip holdback.
    </summary>
  </metric>
  <metric name="proxy_lite_page_eligibility_reason">
    <summary>
      Set to the value of the last known reason a Data Reduction Proxy Lite Page
      preview was not eligible on this page load. The value of this metric
      corresponds to the PreviewsEligibilityReason enum. This metric is only set
      when it is non-zero.
    </summary>
  </metric>
  <metric name="resource_loading_hints">
    <summary>
      Set to 1 when a user is shown a resource loading hints based preview on a
      page load.
    </summary>
  </metric>
  <metric name="resource_loading_hints_eligibility_reason">
    <summary>
      Set to the value of the last known reason a Resource Loading Hints preview
      was not eligible on this page load. The value of this metric corresponds
      to the PreviewsEligibilityReason enum. This metric is only set when it is
      non-zero.
    </summary>
  </metric>
  <metric name="save_data_enabled">
    <summary>
      Set to 1 if the data saver feature was enabled in Chrome at the time of
      the page commit.
    </summary>
  </metric>
  <metric name="server_lofi">
    <obsolete>
      Deprecated June 2019
    </obsolete>
    <summary>
      Set to 1 when a user is shown a server lo-fi image in a page load.
    </summary>
  </metric>
</event>

<event name="PreviewsCoinFlip" singular="True">
  <owner>robertogden@chromium.org</owner>
  <summary>
    Coin flip experiment metrics associated with a Preview page load. See
    //components/previews/. This is recorded as a separate event from Previews
    so that it can be recorded earlier than commit which happens in some cases.
  </summary>
  <metric name="coin_flip_result" enum="PreviewsCoinFlipResult">
    <summary>
      Set to 0 if there was no attempted preview for this page load, or the coin
      flip holdback is disabled in this session. Set to 1 if a preview was
      attempted and was allowed to proceed by the coin flip. Set to 2 if a
      preview would have been attempted but was held back by the coin flip. Note
      that a non-zero value in this field implies previews_likely.
    </summary>
  </metric>
</event>

<event name="PreviewsDeferAllScript" singular="True">
  <owner>dougarnett@chromium.org</owner>
  <summary>
    Metrics associated with the intervention of deferring the execution of
    synchronous script (typically due to a DeferAllScript Preview). This is
    recorded when the HTML parsing of a mainframe has completed.
  </summary>
  <metric name="force_deferred_scripts_mainframe">
    <summary>
      The total number of mainframe scripts (inline and external) whose
      execution was force deferred (i.e., that otherwise would have been render
      blocking).
    </summary>
  </metric>
  <metric name="force_deferred_scripts_mainframe_external">
    <summary>
      The total number of mainframe external scripts whose execution was force
      deferred (i.e., that otherwise would have been render blocking).
    </summary>
  </metric>
</event>

<event name="PreviewsResourceLoadingHints" singular="True">
  <owner>jegray@chromium.org</owner>
  <summary>
    Metrics associated with loading a resource loading hints based preview. This
    is recorded when the URL's document finishes loading. See
    //components/previews/.
  </summary>
  <metric name="blocked_high_priority">
    <summary>
      The number of high priority resource requests that were blocked by the
      resource loading hints based preview while the URL's document was loading.
    </summary>
  </metric>
  <metric name="blocked_low_priority">
    <summary>
      The number of low priority resource requests that were blocked by the
      resource loading hints based preview while the URL's document was loading.
    </summary>
  </metric>
  <metric name="blocked_medium_priority">
    <summary>
      The number of medium priority resource requests that were blocked by the
      resource loading hints based preview while the URL's document was loading.
    </summary>
  </metric>
  <metric name="blocked_very_high_priority">
    <summary>
      The number of very high priority resource requests that were blocked by
      the resource loading hints based preview while the URL's document was
      loading.
    </summary>
  </metric>
  <metric name="blocked_very_low_priority">
    <summary>
      The number of very low priority resource requests that were blocked by the
      resource loading hints based preview while the URL's document was loading.
    </summary>
  </metric>
  <metric name="patterns_to_block_total">
    <summary>
      The total number of patterns to block included in the resource loading
      hints based preview.
    </summary>
  </metric>
  <metric name="patterns_to_block_used">
    <summary>
      The number of patterns that blocked at least one resource request in the
      resource loading hints based preview while the URL's document was loading.
    </summary>
  </metric>
</event>

<event name="PWA.Visit" singular="True">
  <owner>yfriedman@chromium.org</owner>
  <owner>hartmanng@chromium.org</owner>
  <owner>pkotwicz@chromium.org</owner>
  <summary>
    PWA usage metrics recorded during a user's interaction with the site.
  </summary>
  <metric name="LaunchSource" enum="LaunchFromHomeScreenSource">
    <summary>
      Launch source of the WebAPK (tap from homescreen, WebShareTarget,
      deeplink, etc).
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="WebAPKableSiteVisit" enum="Boolean">
    <summary>
      Recorded every time a non-installed &quot;WebAPKable&quot; site is
      visited.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="RendererSchedulerTask">
  <owner>altimin@chromium.org</owner>
  <summary>
    Sampled task from the renderer main thread. Sample rate is controlled
    dynamically. See
    blink::scheduler::MainThreadSchedulerImpl::ShouldRecordTaskUkm.
  </summary>
  <metric name="FrameStatus">
    <summary>
      Frame status of the frame associated with the context of this task. See
      blink::scheduler::FrameStatus for the values of this enum.
    </summary>
  </metric>
  <metric name="IsOOPIF">
    <summary>
      Whether the frame which the task is associated with is an out-of-process
      iframe. Boolean encoded as an integer (0/1).
    </summary>
  </metric>
  <metric name="PageSchedulers">
    <summary>
      Number of page schedulers in this process. If the value equals one, global
      per-process tasks can be attributed to the URL.
    </summary>
  </metric>
  <metric name="QueueType">
    <summary>
      Type of the task queue which this task was posted to. See
      blink::scheduler::MainThreadTaskQueue::TaskType for the values of this
      enum.
    </summary>
  </metric>
  <metric name="RendererAudible">
    <summary>
      Whether renderer was playing audio when this task was completed. Boolean,
      encoded as an integer (0/1).
    </summary>
  </metric>
  <metric name="RendererBackgrounded">
    <summary>
      Whether renderer was backgrounded when this task was completed. Boolean,
      encoded as an integer (0/1).
    </summary>
  </metric>
  <metric name="RendererHidden">
    <summary>
      Whether renderer was hidden when this task was completed. Boolean, encoded
      as an integer (0/1).
    </summary>
  </metric>
  <metric name="SecondsSinceBackgrounded">
    <summary>
      Seconds since the renderer was backgrounded, recorded when the task was
      completed. Only set if the renderer is backgrounded.
    </summary>
  </metric>
  <metric name="TaskCPUDuration">
    <summary>
      CPU duration of this task in microseconds.
    </summary>
  </metric>
  <metric name="TaskDuration">
    <summary>
      Duration of this task in microseconds.
    </summary>
  </metric>
  <metric name="TaskType">
    <summary>
      blink::TaskType for the current task.
    </summary>
  </metric>
  <metric name="ThreadType">
    <summary>
      blink::ThreadType for the thread the current task was executed on.
    </summary>
  </metric>
  <metric name="UseCase">
    <summary>
      MainThreadSchedulerImpl's UseCase when this task was completed. See
      blink::scheduler::UseCase for the values of this enum.
    </summary>
  </metric>
  <metric name="Version">
    <summary>
      The version of this metric, which is used to track the actual set of
      values present across different builds and channels. Hardcoded into the
      binary and incremented each time a new field is added or existing is
      changed. Integer.
    </summary>
  </metric>
</event>

<event name="ResponsivenessMeasurement">
  <owner>npm@chromium.org</owner>
  <owner>tdresser@chromium.org</owner>
  <summary>
    Responsiveness metrics recorded once every 5 seconds.
  </summary>
  <metric name="ExpectedTaskQueueingDuration">
    <summary>
      Duration in MS for expected task queueing duration. The metric reflects
      the responsiveness of a tab. A lower value means the tab will respond to
      inputs faster. This metric is equal to
      RendererScheduler.ExpectedTaskQueueingDuration of the main frame process.
    </summary>
  </metric>
</event>

<event name="ScreenBrightness">
  <owner>pdyson@chromium.org</owner>
  <summary>
    Collects metrics periodically and on screen brightness change.
  </summary>
  <metric name="BatteryPercent">
    <summary>
      Percentage of battery, rounded down to a multiple of 5%, i.e. [0, 5%) is
      mapped to 0, [5%, 10%) is mapped to 5 etc.
    </summary>
  </metric>
  <metric name="Brightness">
    <summary>
      Screen percentage brightness. between 0 and 100.
    </summary>
  </metric>
  <metric name="DayOfWeek">
    <summary>
      An enum representing the of the week that the data was logged, defined in
      |chromeos::power::ml::ScreenBrightness::Features::ActivityData::
      DayOfWeek|.
    </summary>
  </metric>
  <metric name="DeviceMode">
    <summary>
      An enum representing the mode of the device, defined in
      |chromeos::power::ml::ScreenBrightness::Feature::EnvData:DeviceMode|
    </summary>
  </metric>
  <metric name="HourOfDay">
    <summary>
      The hour of the day when the data is logged. Hours since midnight in the
      local time zone.
    </summary>
  </metric>
  <metric name="IsAutoclickEnabled">
    <summary>
      Boolean value to represent whether the auto click is currently enabled.
    </summary>
  </metric>
  <metric name="IsBrailleDisplayConnected">
    <summary>
      Boolean value to represent whether the braille display is currently
      enabled.
    </summary>
  </metric>
  <metric name="IsCaretHighlightEnabled">
    <summary>
      Boolean value to represent whether the caret highlight is currently
      enabled.
    </summary>
  </metric>
  <metric name="IsCursorHighlightEnabled">
    <summary>
      Boolean value to represent whether the cursor highlight is currently
      enabled.
    </summary>
  </metric>
  <metric name="IsFocusHighlightEnabled">
    <summary>
      Boolean value to represent whether the focus highlight is currently
      enabled.
    </summary>
  </metric>
  <metric name="IsHighContrastEnabled">
    <summary>
      Boolean value to represent whether the high contrast is currently enabled.
    </summary>
  </metric>
  <metric name="IsLargeCursorEnabled">
    <summary>
      Boolean value to represent whether the large cursor is currently enabled.
    </summary>
  </metric>
  <metric name="IsMagnifierEnabled">
    <summary>
      Boolean value to represent whether the full screen magnifier is currently
      enabled.
    </summary>
  </metric>
  <metric name="IsMonoAudioEnabled">
    <summary>
      Boolean value to represent whether the mono audio is currently enabled.
    </summary>
  </metric>
  <metric name="IsSelectToSpeakEnabled">
    <summary>
      Boolean value to represent whether select to speak is currently enabled.
    </summary>
  </metric>
  <metric name="IsSpokenFeedbackEnabled">
    <summary>
      Boolean value to represent whether the spoken feedback is currently
      enabled.
    </summary>
  </metric>
  <metric name="IsSwitchAccessEnabled">
    <summary>
      Boolean value to represent whether Switch Access is currently enabled.
    </summary>
  </metric>
  <metric name="IsVideoPlaying">
    <summary>
      Boolean value to represent whether video is currently playing.
    </summary>
  </metric>
  <metric name="IsVirtualKeyboardEnabled">
    <summary>
      Boolean value to represent whether the virtual keyboard is currently
      enabled.
    </summary>
  </metric>
  <metric name="LastActivityTimeSec">
    <summary>
      Time between the last activity and when the data was logged. A duration
      timestamp in seconds.
    </summary>
  </metric>
  <metric name="NightLightTemperaturePercent">
    <summary>
      The temperature percentage of night light screen color adjustment when
      night light is on. Ranges from 0 to 100.
    </summary>
  </metric>
  <metric name="NumRecentKeyEvents">
    <summary>
      The number of keyboard events in the last hour.
    </summary>
  </metric>
  <metric name="NumRecentMouseEvents">
    <summary>
      The number of mouse events in the last hour.
    </summary>
  </metric>
  <metric name="NumRecentStylusEvents">
    <summary>
      The number of stylus events in the last hour.
    </summary>
  </metric>
  <metric name="NumRecentTouchEvents">
    <summary>
      The number of touch events in the last hour.
    </summary>
  </metric>
  <metric name="OnBattery">
    <summary>
      Boolean value to represent whether the device is currently on battery
      power.
    </summary>
  </metric>
  <metric name="PreviousBrightness">
    <summary>
      The brightness of the screen prior to the time at which the current event
      was logged.
    </summary>
  </metric>
  <metric name="Reason">
    <summary>
      The reason that the event is logged. Values are enumerated in
      |chromeos::power::ml::ScreenBrightness::Event::Reason|.
    </summary>
  </metric>
  <metric name="RecentTimeActiveSec">
    <summary>
      How long the user has been active. A duration timestamp in seconds.
    </summary>
  </metric>
  <metric name="SequenceId">
    <summary>
      The ID of this event in the current session.
    </summary>
  </metric>
  <metric name="TimeSinceLastEventSec">
    <summary>
      Time in seconds since last time an event was logged.
    </summary>
  </metric>
</event>

<event name="Security.SafetyTip">
  <owner>jdeblasio@chromium.org</owner>
  <owner>enamelites@google.com</owner>
  <owner>beggs@google.com</owner>
  <summary>
    Collected when any safety tip heuristic triggers, regardless of whether the
    Safety Tip UI is shown.
  </summary>
  <metric name="SafetyTipInteraction" enum="SafetyTipInteraction">
    <summary>
      How the user interacted with the UI, if applicable.
    </summary>
  </metric>
  <metric name="SafetyTipStatus" enum="SafetyTipStatus">
    <summary>
      The final reported Safety Tip status.
    </summary>
  </metric>
  <metric name="TriggeredKeywordsHeuristics" enum="Boolean">
    <summary>
      Whether the sensitive keywords heuristic triggered.
    </summary>
  </metric>
  <metric name="TriggeredLookalikeHeuristics" enum="Boolean">
    <summary>
      Whether the lookalike keywords heuristic triggered.
    </summary>
  </metric>
  <metric name="TriggeredServerSideBlocklist" enum="Boolean">
    <summary>
      Whether the server-side blocklist heuristic triggered.
    </summary>
  </metric>
  <metric name="UserPreviouslyIgnored" enum="Boolean">
    <summary>
      Whether the user had already ignored a safety tip warning for this page in
      the past, meaning no tip was shown.
    </summary>
  </metric>
</event>

<event name="Security.SiteEngagement">
  <owner>cthomp@chromium.org</owner>
  <owner>enamelites@google.com</owner>
  <summary>
    Site engagement score behavior for a page with a given Security Level.
  </summary>
  <metric name="FinalSecurityLevel">
    <summary>
      The final SecurityLevel of the page before it is closed or another
      navigation occurs. Based on the enum security_state::SecurityLevel.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="InitialSecurityLevel">
    <summary>
      The initial SecurityLevel of the page when the navigation commits. Based
      on the enum security_state::SecurityLevel.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="SafetyTipStatus" enum="SafetyTipStatus">
    <summary>
      The Safety Tip status of the page when the navigation commits, after the
      reputation check finishes.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ScoreDelta">
    <summary>
      The change in Site Engagement score for the page before it is closed or
      another navigation occurs compared to the score from when the navigation
      committed. Score is between 0.0 and 100.0; delta is between -100.0 and
      100.0. Rounded to the nearest integer.
    </summary>
  </metric>
  <metric name="ScoreFinal">
    <summary>
      The final Site Engagement score for the page before it is closed or
      another navigation occurs. Score is between 0.0 and 100.0; this metric is
      rounded down to a multiple of 10 to limit granularity.
    </summary>
  </metric>
</event>

<event name="Sharing.ClickToCall">
  <owner>knollr@chromium.org</owner>
  <summary>
    Collected when a user finishes a Click to Call journey.
  </summary>
  <metric name="EntryPoint" enum="SharingClickToCallEntryPoint">
    <summary>
      Specifies the entry point of the user journey (i.e. left click, right
      click, text selection).
    </summary>
  </metric>
  <metric name="HasApps" enum="Boolean">
    <summary>
      Boolean value indicating whether any (&gt;0) apps are available that the
      call could be sent to.
    </summary>
  </metric>
  <metric name="HasDevices" enum="Boolean">
    <summary>
      Boolean value indicating whether any (&gt;0) devices are available that
      the call could be sent to. These belong to the same account and are
      running Android.
    </summary>
  </metric>
  <metric name="Selection" enum="SharingClickToCallSelection">
    <summary>
      Whether the user selected a device, an app or nothing (i.e. dismissal) in
      the user interface. For some entry points this might always be the same
      value (e.g. right clicks always select devices).
    </summary>
  </metric>
</event>

<event name="SiteIsolation.XSD.Browser.Blocked">
  <obsolete>
    Removed in June 2019 / M77. Some old data has been saved in a
    Google-internal doc at go/xsdb-ukm-results (ask owners below for access).
  </obsolete>
  <owner>creis@chromium.org</owner>
  <owner>chrome-site-isolation@google.com</owner>
  <summary>
    Resource request response was blocked by the cross-site document blocking
    logic in the browser process.
  </summary>
  <metric name="CanonicalMimeType">
    <summary>
      Classification of the Content-Type HTTP response header into one of the
      blockable document flavours: html, xml, json, plain.
    </summary>
  </metric>
  <metric name="ContentLengthWasZero">
    <summary>
      ContentLengthWasZero=1 if Content-Length was available and equal to 0.
      ContentLengthWasZero=0 otherwise.
    </summary>
  </metric>
  <metric name="ContentResourceType">
    <summary>
      content::ResourceType of the blocked resource (e.g. image / script / xhr /
      etc.).
    </summary>
  </metric>
  <metric name="HttpResponseCode">
    <summary>
      The HTTP response code (e.g. 200 or 404) associated with the blocked
      resource request.
    </summary>
  </metric>
  <metric name="NeededSniffing">
    <summary>
      Whether the HTTP response needed sniffing to confirm its MIME type.
    </summary>
  </metric>
</event>

<event name="SMSReceiver">
  <owner>goto@chromium.org</owner>
  <owner>reillyg@chromium.org</owner>
  <owner>juncai@chromium.org</owner>
  <owner>ayui@chromium.org</owner>
  <summary>
    Records performance metrics for SMSReceiver API.
  </summary>
  <metric name="Outcome" enum="SMSReceiverOutcome">
    <summary>
      Records the result of a call to the SmsReceiver API.
    </summary>
  </metric>
</event>

<event name="SSL.MixedContentShown">
  <owner>carlosil@chromium.org</owner>
  <summary>
    Logged when mixed content is displayed on a site.
  </summary>
  <metric name="Type">
    <summary>
      A value of the MixedContentType enum, detailing the type of mixed content
      included on the site.
    </summary>
  </metric>
</event>

<event name="SubframeDownload">
  <obsolete>
    Deprecated as of 03/2019.
  </obsolete>
  <owner>yaoxia@chromium.org</owner>
  <summary>
    Measurement for subframe download. It is only recorded for downloads
    originated from navigations or from HTML anchor download attributes.
  </summary>
  <metric name="HasGesture">
    <summary>
      A boolean denoting whether the download involves a transient user gesture.
    </summary>
  </metric>
  <metric name="HasSandbox">
    <summary>
      A boolean denoting whether the download occurs in a sandboxed browsing
      context.
    </summary>
  </metric>
  <metric name="IsAdFrame">
    <summary>
      A boolean denoting whether the download occurs in an ad subframe.
    </summary>
  </metric>
  <metric name="IsCrossOrigin">
    <summary>
      A boolean denoting whether the download occurs in a subframe x-origin to
      the top frame.
    </summary>
  </metric>
</event>

<event name="SubresourceFilter" singular="True">
  <owner>bmcquade@chromium.org</owner>
  <owner>csharrison@chromium.org</owner>
  <summary>
    Recorded for page loads where subresource filtering policy was evaluated.
  </summary>
  <metric name="ActivationDecision">
    <summary>
      Enum that records the policy decision to activate subresource filtering
      for a page load. 0 = Unknown, 1 = Activated, 2 = Disabled, 3 = Deprecated
      value, 4 = URL whitelisted, 5 = Activation conditions not met. 'Activated'
      indicates that subresource filtering was activated. All other reasons
      indicate that subresource filtering was not activated.
    </summary>
  </metric>
  <metric name="DryRun">
    <summary>
      Records '1' if subresource filtering was activated in dry run mode. In dry
      run mode, subresource filtering policy is evaluated against resources
      loaded on the page, but subresource filtering is not actually applied.
    </summary>
  </metric>
  <metric name="EnforcementRedirectPosition">
    <summary>
      An enum denoting where in the redirect chain there was a URL that matched
      one of the subresource_filter activation lists, and wasn't marked as
      warning. See subresource_filter::RedirectPosition for values.
    </summary>
  </metric>
</event>

<event name="Tab.RendererOOM">
  <owner>ssid@chromium.org</owner>
  <summary>
    Metrics about renderer OOM, recorded for each detected OOM of renderer
    process.
  </summary>
  <metric name="TimeSinceLastNavigation">
    <summary>
      Duration in MS from when the main frame navigation was triggered to when
      the tab crashed with OOM. Recorded only on Windows, Android and Chrome OS.
      We do not have a way to detect OOMs reliably on Linux and Mac.
    </summary>
  </metric>
</event>

<event name="TabManager.Background.FirstAlertFired">
  <owner>chrisha@chromium.org</owner>
  <owner>lpy@chromium.org</owner>
  <summary>
    Collects the duration in MS from when the tab is backgrounded to when a
    JavaScript alert is fired. Only recorded when the tab is in the background.
  </summary>
  <metric name="IsMainFrame">
    <summary>
      Indicates whether the alert is fired from main frame.
    </summary>
  </metric>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when alert is fired.
    </summary>
  </metric>
</event>

<event name="TabManager.Background.FirstAudioStarts">
  <owner>chrisha@chromium.org</owner>
  <owner>lpy@chromium.org</owner>
  <summary>
    Collects the duration in MS from when the tab is backgrounded to when audio
    starts to play. Only recorded when the tab is in the background.
  </summary>
  <metric name="IsMainFrame">
    <summary>
      Indicates whether the audio stream belongs to the main frame.
    </summary>
  </metric>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when audio starts to
      play.
    </summary>
  </metric>
</event>

<event name="TabManager.Background.FirstFaviconUpdated">
  <owner>chrisha@chromium.org</owner>
  <owner>lpy@chromium.org</owner>
  <summary>
    Collects the duration in MS from when the tab is backgrounded to when the
    favicon is updated. Only recorded when the tab is in the background.
  </summary>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when the favicon is
      updated.
    </summary>
  </metric>
</event>

<event name="TabManager.Background.FirstNonPersistentNotificationCreated">
  <owner>chrisha@chromium.org</owner>
  <owner>lpy@chromium.org</owner>
  <summary/>
  <metric name="IsMainFrame">
    <summary>
      Indicates whether the notification creation is from the main frame.
    </summary>
  </metric>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when a non-persistent
      notification is created.
    </summary>
  </metric>
</event>

<event name="TabManager.Background.FirstTitleUpdated">
  <owner>chrisha@chromium.org</owner>
  <owner>lpy@chromium.org</owner>
  <summary>
    Collects the duration in MS from when the tab is backgrounded to when the
    title is updated. Only recorded when the tab is in the background.
  </summary>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when the title is
      updated.
    </summary>
  </metric>
</event>

<event name="TabManager.Background.ForegroundedOrClosed">
  <owner>chrisha@chromium.org</owner>
  <summary>
    Collects the duration in MS from when the tab is backgrounded to when it is
    brought to foreground or closed.
  </summary>
  <metric name="IsDiscarded">
    <summary>
      Boolean value indicating whether or not the tab is discarded since it was
      backgrounded.
    </summary>
  </metric>
  <metric name="IsForegrounded">
    <summary>
      Boolean value indicating whether or not it's triggered because the tab is
      brought to foreground again.
    </summary>
  </metric>
  <metric name="LabelId">
    <summary>
      An int64 random number generated when TabManager.TabMetric is logged. The
      same number is also logged here, so that feature label can be paired.
    </summary>
  </metric>
  <metric name="MRUIndex">
    <obsolete>
      Deprecated 10/2019 in favor MRUIndex in TabMetrics.
    </obsolete>
    <summary>
      Index of the tab in most-recently-used order. A value of N means there are
      N tabs more recently used than the one that is being foregrounded or
      closed.
    </summary>
  </metric>
  <metric name="SequenceId">
    <obsolete>
      Deprecated 11/2018 in favor LabelId.
    </obsolete>
    <summary>
      This metric is obsolete in 11/2018 in favor of LabelId for pairing with
      Tabmanager.TabMetrics event. The sequence of this event and
      TabManager.TabMetrics event in the current session. Incremented by 1 each
      time one of the two events is logged to provide an ordering of events.
    </summary>
  </metric>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when it is brought to
      foreground or closed.
    </summary>
  </metric>
  <metric name="TotalTabCount">
    <obsolete>
      Deprecated 10/2019 in favor TotalTabCount in TabMetrics.
    </obsolete>
    <summary>
      Total number of tabs open across all non-incognito browser windows. Helps
      contextualize the MRUIndex value.
    </summary>
  </metric>
</event>

<event
    name="TabManager.BackgroundTabOpening.ForegroundTab.ExpectedTaskQueueingDurationInfo">
  <owner>chrisha@chromium.org</owner>
  <summary>
    Collects the expected queueing duration of tasks and metadata for the
    foreground tab during a background tab opening session (the duration of time
    from when the browser starts to open background tabs until the time the
    browser has finished loading those tabs or otherwise decided to stop loading
    them). The event is not recorded when the session overlaps with session
    restore. This event is sampled when there is only one backgrounded loading
    or pending tab and all events are collected when there are 2 or more
    backgrounded loading or pending tabs. In this way, we cap the volume while
    keeping all interesting data. Therefore, aggregated tab counts over multiple
    events are invalid.
  </summary>
  <metric name="BackgroundTabLoadingCount">
    <summary>
      Number of background tabs that are loading.
    </summary>
  </metric>
  <metric name="BackgroundTabOpeningSessionId">
    <summary>
      The ID of this background tab opening session.
    </summary>
  </metric>
  <metric name="BackgroundTabPendingCount">
    <summary>
      Number of background tabs that are pending.
    </summary>
  </metric>
  <metric name="ExpectedTaskQueueingDuration">
    <summary>
      Duration in MS for expected task queueing duration. The metric reflects
      the responsiveness of a tab. A lower value means the tab will respond to
      inputs faster. This metric is equal to
      RendererScheduler.ExpectedTaskQueueingDuration. It is emitted once for all
      tasks in each 1000-ms window.
    </summary>
  </metric>
  <metric name="SequenceId">
    <summary>
      The ID of this event's sequence in current background tab opening session.
    </summary>
  </metric>
  <metric name="SystemTabCount">
    <summary>
      Number of all tabs of the system, which includes all browser windows.
    </summary>
  </metric>
</event>

<event name="TabManager.Experimental.BackgroundTabOpening.TabSwitchLoadStopped"
    singular="True">
  <owner>zhenw@chromium.org</owner>
  <summary>
    Collects data when a tab is switched to from another tab and then finishes
    loading in the foreground during a background tab opening session (the
    duration of time from when the browser starts to open background tabs until
    the time the browser has finished loading those tabs or otherwise decided to
    stop loading them). The event is only recorded when a tab is switched to
    from another tab within the same tabstrip. As a result, the initial
    foreground tab is not included in this event since it was not switched to
    from another tab. The event is not recorded when the session overlaps with
    session restore.
  </summary>
  <metric name="BackgroundTabLoadingCount">
    <summary>
      Number of background tabs that are loading.
    </summary>
  </metric>
  <metric name="BackgroundTabOpeningSessionId">
    <summary>
      The ID of this background tab opening session.
    </summary>
  </metric>
  <metric name="BackgroundTabPendingCount">
    <summary>
      Number of background tabs that are pending.
    </summary>
  </metric>
  <metric name="SequenceId">
    <summary>
      The ID of this event's sequence in current background tab opening session.
    </summary>
  </metric>
  <metric name="SystemTabCount">
    <summary>
      Number of all tabs of the system, which includes all browser windows.
    </summary>
  </metric>
  <metric name="TabSwitchLoadTime">
    <summary>
      Tab switch load time in MS. It is defined as the time between when the
      user switches to a backround tab, and the time when that tab finishes
      loading in the foreground. If the user switches away before the tab
      finishes loading, a metric will not be recorded unless the user switches
      back, in which case the tab switch load time is measured from that point
      in time.
    </summary>
  </metric>
</event>

<event name="TabManager.Experimental.SessionRestore.ForegroundTab.PageLoad"
    singular="True">
  <owner>zhenw@chromium.org</owner>
  <summary>
    Collects the tab counts for the foreground tab page load during session
    restore. The event is not recorded when the session overlaps with background
    tab opening. This event should be combined with PageLoad event for analysis.
  </summary>
  <metric name="SessionRestoreTabCount">
    <summary>
      Number of tabs that are restored.
    </summary>
  </metric>
  <metric name="SystemTabCount">
    <summary>
      Number of all tabs of the system, which includes all browser windows.
    </summary>
  </metric>
</event>

<event name="TabManager.Experimental.SessionRestore.TabSwitchLoadStopped"
    singular="True">
  <owner>zhenw@chromium.org</owner>
  <summary>
    Collects data when a tab is switched to from another tab and then finishes
    loading in the foreground during session restore The event is only recorded
    when a tab is switched to from another tab within the same tabstrip. As a
    result, the initial foreground tab is not included in this event since it
    was not switched to from another tab. The event is not recorded when the
    session overlaps with background tab opening.
  </summary>
  <metric name="SequenceId">
    <summary>
      The ID of this event's sequence in current session restore session.
    </summary>
  </metric>
  <metric name="SessionRestoreSessionId">
    <summary>
      The ID of this session restore session.
    </summary>
  </metric>
  <metric name="SessionRestoreTabCount">
    <summary>
      Number of tabs that are restored.
    </summary>
  </metric>
  <metric name="SystemTabCount">
    <summary>
      Number of all tabs of the system, which includes all browser windows.
    </summary>
  </metric>
  <metric name="TabSwitchLoadTime">
    <summary>
      Tab switch load time in MS. It is defined as the time between when the
      user switches to a background tab, and the time when that tab finishes
      loading in the foreground. If the user switches away before the tab
      finishes loading, a metric will not be recorded unless the user switches
      back, in which case the tab switch load time is measured from that point
      in time.
    </summary>
  </metric>
</event>

<event name="TabManager.LifecycleStateChange">
  <owner>chrisha@chromium.org</owner>
  <owner>fdoray@chromium.org</owner>
  <summary>
    Collects information about when and why a lifecycle state change was
    attempted, and information about the outcome of the attempt.
  </summary>
  <metric name="FailureGlobalBlacklist" enum="Boolean">
    <summary>
      Boolean indicating that the tab was explicitly opted out of the
      intervention via the global blacklist.
    </summary>
  </metric>
  <metric name="FailureHeuristicAudio" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the origin
      has historically been observed emitting audio while in the background.
    </summary>
  </metric>
  <metric name="FailureHeuristicFavicon" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the origin
      has historically been observed updating its favicon while in the
      background.
    </summary>
  </metric>
  <metric name="FailureHeuristicInsufficientObservation" enum="Boolean">
    <summary>
      Boolean indicating that the site is still being observed locally in order
      to determine which features are in use. In the meantime, it is protected
      from this intervention.
    </summary>
  </metric>
  <metric name="FailureHeuristicNotifications" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the origin
      has historically been observed making use of notifications while in the
      background.
    </summary>
  </metric>
  <metric name="FailureHeuristicTitle" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the origin
      has historically been observed updating its tab title while in the
      background.
    </summary>
  </metric>
  <metric name="FailureLifecyclesEnterprisePolicyOptOut" enum="Boolean">
    <summary>
      Boolean indicating that the browser was explicitly opted out of the
      intervention via enterprise policy.
    </summary>
  </metric>
  <metric name="FailureLifecyclesFeaturePolicyOptOut">
    <obsolete>
      Deprecated 08/2019. Replaced with FailureOriginTrialOptOut.
    </obsolete>
    <summary>
      Boolean indicating that the tab explicitly opted out of the intervention
      via feature policy.
    </summary>
  </metric>
  <metric name="FailureLiveStateCapturing" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently capturing user media (making use of webcam or microphone, for
      example).
    </summary>
  </metric>
  <metric name="FailureLiveStateDesktopCapture" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently capturing a window or screen.
    </summary>
  </metric>
  <metric name="FailureLiveStateDevToolsOpen" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently using DevTools.
    </summary>
  </metric>
  <metric name="FailureLiveStateExtensionDisallowed" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed by an extension.
    </summary>
  </metric>
  <metric name="FailureLiveStateFormEntry" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab
      currently contains text form entry.
    </summary>
  </metric>
  <metric name="FailureLiveStateHasNotificationsPermission" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab
      has the permission to use notifications.
    </summary>
  </metric>
  <metric name="FailureLiveStateIsPDF" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently hosting a PDF.
    </summary>
  </metric>
  <metric name="FailureLiveStateMirroring" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently being mirrored (casting its contents, for example).
    </summary>
  </metric>
  <metric name="FailureLiveStatePlayingAudio" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently playing audio.
    </summary>
  </metric>
  <metric name="FailureLiveStateSharingBrowsingInstance" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      sharing its BrowsingInstance with at least one other tab.
    </summary>
  </metric>
  <metric name="FailureLiveStateUsingBluetooth" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently connected to at least one bluetooth device.
    </summary>
  </metric>
  <metric name="FailureLiveStateUsingIndexedDBLock" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently holding at least one IndexedDB lock.
    </summary>
  </metric>
  <metric name="FailureLiveStateUsingWebLock" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently holding at least one WebLock.
    </summary>
  </metric>
  <metric name="FailureLiveStateUsingWebSockets" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently using WebSockets.
    </summary>
  </metric>
  <metric name="FailureLiveStateUsingWebUSB" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently using WebUSB.
    </summary>
  </metric>
  <metric name="FailureLiveStateVisible" enum="Boolean">
    <summary>
      Boolean indicating that the intervention was disallowed because the tab is
      currently visible.
    </summary>
  </metric>
  <metric name="FailureOriginTrialOptOut" enum="Boolean">
    <summary>
      Boolean indicating that the tab explicitly opted out of the intervention
      via origin trial.
    </summary>
  </metric>
  <metric name="FailureOriginTrialUnknown" enum="Boolean">
    <summary>
      Boolean indicating that the tab did not report its origin trial
      opt-in/opt-out yet.
    </summary>
  </metric>
  <metric name="LifecycleStateChangeReason">
    <summary>
      The reason the lifecycle state change was attempted. This corresponds to
      the LifecycleStateChangeReason enumeration in lifecycle_unit_state.mojom.
    </summary>
  </metric>
  <metric name="NewLifecycleState">
    <summary>
      The lifecycle state the tab will be in after the state change. Corresponds
      to a value from the LifecycleUnitState enum defined in
      lifecycle_unit_state.mojom.
    </summary>
  </metric>
  <metric name="OldLifecycleState">
    <summary>
      The lifecycle state the tab was in prior to the state change. Corresponds
      to a value from the LifecycleUnitState enum defined in
      lifecycle_unit_state.mojom.
    </summary>
  </metric>
  <metric name="Outcome" enum="Boolean">
    <summary>
      Whether or not the state change was successful. The various Failure and
      Success booleans encode the actual reasons for this outcome. Note that
      multiple success and failure reasons may be encoded for a single decision.
      The presence of any failure bit indicates a negative outcome. If only
      success bits are present the outcome is positive.
    </summary>
  </metric>
  <metric name="SuccessGlobalWhitelist" enum="Boolean">
    <summary>
      Boolean indicating that the tab was explicitly opted in to the
      intervention via the global whitelist.
    </summary>
  </metric>
  <metric name="SuccessHeuristic" enum="Boolean">
    <summary>
      Boolean indicating that the tab was deemed safe for the intervention via
      local observations and heuristics.
    </summary>
  </metric>
  <metric name="SuccessLifecyclesFeaturePolicyOptIn">
    <obsolete>
      Deprecated 08/2019. Replaced with SuccessOriginTrialOptIn.
    </obsolete>
    <summary>
      Boolean indicating that the tab explicitly opted in to the intervention
      via feature policy.
    </summary>
  </metric>
  <metric name="SuccessOriginTrialOptIn" enum="Boolean">
    <summary>
      Boolean indicating that the tab explicitly opted in to the intervention
      via origin trial.
    </summary>
  </metric>
  <metric name="TimeSinceNavigationMs">
    <summary>
      The time elapsed (in milliseconds) since the top-level navigation was
      committed that loaded this tab's content.
    </summary>
  </metric>
  <metric name="TimeSinceVisibilityStateChangeMs">
    <summary>
      The amount of time that has passed (in milliseconds) since the last
      visibility state change.
    </summary>
  </metric>
  <metric name="TransitionForced" enum="Boolean">
    <summary>
      This is set if the transition to the new lifecycle state was forced by the
      browser because the content took too long to respond to the lifecycle
      event.
    </summary>
  </metric>
  <metric name="VisibilityState">
    <summary>
      The current visibility state. This is an integer value corresponding to
      the enumeration in content/public/browser/visibility.h.
    </summary>
  </metric>
</event>

<event
    name="TabManager.SessionRestore.ForegroundTab.ExpectedTaskQueueingDurationInfo">
  <owner>zhenw@chromium.org</owner>
  <summary>
    Collects the expected queueing duration of tasks and metadata for the
    foreground tab during session restore. The event is not recorded when the
    session overlaps with background tab opening. The event is not recorded when
    there is only one restored tab, in which case, there is no background
    restored tab and we are not interested at that. In this way, we cap the
    volume while keeping all interesting data.
  </summary>
  <metric name="ExpectedTaskQueueingDuration">
    <summary>
      Duration in MS for expected task queueing duration. The metric reflects
      the responsiveness of a tab. A lower value means the tab will respond to
      inputs faster. This metric is equal to
      RendererScheduler.ExpectedTaskQueueingDuration. It is emitted once for all
      tasks in each 1000-ms window.
    </summary>
  </metric>
  <metric name="SequenceId">
    <summary>
      The ID of this event's sequence in current session restore session.
    </summary>
  </metric>
  <metric name="SessionRestoreSessionId">
    <summary>
      The ID of this session restore session.
    </summary>
  </metric>
  <metric name="SessionRestoreTabCount">
    <summary>
      Number of tabs that are restored.
    </summary>
  </metric>
  <metric name="SystemTabCount">
    <summary>
      Number of all tabs of the system, which includes all browser windows.
    </summary>
  </metric>
</event>

<event name="TabManager.TabLifetime" singular="True">
  <owner>chrisha@chromium.org</owner>
  <summary>
    Collected when a tab is closed, at most once per source.
  </summary>
  <metric name="TimeSinceNavigation">
    <summary>
      The time when the tab was closed, expressed as the amount of time in MS
      that has elapsed since the main frame navigation providing the content of
      the tab.
    </summary>
  </metric>
</event>

<event name="TabManager.TabMetrics">
  <owner>michaelpg@chromium.org</owner>
  <summary>
    Collects tab information for a tab after navigations, activations and close
    events.
  </summary>
  <metric name="ContentType">
    <summary>
      Obsolete. Enumeration for the MIME type of the page. Values are enumerated
      in metrics::TabMetricsEvent::ContentType.
    </summary>
  </metric>
  <metric name="DefaultProtocolHandler">
    <summary>
      Obsolete. Schemes that a page from this page's origin is the default
      protocol handler for, meaning the user has chosen to accept (or the
      handler was preinstalled by Chrome). The metric is repeated, occurring for
      each such protocol handler, and uses values from
      metrics::TabMetricsEvent::Scheme.
    </summary>
  </metric>
  <metric name="HasBeforeUnloadHandler">
    <summary>
      Boolean value indicating whether the page has a beforeunload JavaScript
      event handler.
    </summary>
  </metric>
  <metric name="HasFormEntry">
    <summary>
      Boolean value indicating whether the page has any user-input text.
    </summary>
  </metric>
  <metric name="IsExtensionProtected">
    <summary>
      Obsolete. True if an extension has marked this tab as non-discardable via
      the chrome.tabs.update() extension API.
    </summary>
  </metric>
  <metric name="IsPinned">
    <summary>
      Boolean value indicating whether the tab is pinned in the tabstrip.
    </summary>
  </metric>
  <metric name="KeyEventCount">
    <summary>
      Number of key events that were sent to the page.
    </summary>
  </metric>
  <metric name="LabelId">
    <summary>
      An int64 random number generated at logging time. The same number will
      also be logged to the TabManager.Background.ForegroundedOrClosed event, so
      that feature label can be paired.
    </summary>
  </metric>
  <metric name="MouseEventCount">
    <summary>
      Number of mouse events that were sent to the page.
    </summary>
  </metric>
  <metric name="MRUIndex">
    <summary>
      Index of the tab in most-recently-used order. A value of N means there are
      N tabs more recently used than the one that is being foregrounded or
      closed.
    </summary>
  </metric>
  <metric name="NavigationEntryCount">
    <summary>
      Number of navigation entries in the tab's NavigationController.
      Corresponds to the size of the tab's back/forward list.
    </summary>
  </metric>
  <metric name="NumReactivationBefore">
    <summary>
      Number of reactivations that this tab had till now.
    </summary>
  </metric>
  <metric name="PageTransitionCoreType">
    <summary>
      Type of the page transition for this navigation. Uses the core values from
      ui::PageTransition.
    </summary>
  </metric>
  <metric name="PageTransitionFromAddressBar">
    <summary>
      True if the page transition came from interacting with the address bar,
      such as by typing a URL or performing a search.
    </summary>
  </metric>
  <metric name="PageTransitionIsRedirect">
    <summary>
      True if the page transition type is a redirect, in which case the
      PageTransition type may not be accurate.
    </summary>
  </metric>
  <metric name="QueryId">
    <summary>
      An int64 random number generated at query time of
      TabManager::GetSortedLifecycleUnitsFromTabRanker. Tabs with the same
      QueryId will be later on combined in one full list for further analysis.
    </summary>
  </metric>
  <metric name="SequenceId">
    <obsolete>
      Deprecated 11/2018 in favor LabelId.
    </obsolete>
    <summary>
      This metric is obsolete in 11/2018 in favor of LabelId for pairing with
      Tabmanager.ForegroundedOrClosed event. The sequence of this event and
      TabManager.ForegroundedOrClosed event in the current session. Incremented
      by 1 each time one of the two events is logged to provide an ordering of
      events.
    </summary>
  </metric>
  <metric name="SiteEngagementScore">
    <summary>
      Site engagement score in the range [0, 100], rounded down to a multiple of
      10 to limit granularity.
    </summary>
  </metric>
  <metric name="TimeFromBackgrounded">
    <summary>
      Duration in MS from when the tab is backgrounded to when it is brought to
      foreground or closed.
    </summary>
  </metric>
  <metric name="TotalTabCount">
    <summary>
      Total number of tabs open across all non-incognito browser windows. Helps
      contextualize the MRUIndex value.
    </summary>
  </metric>
  <metric name="TouchEventCount">
    <summary>
      Number of touch events that were sent to the page.
    </summary>
  </metric>
  <metric name="WasRecentlyAudible">
    <summary>
      Boolean value indicating whether the tab has played audio within the last
      two seconds.
    </summary>
  </metric>
  <metric name="WindowId">
    <obsolete>
      Deprecated 11/2018 in favor of putting window features directly in this
      event.
    </obsolete>
    <summary>
      WindowId of the WindowMetrics entry corresponding to the browser window
      containing this tab. This metrics is not populated from 11/2018 because we
      don't need to join this event with other WindowMetrics any more.
    </summary>
  </metric>
  <metric name="WindowIsActive">
    <summary>
      Boolean value indicating whether the window is the active (frontmost)
      window.
    </summary>
  </metric>
  <metric name="WindowShowState">
    <summary>
      Enumeration of the window show state, such as fullscreen or minimized.
      Values are enumerated in metrics::WindowMetricsEvent::ShowState.
    </summary>
  </metric>
  <metric name="WindowTabCount">
    <summary>
      Number of tabs in the tab strip. Rounded down to the nearest exponential
      bucket (with a bucket spacing factor of 1.5). Will be 1 for windows with
      only one top-level WebContents, such as app windows.
    </summary>
  </metric>
  <metric name="WindowType">
    <summary>
      Enumeration for the type of the window. Values are enumerated in
      metrics::WindowMetricsEvent::Type.
    </summary>
  </metric>
</event>

<event name="TabManager.WindowMetrics">
  <owner>michaelpg@chromium.org</owner>
  <summary>
    Collects information about a browser or app window to associate with the
    TabManager.TabMetrics entries for tabs in that window.
  </summary>
  <metric name="IsActive">
    <summary>
      Whether the window is the active (frontmost) window.
    </summary>
  </metric>
  <metric name="ShowState">
    <summary>
      Enumeration of the window show state, such as fullscreen or minimized.
      Values are enumerated in metrics::WindowMetricsEvent::ShowState.
    </summary>
  </metric>
  <metric name="TabCount">
    <summary>
      Number of tabs in the tab strip. Rounded down to the nearest exponential
      bucket (with a bucket spacing factor of 1.5). Will be 1 for windows with
      only one top-level WebContents, such as app windows.
    </summary>
  </metric>
  <metric name="Type">
    <summary>
      Enumeration for the type of the window. Values are enumerated in
      metrics::WindowMetricsEvent::Type.
    </summary>
  </metric>
  <metric name="WindowId">
    <summary>
      Session ID of the browser or app window this entry represents, unique for
      the browsing session.
    </summary>
  </metric>
</event>

<event name="TouchToFill.Shown">
  <owner>jdoerrie@chromium.org</owner>
  <owner>fhorschig@chromium.org</owner>
  <summary>
    Recorded when the Touch To Fill sheet is shown to the user.
  </summary>
  <metric name="UserAction" enum="TouchToFill.UserAction">
    <summary>
      The action a user took when interacting with the Touch To Fill sheet.
    </summary>
  </metric>
</event>

<event name="Translate">
  <owner>hamelphi@chromium.org</owner>
  <summary>
    Metrics related to a Translate event. These metrics are described in
    TranslateEventProto.
  </summary>
  <metric name="AcceptCount"/>
  <metric name="Country"/>
  <metric name="DeclineCount"/>
  <metric name="EventType"/>
  <metric name="IgnoreCount"/>
  <metric name="RankerResponse"/>
  <metric name="RankerVersion"/>
  <metric name="SourceLanguage" semantic_type="ST_DEMOGRAPHIC_INFO"/>
  <metric name="TargetLanguage" semantic_type="ST_DEMOGRAPHIC_INFO"/>
</event>

<event name="TrustedWebActivity.Open" singular="True">
  <owner>peconn@chromium.org</owner>
  <summary>
    Collected when a page is opened in a Trusted Web Activity.
  </summary>
  <metric name="HasOccurred" enum="Boolean">
    <summary>
      A boolean signaling that the event has occurred (typically only records
      true values).
    </summary>
  </metric>
</event>

<event name="UserActivity">
  <owner>jiameng@chromium.org</owner>
  <summary>
    Collects user activity events after staying idle for a short period of time.
  </summary>
  <metric name="BatteryPercent">
    <summary>
      Percentage of battery, bucketed to 5 percents, i.e. [0, 5%) is mapped to
      0, [5%, 10%) is mapped to 5 etc.
    </summary>
  </metric>
  <metric name="DeviceManagement">
    <summary>
      An enum representing whether the device is managed, defined in
      |chromeos::power::ml::UserActivityEvent::Features::ManagementType|.
    </summary>
  </metric>
  <metric name="DeviceMode">
    <summary>
      An enum representing the mode of the device, defined in
      |chromeos::power::ml::UserActivityEvent::Feature::DeviceMode|
    </summary>
  </metric>
  <metric name="DeviceType">
    <summary>
      An enum representing the type of the device, defined in
      |chromeos::power::ml::UserActivityEvent::Feature::DeviceType|
    </summary>
  </metric>
  <metric name="EventLogDuration">
    <summary>
      Time taken in seconds from when we start logging the features to the
      moment when the event type is known and we finish logging the complete
      event.
    </summary>
  </metric>
  <metric name="EventReason">
    <summary>
      An enum representing the reason of the event, defined in
      |chromeos::power::ml::UserActivityEvent::Event::Reason|.
    </summary>
  </metric>
  <metric name="EventType">
    <summary>
      An enum representing the type of the event, defined in
      |chromeos::power::ml::UserActivityEvent::Event::Type|.
    </summary>
  </metric>
  <metric name="KeyEventsInLastHour">
    <summary>
      The number of key events reported as user activity in the last hour. This
      is bucketized so that it is recorded precisely when it is in [0, 99],
      rounded to nearest 100 when it is in [100, 999] and rounded to nearest
      1000 when it is in [1000, 9999]. It is capped at 10000.
    </summary>
  </metric>
  <metric name="LastActivityDay">
    <summary>
      An enum representing the last activity day of the week, defined in
      |chromeos::power::ml::UserActivityEvent::Feature::DayOfWeek|.
    </summary>
  </metric>
  <metric name="LastActivityTime">
    <summary>
      Last activity time as hours since midnight in the local time zone.
    </summary>
  </metric>
  <metric name="LastUserActivityTime">
    <summary>
      Last user activity time as hours since midnight in the local time zone.
    </summary>
  </metric>
  <metric name="ModelApplied">
    <summary>
      A boolean value whether model prediction is applied in the screen-dim
      decision. False means powerd dims the screen regardless of the model
      prediction.
    </summary>
  </metric>
  <metric name="ModelDecisionThreshold">
    <summary>
      A threhold in the range of [0, 100]. Higher threshold makes screen-dim
      less likely.
    </summary>
  </metric>
  <metric name="ModelInactivityScore">
    <summary>
      Probability that user will remain inactive as predicted by the model. It
      is in the range of [0, 100]. If score is less than the decision threshold,
      dim will be deferred.
    </summary>
  </metric>
  <metric name="ModelResponse">
    <summary>
      Whether the model recommends the screen dim should be deferred (NO_DIM) or
      allowed (DIM), or encountered an error (MODEL_ERROR).
    </summary>
  </metric>
  <metric name="MouseEventsInLastHour">
    <summary>
      The number of mouse events reported as user activity in the last hour.
      This is bucketized so that it is recorded precisely when it is in [0, 99],
      rounded to nearest 100 when it is in [100, 999] and rounded to nearest
      1000 when it is in [1000, 9999]. It is capped at 10000.
    </summary>
  </metric>
  <metric name="OnBattery">
    <summary>
      Boolean value to represent whether the device is currently on battery
      power.
    </summary>
  </metric>
  <metric name="PreviousNegativeActionsCount">
    <summary>
      Number of times user reactivated, not including the current event.
    </summary>
  </metric>
  <metric name="PreviousPositiveActionsCount">
    <summary>
      Number of times user has remained idle, not including the current event.
    </summary>
  </metric>
  <metric name="RecentTimeActive">
    <summary>
      Duration of activity in seconds up to last activity.
    </summary>
  </metric>
  <metric name="RecentVideoPlayingTime">
    <summary>
      Recent video playing time in seconds.
    </summary>
  </metric>
  <metric name="ScreenDimDelay">
    <summary>
      Delay after which the screen will be dimmed in seconds.
    </summary>
  </metric>
  <metric name="ScreenDimmedInitially">
    <summary>
      Whether screen was dimmed at the start of the event.
    </summary>
  </metric>
  <metric name="ScreenDimOccurred">
    <summary>
      Whether screen dim occurred due to inactivity timeout.
    </summary>
  </metric>
  <metric name="ScreenDimToOffDelay">
    <summary>
      Delay after which the screen will be turned off in seconds, as measured
      from screen is dimmed. If dim is diabled, it is the delay from the start
      of inactivity.
    </summary>
  </metric>
  <metric name="ScreenLockedInitially">
    <summary>
      Whether screen was locked at the start of the event.
    </summary>
  </metric>
  <metric name="ScreenLockOccurred">
    <summary>
      Whether screen lock occurred.
    </summary>
  </metric>
  <metric name="ScreenOffInitially">
    <summary>
      Whether screen was off at the start of the event.
    </summary>
  </metric>
  <metric name="ScreenOffOccurred">
    <summary>
      Whether screen off occurred due to inactivity timeout.
    </summary>
  </metric>
  <metric name="SequenceId">
    <summary>
      The ID of this event in the current session.
    </summary>
  </metric>
  <metric name="TimeSinceLastKey">
    <summary>
      Time from last key event in seconds.
    </summary>
  </metric>
  <metric name="TimeSinceLastMouse">
    <summary>
      Time from last mouse event in seconds.
    </summary>
  </metric>
  <metric name="TimeSinceLastTouch">
    <summary>
      Time from last touch event in seconds.
    </summary>
  </metric>
  <metric name="TimeSinceLastVideoEnded">
    <summary>
      Time from the end of the last video playing in seconds.
    </summary>
  </metric>
  <metric name="TouchEventsInLastHour">
    <summary>
      The number of touch events reported as user activity in the last hour.
      This is bucketized so that it is recorded precisely when it is in [0, 99],
      rounded to nearest 100 when it is in [100, 999] and rounded to nearest
      1000 when it is in [1000, 9999]. It is capped at 10000.
    </summary>
  </metric>
</event>

<event name="UserActivityId">
  <owner>jiameng@chromium.org</owner>
  <summary>
    Records an activity that happened while a page was open.
  </summary>
  <metric name="ActivityId">
    <summary>
      The ID of the activity that happened while a page was open.
    </summary>
  </metric>
  <metric name="ContentType">
    <summary>
      Enumeration for the MIME type of the page. Values are enumerated in
      metrics::TabMetricsEvent::ContentType.
    </summary>
  </metric>
  <metric name="HasFormEntry">
    <summary>
      Boolean value indicating whether the page has any user-input text.
    </summary>
  </metric>
  <metric name="IsActive">
    <summary>
      Boolean value representing whether this tab is selected in its containing
      browser.
    </summary>
  </metric>
  <metric name="IsBrowserFocused">
    <summary>
      Boolean value representing whether the containing browser is in focus.
    </summary>
  </metric>
  <metric name="IsBrowserVisible">
    <summary>
      Boolean value representing whether the containing browser is visible.
    </summary>
  </metric>
  <metric name="IsTopmostBrowser">
    <summary>
      Boolean value representing whether the containing browser is the topmost
      one on the screen.
    </summary>
  </metric>
  <metric name="SiteEngagementScore">
    <summary>
      Site engagement score in the range [0, 100], rounded down to a multiple of
      10 to limit granularity.
    </summary>
  </metric>
</event>

<event name="VirtualKeyboard.Open">
  <owner>shend@chromium.org</owner>
  <summary>
    Collects the used input types with the Virtual Keyboard.
  </summary>
  <metric name="TextInputType">
    <summary>
      Type of a input field which the user is trying to use the Virtual Keyboard
      on.
    </summary>
    <aggregation>
      <history>
        <index fields="profile.form_factor"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="WebAPK.Install" singular="True">
  <owner>yfriedman@chromium.org</owner>
  <owner>hartmanng@chromium.org</owner>
  <owner>pkotwicz@chromium.org</owner>
  <summary>
    WebAPK usage metrics recorded on Install.
  </summary>
  <metric name="AppVersion">
    <summary>
      WebAPK app version that the user is installing.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Distributor" enum="WebApkDistributor">
    <summary>
      Distribution source of the WebAPK (browser, device policy, etc).
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Install" enum="Boolean">
    <summary>
      Recorded when this WebAPK is installed.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="WebAPK.SessionEnd" singular="True">
  <owner>yfriedman@chromium.org</owner>
  <owner>hartmanng@chromium.org</owner>
  <owner>pkotwicz@chromium.org</owner>
  <summary>
    WebAPK usage metrics recorded when the WebAPK is backgrounded.
  </summary>
  <metric name="AppVersion">
    <summary>
      WebAPK app version that the user has installed.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Distributor" enum="WebApkDistributor">
    <summary>
      Distribution source of the WebAPK (browser, device policy, etc).
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="SessionDuration">
    <summary>
      How long the user spent inside the WebAPK, in milliseconds. This will use
      exponential bucketing (ie, count in 10s of milliseconds at first, then
      100s, then seconds, 10s of seconds, minutes, 10 minutes, hours, 10 hours,
      days, weeks, years.)
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="WebAPK.Uninstall" singular="True">
  <owner>yfriedman@chromium.org</owner>
  <owner>hartmanng@chromium.org</owner>
  <owner>pkotwicz@chromium.org</owner>
  <summary>
    WebAPK usage metrics recorded on Uninstall.
  </summary>
  <metric name="AppVersion">
    <summary>
      WebAPK app version that the user has installed.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Distributor" enum="WebApkDistributor">
    <summary>
      Distribution source of the WebAPK (browser, device policy, etc).
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="InstalledDuration">
    <summary>
      How long between Install and Uninstall of a particular WebAPK, in seconds.
      This will use exponential bucketing (ie, count in seconds at first, then
      10s of seconds, minutes, 10 minutes, hours, 10 hours, days, weeks, years.)
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="LifetimeLaunches" enum="WebApkLifetimeLaunchCount">
    <summary>
      Records how many times the WebAPK was launched between install and
      uninstall (in coarse buckets).
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Uninstall" enum="Boolean">
    <summary>
      Recorded when this WebAPK is uninstalled.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="WebAPK.Visit" singular="True">
  <owner>yfriedman@chromium.org</owner>
  <owner>hartmanng@chromium.org</owner>
  <owner>pkotwicz@chromium.org</owner>
  <summary>
    WebAPK usage metrics recorded during a user's interaction with the site.
  </summary>
  <metric name="AppVersion">
    <summary>
      WebAPK app version that the user has installed.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Distributor" enum="WebApkDistributor">
    <summary>
      Distribution source of the WebAPK (browser, device policy, etc).
    </summary>
    <aggregation>
      <history>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Launch" enum="Boolean">
    <summary>
      Recorded every time this WebAPK is launched.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="LaunchSource" enum="LaunchFromHomeScreenSource">
    <summary>
      Launch source of the WebAPK.
    </summary>
    <aggregation>
      <history>
        <index fields="metrics.Distributor"/>
        <index fields="profile.country"/>
        <index fields="profile.form_factor"/>
        <index fields="profile.system_ram"/>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="WebRTC.AddressHarvesting">
  <owner>hta@chromium.org</owner>
  <summary>
    Collects usage patterns that may indicate attempts to gather users' IP
    addresses. A heuristic in the webrtc library tries to detect usages that may
    indicate attempts to gather users' IP addresses rather than setting up
    communication via WebRTC, and reports possible attempts.
  </summary>
  <metric name="UsagePattern">
    <summary>
      The usage pattern detected (an int encoding bit values). The bits are
      defined in third_party/webrtc/pc/peerconnection.h, in the
      &quot;PeerConnection::UsageEvent&quot; enum.
    </summary>
  </metric>
</event>

<event name="WebRTC.ComplexSdp">
  <owner>hbos@chromium.org</owner>
  <owner>guidou@chromium.org</owner>
  <summary>
    Logged when an application uses complex SDP in a WebRTC PeerConnection or
    experiences an error attempting to parse SDP. Such cases will result in
    errors if the application assumes the wrong default SDP format. This is an
    important concern during the transition of the default SDP format from Plan
    B to Unified Plan.
  </summary>
  <metric name="Category">
    <summary>
      A value that represents how complex/unparsable SDP is used. The categories
      are defined in blink::ComplexSdpCategory.
    </summary>
  </metric>
</event>

<event name="XR.PageSession" singular="True">
  <owner>offenwanger@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Records properties of page use in XR, including VR browsing and WebXR
    presentation.
  </summary>
  <metric name="Duration">
    <summary>
      The approximate amount of time the user spends on a page in XR in seconds.
      Times are reported accurately when low, for example, under a minute, and
      get rounded to minutes and then hours as they get larger. This is done by
      SessionTracker::GetRoundedDurationInSeconds.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="EnteredFullscreen" enum="Boolean">
    <summary>
      A boolean that is set to 1 if the user requested fullscreen while in XR on
      some element on the page.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="EnteredVROnPageReason" enum="VRStartReason">
    <summary>
      An enum that indicates that the user entered VR on this page and what
      triggered the entry into VR, where 1 means VR was entered through headset
      activation, and 2 means that request presentation triggered the entry into
      VR.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="TimeOnPage">
    <obsolete>
      Deprecated.
    </obsolete>
    <summary>
      Deprecated.
    </summary>
  </metric>
  <metric name="WasOmniboxNavigation" enum="Boolean">
    <summary>
      A boolean that is set to 1 if this page was entered into the omnibox,
      either manually or using autocomplete.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="WasVoiceSearchNavigation" enum="Boolean">
    <summary>
      A boolean that is set to 1 if this page was specifically requested and
      recognized by a voice search.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="XR.WebXR" singular="True">
  <owner>billorr@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Records information about WebXR methods that were used in a single
    navigation. The event will be recorded as the WebXR functions are called -
    since the event is singular, the data that will eventualy be sent will
    contain a union of metrics that were set in an event.
  </summary>
  <metric name="DidGetGamepads">
    <obsolete>
      Deprecated in M75.
    </obsolete>
    <summary>
      Boolean value that indicates that the Gamepad API was used on a WebXR
      site.
    </summary>
  </metric>
  <metric name="DidGetXRInputSources" enum="Boolean">
    <summary>
      Boolean value that indicates that the WebXR input API was used.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="DidRequestAvailableDevices" enum="Boolean">
    <summary>
      Boolean value that indicates that the API to enumerate devices was called.
      This API is only exposed through WebVR.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="DidRequestPose" enum="Boolean">
    <summary>
      Boolean value that indicates that poses were requested.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="DidRequestPresentation" enum="Boolean">
    <summary>
      Boolean value that indicates that presentation was requested.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="DidUseNavigatorXR" enum="Boolean">
    <summary>
      Boolean value that indicates that the WebXR Device API was used.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ReturnedDevice" enum="Boolean">
    <summary>
      Boolean value that indicates that a device was returned by the API to
      enumerate devices. This API is only exposed through WebVR.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="ReturnedPresentationCapableDevice" enum="Boolean">
    <summary>
      Boolean value that indicates that a device was returned by the API to
      enumerate devices, and that the device supports presentation.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="XR.WebXR.PresentationSession">
  <obsolete>
    Deprecated 5/2019
  </obsolete>
  <owner>xr-dev@chromium.org</owner>
  <summary>
    Records data for a presentation session, where WebXR is running an exclusive
    presentation to some device.
  </summary>
  <metric name="Duration">
    <summary>
      The approximate amount of time the user spends in presentation in seconds.
      Times are reported accurately when low, for example, under a minute, and
      get rounded to minutes and then hours as they get larger. This is done by
      SessionTracker::GetRoundedDurationInSeconds.
    </summary>
  </metric>
  <metric name="StartAction">
    <summary>
      An enum value to track specifically how the user got into XR presentation.
      See `vr::PresentationStartAction` for enum type declaration. 0: Other,
      catch all. 1: RequestFrom2DBrowsing, the page requested presentation while
      Chrome was in 2D mode. 2: RequestFromVRBrowsing, the page requested
      presentation while Chrome was in VR browsing mode. 3: HeadsetActivation,
      the user activated the VR headset while in 2D browsing on the page, which
      listens for headset activations to request presentation. 4: DeepLinkedApp
      (Obsolete), The page was launched in Chrome from the VR system home (e.g.,
      Daydream Home) and requested presentation.
    </summary>
  </metric>
</event>

<event name="XR.WebXR.Session">
  <owner>billorr@chromium.org</owner>
  <owner>bialpio@chromium.org</owner>
  <owner>xr-dev@chromium.org</owner>
  <owner>cassew@google.com</owner>
  <summary>
    When session ends, records data for a WebXR / WebVR session.
  </summary>
  <metric name="Duration">
    <summary>
      The approximate amount of time (in seconds) that elapsed from session
      creation to session end. Times are reported accurately when low, for
      example, under a minute, and get rounded to minutes and then hours as they
      get larger. This is done by SessionTracker::GetRoundedDurationInSeconds.
      For inline sessions, this might get pretty large.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <quantiles type="std-percentiles"/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="FeatureRequest.BoundedFloor" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'bounded-floor' feature request.
    </summary>
  </metric>
  <metric name="FeatureRequest.Local" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'local' feature request.
    </summary>
  </metric>
  <metric name="FeatureRequest.LocalFloor" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'local-floor' feature request.
    </summary>
  </metric>
  <metric name="FeatureRequest.Unbounded" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'unbounded' feature request.
    </summary>
  </metric>
  <metric name="FeatureRequest.Viewer" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'viewer' feature request.
    </summary>
  </metric>
  <metric name="FeatureUse.BoundedFloor" enum="Boolean">
    <summary>
      Whether the 'bounded-floor' feature was used during this session,
      regardless of whether it was used successfully.
    </summary>
  </metric>
  <metric name="FeatureUse.Local" enum="Boolean">
    <summary>
      Whether the 'local' feature was used during this session, regardless of
      whether it was used successfully.
    </summary>
  </metric>
  <metric name="FeatureUse.LocalFloor" enum="Boolean">
    <summary>
      Whether the 'local-floor' feature was used during this session, regardless
      of whether it was used successfully.
    </summary>
  </metric>
  <metric name="FeatureUse.Unbounded" enum="Boolean">
    <summary>
      Whether the 'unbounded' feature was used during this session, regardless
      of whether it was used successfully.
    </summary>
  </metric>
  <metric name="FeatureUse.Viewer" enum="Boolean">
    <summary>
      Whether the 'viewer' feature was used during this session, regardless of
      whether it was used successfully.
    </summary>
  </metric>
  <metric name="IsLegacyWebVR" enum="Boolean">
    <summary>
      Boolean value indicating whether a session was created using the legacy
      WebVR API rather than WebXR.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Mode" enum="XRSessionMode">
    <summary>
      An enum value specifying WebXR session's mode. See `device::SessionMode`
      for enum type declaration. 0: Unknown, catch all. 1: Inline session. 2:
      Immersive VR session. 3: Immersive AR session.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

<event name="XR.WebXR.SessionRequest">
  <owner>xr-dev@chromium.org</owner>
  <owner>cassew@google.com</owner>
  <summary>
    Recorded when promise returned by `requestSession` gets resolved / rejected.
  </summary>
  <metric name="Feature.BoundedFloor" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'bounded-floor' feature request.
    </summary>
  </metric>
  <metric name="Feature.Local" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'local' feature request.
    </summary>
  </metric>
  <metric name="Feature.LocalFloor" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'local-floor' feature request.
    </summary>
  </metric>
  <metric name="Feature.Unbounded" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'unbounded' feature request.
    </summary>
  </metric>
  <metric name="Feature.Viewer" enum="XRFeatureRequestStatus">
    <summary>
      State of the 'viewer' feature request.
    </summary>
  </metric>
  <metric name="Mode" enum="XRSessionModeRequest">
    <summary>
      An enum value that indicates that the `requestSession` API was called to
      request session with this mode. See `device::SessionMode` for enum type
      declaration. 0: Unknown, catch all. 1: Inline session was requested. 2:
      Immersive VR session was requested. 3: Immersive AR session was requested.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
  <metric name="Status" enum="XRSessionRequestStatus">
    <summary>
      An enum value that describes the result of the call to `requestSession`
      method. See `` for enum type declaration. 0: Success. 1: Other failure.
    </summary>
    <aggregation>
      <history>
        <statistics>
          <enumeration/>
        </statistics>
      </history>
    </aggregation>
  </metric>
</event>

</ukm-configuration>