chromium/tools/metrics/histograms/metadata/cros/histograms.xml

<!--
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 Cros 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
[email protected].
-->

<histogram-configuration>

<histograms>

<histogram name="Cros.CrOSActionRecorderEvent" enum="CrOSActionRecorderEvent"
    expires_after="2022-05-01">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    This histogram is emitted each time when CrOSAction is recorded by the
    CrOSActionRecorder. For each CrOSAction multiple values can be emitted,
    corresponding to different events happened during the action processing by
    CrOSActionRecorder.
  </summary>
</histogram>

<histogram name="CrosDisks.ArchiveType" enum="CrosDisksArchiveType"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Archive type that the ChromeOS cros-disks daemon is requested to mount.
  </summary>
</histogram>

<histogram name="CrosDisks.DeviceMediaType" enum="CrosDisksDeviceMediaType"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Media type of removable device that the ChromeOS cros-disks daemon is
    requested to mount.
  </summary>
</histogram>

<histogram name="CrosDisks.Error.{Action}.{FileSystem}" enum="DaemonError"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the program performing the {Action} action on a partition
    with the {FileSystem} filesystem.
  </summary>
  <token key="Action">
    <variant name="Format"/>
    <variant name="Rename"/>
  </token>
  <token key="FileSystem">
    <variant name="exfat"/>
    <variant name="ntfs"/>
    <variant name="vfat"/>
  </token>
</histogram>

<histogram name="CrosDisks.Error.{SysCall}.{FileSystem}" enum="PopularOSErrno"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the `{SysCall}` system call when the ChromeOS cros-disks
    daemon deals with a `{FileSystem}` filesystem.
  </summary>
  <token key="SysCall">
    <variant name="mount"/>
    <variant name="syncfs"/>
    <variant name="umount"/>
    <variant name="umount2"/>
  </token>
  <token key="FileSystem">
    <variant name="archive"/>
    <variant name="drivefs"/>
    <variant name="exfat"/>
    <variant name="ext2"/>
    <variant name="ext3"/>
    <variant name="ext4"/>
    <variant name="fuseblk.exfat"/>
    <variant name="fuseblk.ntfs"/>
    <variant name="fusebox"/>
    <variant name="hfsplus"/>
    <variant name="iso9660"/>
    <variant name="ntfs3"/>
    <variant name="rar"/>
    <variant name="smbfs"/>
    <variant name="sshfs"/>
    <variant name="udf"/>
    <variant name="vfat"/>
    <variant name="zip"/>
  </token>
</histogram>

<histogram name="CrosDisks.FilesystemType" enum="CrosDisksFilesystemType"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    File system type of external media that the ChromeOS cros-disks daemon is
    requested to mount.
  </summary>
</histogram>

<histogram name="CrosDisks.Fuse.FuseArchive" enum="FuseArchiveError"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the fuse-archive program, which is called every time a
    user opens various archive files in ChromeOS Files App.
  </summary>
</histogram>

<histogram name="CrosDisks.Fuse.FuseZip" enum="FuseZipError"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the ZIP mounting program mount-zip, which is called every
    time a user opens a ZIP archive in ChromeOS Files App.
  </summary>
</histogram>

<histogram name="CrosDisks.Fuse.Rar2fs" enum="Rar2fsError"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the RAR mounting program rar2fs, which is called every
    time a user opens a RAR archive in ChromeOS Files App.
  </summary>
</histogram>

<histogram name="CrosDisks.PrematureTermination.{Daemon}" enum="DaemonError"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by a FUSE daemon that unexpectedly terminated (i.e. before
    being requested by cros-disks to unmount and exit).
  </summary>
  <token key="Daemon">
    <variant name="drivefs"/>
    <variant name="fuse-archive"/>
    <variant name="fusebox"/>
    <variant name="mount-exfat-fuse"/>
    <variant name="mount-zip"/>
    <variant name="ntfs-3g"/>
    <variant name="rar2fs"/>
    <variant name="smbfs"/>
    <variant name="sshfs"/>
  </token>
</histogram>

<histogram name="CrosDisks.ReadOnlyFileSystemAfterError"
    enum="CrosDisksFilesystemType" expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    File system type of external media that the ChromeOS cros-disks daemon had
    to mount in read-only mode because there was an error when trying to mount
    them in read-write mode. See crbug.com/1366204.
  </summary>
</histogram>

<histogram name="CrosDisks.Time.{Action}.{FileSystem}" units="ms"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Time taken by the program performing the {Action} action on a partition with
    the {FileSystem} filesystem.
  </summary>
  <token key="Action">
    <variant name="Format"/>
    <variant name="Rename"/>
  </token>
  <token key="FileSystem">
    <variant name="exfat"/>
    <variant name="ntfs"/>
    <variant name="vfat"/>
  </token>
</histogram>

<histogram name="CrosDisks.Time.{SysCall}.{FileSystem}" units="ms"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Time taken by the `{SysCall}` system call when the ChromeOS cros-disks
    daemon deals with a `{FileSystem}` filesystem.
  </summary>
  <token key="SysCall">
    <variant name="mount"/>
    <variant name="syncfs"/>
    <variant name="umount"/>
    <variant name="umount2"/>
  </token>
  <token key="FileSystem">
    <variant name="archive"/>
    <variant name="drivefs"/>
    <variant name="exfat"/>
    <variant name="ext2"/>
    <variant name="ext3"/>
    <variant name="ext4"/>
    <variant name="fuseblk.exfat"/>
    <variant name="fuseblk.ntfs"/>
    <variant name="fusebox"/>
    <variant name="hfsplus"/>
    <variant name="iso9660"/>
    <variant name="ntfs3"/>
    <variant name="rar"/>
    <variant name="smbfs"/>
    <variant name="sshfs"/>
    <variant name="udf"/>
    <variant name="vfat"/>
    <variant name="zip"/>
  </token>
</histogram>

<histogram name="CrosDisksClient.FormatCompletedError"
    enum="CrosDisksClientFormatError" expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the ChromeOS cros-disks daemon when formatting an external
    drive.
  </summary>
</histogram>

<histogram name="CrosDisksClient.FormatTime" units="ms"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Time taken by the ChromeOS cros-disks daemon to format an external drive.
  </summary>
</histogram>

<histogram name="CrosDisksClient.MountCompletedError"
    enum="CrosDisksClientMountError" expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the ChromeOS cros-disks daemon when mounting a file
    system.
  </summary>
</histogram>

<histogram name="CrosDisksClient.MountErrorMountType"
    enum="CrosDisksMountTypeError" expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Combination of (mount type, mount error) returned by the ChromeOS cros-disks
    daemon.
  </summary>
</histogram>

<histogram name="CrosDisksClient.MountTime" units="ms"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Time taken by the ChromeOS cros-disks daemon to mount a file system.
  </summary>
</histogram>

<histogram name="CrosDisksClient.UnmountError" enum="CrosDisksClientMountError"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Error returned by the ChromeOS cros-disks daemon when unmounting a file
    system.
  </summary>
</histogram>

<histogram name="CrosDisksClient.UnmountTime" units="ms"
    expires_after="2025-03-01">
  <owner>[email protected]</owner>
  <owner>src/ui/file_manager/OWNERS</owner>
  <summary>
    Time taken by the ChromeOS cros-disks daemon to unmount a file system.
  </summary>
</histogram>

</histograms>

</histogram-configuration>