068cc51d42
Allow retrieving the statistics from a specific provider only.
This can be used in the future by HMP commands such as "info
sync-profile" or "info profile". The next patch also adds
filter-by-provider capabilities to the HMP equivalent of
query-stats, "info stats".
Example:
{ "execute": "query-stats",
"arguments": {
"target": "vm",
"providers": [
{ "provider": "kvm" } ] } }
The QAPI is a bit more verbose than just a list of StatsProvider,
so that it can be subsequently extended with filtering of statistics
by name.
If a provider is specified more than once in the filter, each request
will be included separately in the output.
Extracted from a patch by Mark Kanda.
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Dr. David Alan Gilbert <dgilbert@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
46 lines
1.4 KiB
C
46 lines
1.4 KiB
C
/*
|
|
* Copyright (c) 2022 Oracle and/or its affiliates.
|
|
*
|
|
* This work is licensed under the terms of the GNU GPL, version 2.
|
|
* See the COPYING file in the top-level directory.
|
|
*/
|
|
|
|
#ifndef STATS_H
|
|
#define STATS_H
|
|
|
|
#include "qapi/qapi-types-stats.h"
|
|
|
|
typedef void StatRetrieveFunc(StatsResultList **result, StatsTarget target,
|
|
strList *targets, Error **errp);
|
|
typedef void SchemaRetrieveFunc(StatsSchemaList **result, Error **errp);
|
|
|
|
/*
|
|
* Register callbacks for the QMP query-stats command.
|
|
*
|
|
* @provider: stats provider checked against QMP command arguments
|
|
* @stats_fn: routine to query stats:
|
|
* @schema_fn: routine to query stat schemas:
|
|
*/
|
|
void add_stats_callbacks(StatsProvider provider,
|
|
StatRetrieveFunc *stats_fn,
|
|
SchemaRetrieveFunc *schemas_fn);
|
|
|
|
/*
|
|
* Helper routines for adding stats entries to the results lists.
|
|
*/
|
|
void add_stats_entry(StatsResultList **, StatsProvider, const char *id,
|
|
StatsList *stats_list);
|
|
void add_stats_schema(StatsSchemaList **, StatsProvider, StatsTarget,
|
|
StatsSchemaValueList *);
|
|
|
|
/*
|
|
* True if a string matches the filter passed to the stats_fn callabck,
|
|
* false otherwise.
|
|
*
|
|
* Note that an empty list means no filtering, i.e. all strings will
|
|
* return true.
|
|
*/
|
|
bool apply_str_list_filter(const char *string, strList *list);
|
|
|
|
#endif /* STATS_H */
|