<!--
Copyright 2020 The Chromium Authors
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 DataReductionProxy histograms
along with a detailed description for each histogram.

For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md

Please follow the instructions in the OWNERS file in this directory to find a
reviewer. If no OWNERS file exists, please consider signing up at
go/reviewing-metrics (Googlers only), as all subdirectories are expected to
have an OWNERS file. As a last resort you can send the CL to
chromium-metrics-reviews@google.com.
-->

<histogram-configuration>

<histograms>

<histogram name="ConnectivityDetector.ConnectionState.{Client}"
    enum="ConnectivityDetectorConnectionState" expires_after="2023-04-20">
  <owner>curranmax@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <owner>jianli@chromium.org</owner>
  <summary>
    Result of the connection state after the HTTP Probe made by connectivity
    detector finishes and the connection state is updated.
  </summary>
  <token key="Client">
    <variant name="OfflineDetector"/>
    <variant name="OfflineIndicatorController"/>
  </token>
</histogram>

<histogram name="ConnectivityDetector.DefaultHttpProbeResult.{Client}"
    enum="ProbeResult" expires_after="2023-04-20">
  <owner>curranmax@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <owner>jianli@chromium.org</owner>
  <summary>
    Result of the HTTP Probe made by connectivity detector. Recorded everytime
    the probe to the default URL completes (in either success or failure) or
    timeouts.
  </summary>
  <token key="Client">
    <variant name="OfflineDetector"/>
    <variant name="OfflineIndicatorController"/>
  </token>
</histogram>

<histogram name="ConnectivityDetector.FallbackHttpProbeResult.{Client}"
    enum="ProbeResult" expires_after="2023-04-20">
  <owner>curranmax@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <owner>jianli@chromium.org</owner>
  <summary>
    Result of the HTTP Probe made by connectivity detector. Recorded everytime
    the probe to the fallback URL completes (in either success or failure) or
    timeouts.
  </summary>
  <token key="Client">
    <variant name="OfflineDetector"/>
    <variant name="OfflineIndicatorController"/>
  </token>
</histogram>

<histogram name="ConnectivityDetector.SentHttpProbe.{Client}" units="count"
    expires_after="2023-04-20">
  <owner>curranmax@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <owner>jianli@chromium.org</owner>
  <owner>src/chrome/browser/data_saver/OWNERS</owner>
  <summary>
    Count of times when a HTTP Probe was made by connectivity detector.
  </summary>
  <token key="Client">
    <variant name="OfflineDetector"/>
    <variant name="OfflineIndicatorController"/>
  </token>
</histogram>

<histogram name="DataReductionProxy.BypassedBytes" units="bytes"
    expires_after="2022-04-20">
  <obsolete>
    Data reduction proxy was turned down.
  </obsolete>
  <owner>bengr@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <summary>
    Counts the response bytes that did not go through the data reduction proxy
    as the result of a bypass event.
  </summary>
</histogram>

<histogram name="DataReductionProxy.EnabledState"
    enum="DataReductionProxyEnabledState" expires_after="2022-04-20">
  <obsolete>
    Data reduction proxy was turned down.
  </obsolete>
  <owner>rajendrant@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <summary>
    Samples of user interactions with the Data Saver settings menu across all
    platforms (android, IOS, desktop extension). Data is collected whenever user
    toggles the ON/OFF switch in the settings menu for reducing data usage.

    For desktop, Off-to-On/On-to-Off histogram count will increment when the
    data saver extension is installed/uninstalled respectively as well.
  </summary>
</histogram>

<histogram name="DataReductionProxy.ProxyPrefMigrationResult"
    enum="DataReductionProxyProxyPrefMigrationResult"
    expires_after="2022-04-20">
  <obsolete>
    Data reduction proxy was turned down.
  </obsolete>
  <owner>sclittle@chromium.org</owner>
  <owner>src/chrome/browser/data_saver/OWNERS</owner>
  <summary>
    Records the result of migrating the Data Reduction Proxy away from being
    configured via a proxy preference, including cases when no migration action
    was taken.
  </summary>
</histogram>

