NAME

quark_queue_get_stats — fetch queue statistics

SYNOPSIS

#include <quark.h>

void
quark_queue_get_stats(struct quark_queue *qq, struct quark_queue_stats *qs);

quark_queue_get_stats copies out all internal statistics from qq into qs. quark_queue_stats is defined as:

struct quark_queue_stats {
	u64	insertions;
	u64	removals;
	u64	aggregations;
	u64	non_aggregations;
	u64	lost;
	int	backend;
};

insertions: A counter of all events that were inserted into the queue sorting/buffering structures, this is roughly 1:1 with the actual events we read from the backend.
removals: A counter of removals of the above, you can count alive items by counting the difference.
aggregations: A counter of how many events were aggregated, this is an absolute counter, meaning a FORK+EXEC+EXIT counts as 1 aggregation, which consumes 3 events.
non_aggregations: The opposite of aggregations. It is increased by one when we didn't aggregate.
lost: A a counter of missed backend events. This can happen if the user didn't call quark_queue_get_event(3) fast enough or if quark simply can't handle the load, the former is way more likely. It is a state counter representing total loss, the user should compare to an old reading to know if it increased.
backend: Active queue backend, either QQ_EBPF or QQ_KPROBE.