<!--
Copyright 2021 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 History 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="Discover.Search.SearchStatus"
    enum="LocalSearchServiceResponseStatus" expires_after="2022-01-08">
  <owner>callistus@google.com</owner>
  <owner>showoff-eng@google.com</owner>
  <summary>
    Records the search status when searching with the Local Search Service in
    the Discover (internally &quot;Showoff&quot;) app. This is logged once per
    user search and will count the number of searches while the index is still
    empty, successful searches, etc.
  </summary>
</histogram>

<histogram name="Discover.SearchConcept.ReadStatus"
    enum="HelpAppSearchConceptReadStatus" expires_after="2023-08-08">
  <owner>chenjih@google.com</owner>
  <owner>tby@chromium.org</owner>
  <owner>showoff-eng@google.com</owner>
  <summary>
    Various status codes on reading persistence file from disk, in the search
    handler used by the ChromeOS launcher. Emitted once when a read happens to
    the persistence file, and this happens once per login. Some number of file
    not exist values is expected, because the persistence file does not exist
    before it is written for the first time.
  </summary>
</histogram>

<histogram name="Discover.SearchConcept.WriteStatus"
    enum="HelpAppSearchConceptWriteStatus" expires_after="2023-08-08">
  <owner>chenjih@google.com</owner>
  <owner>tby@chromium.org</owner>
  <owner>showoff-eng@google.com</owner>
  <summary>
    Various status codes on writing persistence file back to disk, in the search
    handler used by the ChromeOS launcher. Emitted once when a write happens to
    the persistence file, and this happens once per new web contents arrives,
    which is expected to be approx. once per login.
  </summary>
</histogram>

<histogram name="Discover.SearchHandler.SearchAvailableTime" units="ms"
    expires_after="2023-08-08">
  <owner>chenjih@google.com</owner>
  <owner>tby@chromium.org</owner>
  <owner>showoff-eng@google.com</owner>
  <summary>
    The latency of the help search availability after the help app search
    handler constructed. Recorded each time a help app search handler is
    constructed.
  </summary>
</histogram>

<histogram name="Discover.SearchHandler.SearchResultStatus"
    enum="HelpAppSearchHandlerSearchResultStatus" expires_after="2023-10-08">
  <owner>chenjih@google.com</owner>
  <owner>tby@chromium.org</owner>
  <owner>zufeng@google.com</owner>
  <owner>showoff-eng@google.com</owner>
  <summary>
    The end result of a search using the help app search handler. Logged once
    per time a search finishes. Not logged if the search is canceled by a new
    search starting. Use this to calculate the proportion of searches where the
    search handler is ready vs not ready. &quot;Ready&quot; means the update
    finished and the search handler is ready to handle searches.
  </summary>
</histogram>

</histograms>

</histogram-configuration>