<!--
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 Google 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="GoogleUpdate.ErrorHresult" enum="Hresult"
    expires_after="2024-06-26">
  <owner>sorin@chromium.org</owner>
  <owner>waffles@chromium.org</owner>
  <summary>The HRESULT for a failed on-demand update check.</summary>
</histogram>

<histogram name="GoogleUpdate.InstallDetails.UpdateCohort"
    enum="GoogleUpdateHashedCohortName" expires_after="2024-06-01">
  <owner>waffles@chromium.org</owner>
  <owner>chrome-metrics-team@google.com</owner>
  <owner>omaha-team@google.com</owner>
  <summary>
    The hash of the browser's update cohort name that was present during browser
    startup. Warning: this histogram was expired from 2019-06-01 to 2023-01-23;
    data may be missing. This histogram is reported on every UMA log on Windows.
  </summary>
</histogram>

<histogram name="GoogleUpdate.InstallDetails.UpdateCohortId"
    enum="GoogleUpdateHashedCohortId" expires_after="2024-09-01">
  <owner>waffles@chromium.org</owner>
  <owner>chrome-metrics-team@google.com</owner>
  <owner>omaha-team@google.com</owner>
  <summary>
    The base::PersistentHash of the browser's update cohort ID that was present
    at the time of the metrics upload. This histogram is reported on every UMA
    log on Windows. Unlike cohort name, cohort ID will generally be unique for
    each rollout group and control group.
  </summary>
</histogram>

<histogram name="GoogleUpdate.StartingUpdateState"
    enum="BooleanAlreadyUpdating" expires_after="2020-10-15">
  <owner>dtrainor@chromium.org</owner>
  <owner>nyquist@chromium.org</owner>
  <summary>
    (Android-only) Whether or not an update was being tracked as 'in progress'
    when another update was started.
  </summary>
</histogram>

<histogram name="GoogleUpdate.UpdateErrorCode" enum="GoogleUpdateErrorCode"
    expires_after="2024-03-24">
  <owner>sorin@chromium.org</owner>
  <owner>waffles@chromium.org</owner>
  <summary>The error code for a failed on-demand update check.</summary>
</histogram>

<histogram name="GoogleUpdate.UpgradeResult" enum="GoogleUpdateUpgradeStatus"
    expires_after="2024-01-14">
  <owner>sorin@chromium.org</owner>
  <owner>waffles@chromium.org</owner>
  <summary>The result of an on-demand update check.</summary>
</histogram>

</histograms>

</histogram-configuration>
