<!--
Copyright 2024 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 others 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="Linux.DisplayServerSupport" enum="DisplayServerSupport"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The supported display server protocols. (Linux only) Logged on each start
    up.
  </summary>
</histogram>

<histogram name="Linux.Distro.Debian" enum="LinuxDistroDebianVersion"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The Debian version number (eg. 8: Jessie, 9: Stretch). Logged once on
    startup if Linux.Distro3 is Debian.
  </summary>
</histogram>

<histogram name="Linux.Distro.Fedora" enum="LinuxDistroFedoraVersion"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The Fedora version number (eg. 27, 28) Logged once on startup if
    Linux.Distro3 is Fedora.
  </summary>
</histogram>

<histogram name="Linux.Distro.Mint" enum="LinuxDistroMintVersion"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The Linux Mint version number (eg. 20, 20.1) Logged once on startup if
    Linux.Distro3 is Mint.
  </summary>
</histogram>

<histogram name="Linux.Distro.OpenSuseLeap"
    enum="LinuxDistroOpenSuseLeapVersion" expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The openSUSE Leap version number, logged as 1000*major + minor (eg. 15001 =
    15.1). Logged once on startup if Linux.Distro3 is openSUSE Leap.
  </summary>
</histogram>

<histogram name="Linux.Distro.Ubuntu" enum="LinuxDistroUbuntuVersion"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The Ubuntu version number, logged as 1000*year + month (eg. 16004 = 16.04
    Xenial). Logged once on startup if Linux.Distro3 is Ubuntu.
  </summary>
</histogram>

<histogram name="Linux.Distro3" enum="LinuxDistro3" expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>The Linux distro used. Logged on each start up.</summary>
</histogram>

<histogram name="Linux.GlibcVersion" enum="LinuxGlibcVersion"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The version of glibc used. (Linux only) Logged on each start up.
  </summary>
</histogram>

<histogram name="Linux.KernelVersion" units="version" expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>thestig@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The version of the Linux kernel used. Logged as 1000000*major + 1000*minor +
    patch. (Linux only) Logged on each start up.
  </summary>
</histogram>

<histogram name="Linux.SandboxStatus" enum="LinuxSandboxStatus"
    expires_after="2025-05-11">
  <owner>mpdenton@google.com</owner>
  <owner>src/sandbox/linux/OWNERS</owner>
  <summary>
    The Linux sandbox status. This describes what sandboxing features are
    enabled (such as the suid/namespace sandboxes, various namespaces, seccomp
    bpf, ...). Emitted once at startup.
  </summary>
</histogram>

<histogram name="Linux.Wayland.Compositor" enum="WaylandCompositor"
    expires_after="never">
<!-- expires-never: Needed to measure Linux Wayland compositors used by users. -->

  <owner>thomasanderson@chromium.org</owner>
  <owner>nickdiego@igalia.com</owner>
  <summary>
    The Linux Wayland compositor in use during the session. Logged each time the
    browser connects to a Wayland display, capturing which compositor is being
    used. This helps to understand the distribution of Wayland compositors.
  </summary>
</histogram>

<histogram name="Linux.Wayland.Shell" enum="LinuxWaylandShellName"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>fangzhoug@chromium.org</owner>
  <owner>adunaev@igalia.com</owner>
  <owner>chrome-gpu-metric-alerts@chromium.org</owner>
  <summary>
    The Linux Wayland shell protocol(s) available. Logged in each session when
    the compositor announces a Wayland protocol extension that provides the
    desktop shell functionality (i.e., turns abstract surfaces into windows that
    can be positioned, moved, resized, etc., depending on the particular shell).
  </summary>
</histogram>

<histogram name="Linux.WindowManager" enum="LinuxWindowManagerName"
    expires_after="never">
<!-- expires-never: Needed to measure Linux ecosystem. -->

  <owner>pkotwicz@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The window manager used. (Linux only) Logged on each start up.
  </summary>
</histogram>

<histogram name="Linux.X11.XInput2" enum="BooleanEnabled"
    expires_after="2026-04-26">
  <owner>hidehiko@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>Whether X Input Extension version 2.x is available.</summary>
</histogram>

</histograms>

</histogram-configuration>
