qemu/qapi/stats.json

1 # -*- Mode: Python -*-
7 # See the COPYING file in the top-level directory.
9 # SPDX-License-Identifier: GPL-2.0-or-later
28 # @linear-histogram: stat is a linear histogram.
30 # @log2-histogram: stat is a logarithmic histogram, with one bucket
36   'data' : [ 'cumulative', 'instant', 'peak', 'linear-histogram',
37              'log2-histogram' ] }
92 # `query-stats`.
107 # @vcpus: list of QOM paths for the desired vCPU objects.
117 # The arguments to the `query-stats` command; specifies a target for
119 # information for that target.
121 # @target: the kind of objects to query.  Note that each possible
122 #     target may enable additional filtering options
131       'target': 'StatsTarget',
133   'discriminator': 'target',
139 # @scalar: single unsigned 64-bit integers.
143 # @list: list of unsigned 64-bit integers (used for histograms).
150             'list': [ 'uint64' ] } }
170 # @qom-path: Path to the object for which the statistics are returned,
173 # @stats: list of statistics.
179             '*qom-path': 'str',
183 # @query-stats:
185 # Return runtime-collected statistics for objects such as the VM or
191 # Returns: a list of statistics, one for each provider and object
196 { 'command': 'query-stats',
207 #     identified by a target, a provider (both available in
216 #     measured.  Only present if @exponent is non-zero; @base and
217 #     @exponent together form a SI prefix (e.g., _nano-_ for
218 #     ``base=10`` and ``exponent=-9``) or IEC binary prefix (e.g.
219 #     _kibi-_ for ``base=2`` and ``exponent=10``)
224 # @bucket-size: Present when @type is "linear-histogram", contains the
235             '*bucket-size': 'uint32' } }
240 # Schema for all available statistics for a provider and target.
244 # @target: the kind of object that can be queried through the
247 # @stats: list of statistics.
253             'target': 'StatsTarget',
257 # @query-stats-schemas:
259 # Return the schema for all available runtime-collected statistics.
263 # .. note:: Runtime-collected statistics and their names fall outside
277 { 'command': 'query-stats-schemas',