<histogram name="DataReductionProxy.StartupState"
    enum="DataReductionProxyStartupState" expires_after="2022-04-20">
  <obsolete>
    Data reduction proxy was turned down.
  </obsolete>
  <owner>rajendrant@chromium.org</owner>
  <owner>tbansal@chromium.org</owner>
  <summary>
    Samples of the state of the data reduction proxy on Chrome startup. The
    proxy will either be unavailable (the feature hasn't been rolled out to this
    user yet), not enabled (the feature is available but the user doesn't have
    it turned on), or enabled (the feature is enabled and turned on).
  </summary>
</histogram>

<histogram name="DataUse.AppTabState" units="bytes" expires_after="2023-05-07">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Records the data use of Chrome user traffic by the foregound vs. background
    state of the app and tab.
  </summary>
</histogram>

<histogram name="DataUse.BackgroundToDataRecievedPerByte" units="ms"
    expires_after="2021-12-20">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    The time since Chrome is in background when background data use happens.
    Recorded for each byte of background data use. The source of traffic whether
    from user browsing or chrome services is added as suffix to this histogram.
  </summary>
</histogram>

<histogram name="DataUse.BackgroundToFirstDownstream" units="ms"
    expires_after="2021-12-20">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    The time since Chrome is in background when first background data use
    happens. Recorded when first background downstream data use after Chrome is
    in background. The source of traffic whether from user browsing or chrome
    services is added as suffix to this histogram.
  </summary>
</histogram>

<histogram name="DataUse.BytesReceived2" units="bytes"
    expires_after="2022-06-19">
  <obsolete>
    Obsoleted.
  </obsolete>
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Count of total bytes received by the Chrome on the network. This is recorded
    when requests complete.
  </summary>
</histogram>

<histogram name="DataUse.BytesReceived3.Delegate" units="bytes"
    expires_after="2023-08-28">
  <owner>curranmax@chromium.org</owner>
  <owner>ryansturm@chromium.org</owner>
  <owner>spelchat@chromium.org</owner>
  <summary>
    Count of total bytes received by the Chrome on the network, as reported by
    the network delegate. This is recorded when requests complete.
  </summary>
</histogram>

<histogram name="DataUse.BytesSent" units="bytes" expires_after="2022-08-28">
  <obsolete>
    Obsoleted.
  </obsolete>
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Count of total bytes sent by the Chrome on the network. With network
    servicification this is recorded when requests complete.
  </summary>
</histogram>

<histogram name="DataUse.BytesSent3.Delegate" units="bytes"
    expires_after="2023-08-28">
  <owner>curranmax@chromium.org</owner>
  <owner>ryansturm@chromium.org</owner>
  <owner>spelchat@chromium.org</owner>
  <summary>
    Count of total bytes sent by the Chrome on the network, as reported by the
    network delegate. With network servicification this is recorded when
    requests complete.
  </summary>
</histogram>

<histogram name="DataUse.ContentType.UserTrafficKB" enum="DataUseContentType"
    expires_after="2023-03-05">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Data use of user traffic by different content types. Recorded in KB when
    network bytes are received by Chrome.
  </summary>
</histogram>

<histogram name="DataUse.FavIcon.Downstream" units="bytes"
    expires_after="2021-12-20">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Records the downstream network data use of favicon requests. Logged when the
    request is completed or redirected. Zero bytes are recorded when the request
    is served from cache.
  </summary>
</histogram>

<histogram name="DataUse.FavIcon.Downstream.Non200Response" units="bytes"
    expires_after="2021-12-20">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Records the downstream network data use of favicon requests with non 200
    response code. Logged when the request is completed or redirected.
  </summary>
</histogram>

<histogram name="DataUse.PageTransition.UserTrafficKB"
    enum="DataUsePageTransition" expires_after="2021-12-20">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    Data use of user traffic by different core page transition types. Recorded
    in KB when the URL request finishes.
  </summary>
</histogram>

<histogram name="DataUse.TrafficSize.User" units="bytes"
    expires_after="2023-05-07">
  <owner>rajendrant@chromium.org</owner>
  <owner>mcrouse@chromium.org</owner>
  <summary>
    The total amount of data use of Chrome for user traffic. This traffic has
    content::ResourceRequestInfo attached to its request. If the OS is not
    Android all the requests are considered foreground.
  </summary>
</histogram>

</histograms>

</histogram-configuration>