tools/metrics/histograms/histograms_xml/scanning/histograms.xml

<!--
Copyright 2020 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 Scan app 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 send CLs to chromium-metrics-reviews@google.com rather than to specific
individuals. These CLs will be automatically reassigned to a reviewer within
about 5 minutes. This approach helps the metrics team to load-balance incoming
reviews. Googlers can read more about this at go/gwsq-gerrit.
-->

<histogram-configuration>

<histograms>

<histogram name="Scanning.NumDetectedScanners" units="scanners"
    expires_after="2021-12-04">
  <owner>gavinwill@chromium.org</owner>
  <owner>jschettler@chromium.org</owner>
  <owner>cros-peripherals@google.com</owner>
  <summary>
    Records the number of detected scanners. Recorded each time detected
    scanners are received.
  </summary>
</histogram>

<histogram name="Scanning.NumPagesScanned" units="pages"
    expires_after="2021-12-04">
  <owner>gavinwill@chromium.org</owner>
  <owner>jschettler@chromium.org</owner>
  <owner>cros-peripherals@google.com</owner>
  <summary>Records the number of pages scanned in a successful scan.</summary>
</histogram>

<histogram name="Scanning.ReadyTime" units="ms" expires_after="2021-12-04">
  <owner>gavinwill@chromium.org</owner>
  <owner>jschettler@chromium.org</owner>
  <owner>cros-peripherals@google.com</owner>
  <summary>
    Records the time between sending a request for scanners and receiving
    capabilities for the selected scanner, which is essentially the time between
    the user launching the Scan app and being able to interact with it to select
    a scanner, change scan settings, or start a scan.
  </summary>
</histogram>

<histogram name="Scanning.ScanAppEntryPoint" enum="ScanAppEntryPoint"
    expires_after="2021-12-04">
  <owner>gavinwill@chromium.org</owner>
  <owner>jschettler@chromium.org</owner>
  <owner>cros-peripherals@google.com</owner>
  <summary>
    Records the entry point of where the Scan App was launched from in Chrome
    OS. Used to track the relative entry points of the app.
  </summary>
</histogram>

<histogram name="Scanning.ScanJobSuccessful" enum="Boolean"
    expires_after="2021-12-04">
  <owner>gavinwill@chromium.org</owner>
  <owner>jschettler@chromium.org</owner>
  <owner>cros-peripherals@google.com</owner>
  <summary>
    Records true if the attempted scan job completed successfully and false if
    the scan job failed for any reason. This metric will not include canceled
    scan jobs.
  </summary>
</histogram>

</histograms>

</histogram-configuration>