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

<!--
Copyright 2023 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 Virtualization system related,
i.e. the stack common to all Guests running on Chrome OS, 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>

<variants name="DiskStatsDuration">
  <variant name="Boot" summary="boot"/>
  <variant name="Daily" summary="last 24 hours"/>
</variants>

<variants name="VmName">
  <variant name="ARCVM" summary="ARCVM"/>
  <variant name="BOREALIS" summary="BOREALIS"/>
  <variant name="BRUSCHETTA" summary="BRUSCHETTA"/>
  <variant name="PLUGIN_VM" summary="PLUGIN_VM"/>
  <variant name="TERMINA" summary="TERMINA"/>
</variants>

<histogram name="Virtualization.{Name}.Disk.{Duration}.IoCount" units="count"
    expires_after="2025-01-05">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    The total count of read, write, flush, and discard operations that
    virtio-blk devices during {Duration} in {Name}.
  </summary>
  <token key="Name" variants="VmName"/>
  <token key="Duration" variants="DiskStatsDuration"/>
</histogram>

<histogram name="Virtualization.{Name}.Disk.{Duration}.IoSize" units="MiB"
    expires_after="2025-01-05">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    The total size of read and write IO that virtio-blk devices performed during
    {Duration} in {Name}.
  </summary>
  <token key="Name" variants="VmName"/>
  <token key="Duration" variants="DiskStatsDuration"/>
</histogram>

<histogram name="Virtualization.{Name}.Disk.{Duration}.IoTicks"
    units="Milliseconds" expires_after="2025-01-05">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    The total time that virtio-blk devices performed read, write, flush, and
    discard operations during {Duration} in {Name}.
  </summary>
  <token key="Name" variants="VmName"/>
  <token key="Duration" variants="DiskStatsDuration"/>
</histogram>

<histogram name="Virtualization.{Name}.Disk.{Duration}.KbPerTicks"
    units="KiBPerMilliSecond" expires_after="2025-01-05">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    The average throughput of read and write operations that virio-blk devices
    performed during {Duration} in {Name}.
  </summary>
  <token key="Name" variants="VmName"/>
  <token key="Duration" variants="DiskStatsDuration"/>
</histogram>

<histogram name="Virtualization.{Name}.SecurityKeyAttach" enum="BooleanSuccess"
    expires_after="2025-02-01">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    True when the vmc key-attach command to attach a security key to a VM is
    successful. False when the command has failed.
  </summary>
  <token key="Name" variants="VmName"/>
</histogram>

<histogram name="Virtualization.{Name}.StartDuration" units="Milliseconds"
    expires_after="2025-01-05">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    The time taken to start a {Name} VM in milliseconds. This metric is emitted
    at the end of a StartVmRequest for {Name} VM by the Concierge daemon in
    Chrome OS.
  </summary>
  <token key="Name" variants="VmName"/>
</histogram>

<histogram name="Virtualization.{Name}.StopDuration" units="Milliseconds"
    expires_after="2025-01-05">
  <owner>[email protected]</owner>
  <owner>[email protected]</owner>
  <summary>
    The time taken to stop a {Name} VM in milliseconds. This metric is emitted
    at the end of a StopVmRequest for {Name} VM by the Concierge daemon in
    Chrome OS.
  </summary>
  <token key="Name" variants="VmName"/>
</histogram>

</histograms>

</histogram-configuration>