Virtualization metrics monitoring collector. More...

#include <vm_collector.h>

Inheritance diagram for kcenon::monitoring::vm_collector:

Collaboration diagram for kcenon::monitoring::vm_collector:

Public Member Functions
	vm_collector ()

	~vm_collector ()=default

	vm_collector (const vm_collector &)=delete

vm_collector &	operator= (const vm_collector &)=delete

	vm_collector (vm_collector &&)=delete

vm_collector &	operator= (vm_collector &&)=delete

auto	name () const -> std::string_view override
	Get the unique name of this plugin.

auto	collect () -> std::vector< metric > override
	Collect current metrics from this plugin.

auto	interval () const -> std::chrono::milliseconds override
	Get the collection interval for this plugin.

auto	is_available () const -> bool override
	Check if this plugin is available on the current system.

bool	is_healthy () const

auto	get_metric_types () const -> std::vector< std::string > override
	Get supported metric types.

bool	initialize (const std::unordered_map< std::string, std::string > &config) override

std::unordered_map< std::string, double >	get_statistics () const override

Public Member Functions inherited from kcenon::monitoring::collector_plugin
virtual	~collector_plugin ()=default

virtual auto	get_metadata () const -> plugin_metadata
	Get plugin metadata.

virtual void	shutdown ()
	Shutdown plugin and release resources.

Private Member Functions
metric	create_metric (const std::string &name, double value, const std::unordered_map< std::string, std::string > &tags={}, const std::string &unit="") const

Private Attributes
std::unique_ptr< vm_info_collector >	collector_

bool	enabled_ {true}

std::chrono::milliseconds	collection_interval_ {std::chrono::seconds(30)}

std::mutex	stats_mutex_

std::atomic< size_t >	collection_count_ {0}

std::atomic< size_t >	collection_errors_ {0}

Detailed Description

Virtualization metrics monitoring collector.

Collects metrics regarding the virtualization environment.

Definition at line 107 of file vm_collector.h.

Constructor & Destructor Documentation

◆ vm_collector() [1/3]

kcenon::monitoring::vm_collector::vm_collector ( )

◆ ~vm_collector()

kcenon::monitoring::vm_collector::~vm_collector ( )

default

◆ vm_collector() [2/3]

kcenon::monitoring::vm_collector::vm_collector ( const vm_collector & )

delete

◆ vm_collector() [3/3]

kcenon::monitoring::vm_collector::vm_collector ( vm_collector && )

delete

Member Function Documentation

◆ collect()

auto kcenon::monitoring::vm_collector::collect ( ) -> std::vector< metric >

overridevirtual

Collect current metrics from this plugin.

Returns: Vector of collected metrics

This method is called periodically based on interval(). Implementations should:

Return quickly (< 100ms recommended)
Handle errors gracefully (return empty vector on failure)
Be thread-safe if concurrent collection is enabled
Avoid blocking I/O when possible

Implements kcenon::monitoring::collector_plugin.

◆ create_metric()

metric kcenon::monitoring::vm_collector::create_metric	(	const std::string &	name,
		double	value,
		const std::unordered_map< std::string, std::string > &	tags = {},
		const std::string &	unit = "" ) const

private

◆ get_metric_types()

auto kcenon::monitoring::vm_collector::get_metric_types ( ) const -> std::vector< std::string >

overridevirtual

Get supported metric types.

Returns: Vector of metric type names this plugin produces

Used for filtering and documentation.

Implements kcenon::monitoring::collector_plugin.

◆ get_statistics()

std::unordered_map< std::string, double > kcenon::monitoring::vm_collector::get_statistics ( ) const

overridevirtual

Get collector statistics

Returns: Map of statistic name to value

Reimplemented from kcenon::monitoring::collector_plugin.

◆ initialize()

bool kcenon::monitoring::vm_collector::initialize ( const std::unordered_map< std::string, std::string > & config )

overridevirtual

Initialize the collector with configuration

Parameters

config Configuration options

Returns: true if initialization successful

Reimplemented from kcenon::monitoring::collector_plugin.

◆ interval()

auto kcenon::monitoring::vm_collector::interval ( ) const -> std::chrono::milliseconds

inlineoverridevirtual

Get the collection interval for this plugin.

Returns: Collection interval in milliseconds

The registry uses this value to schedule collection tasks. Typical values:

Fast metrics (CPU, memory): 1-5 seconds
Slow metrics (disk, network): 10-60 seconds
Very slow metrics (SMART data): 5-15 minutes

Implements kcenon::monitoring::collector_plugin.

Definition at line 121 of file vm_collector.h.

121{ return collection_interval_; }

kcenon::monitoring::vm_collector::collection_interval_

std::chrono::milliseconds collection_interval_

Definition vm_collector.h:149

References collection_interval_.

◆ is_available()

auto kcenon::monitoring::vm_collector::is_available ( ) const -> bool

overridevirtual

Check if this plugin is available on the current system.

Returns: True if plugin can collect metrics, false otherwise

Availability checks may include:

Platform compatibility (Linux-only, Windows-only)
Hardware presence (GPU, sensors)
Permission checks (root required)
Resource availability (proc filesystem, WMI)

The registry may skip unavailable plugins during registration.

Implements kcenon::monitoring::collector_plugin.

◆ is_healthy()

bool kcenon::monitoring::vm_collector::is_healthy ( ) const

Check if collector is in a healthy state

Returns: True if collector is operational

◆ name()

auto kcenon::monitoring::vm_collector::name ( ) const -> std::string_view

inlineoverridevirtual

Get the unique name of this plugin.

Returns: Plugin name (must be unique within registry)

The name is used for:

Plugin lookup and discovery
Configuration mapping
Metric tagging (added as "collector" tag)

Implements kcenon::monitoring::collector_plugin.

Definition at line 119 of file vm_collector.h.

119{ return "vm_collector"; }

◆ operator=() [1/2]

vm_collector & kcenon::monitoring::vm_collector::operator= ( const vm_collector & )

delete

◆ operator=() [2/2]

vm_collector & kcenon::monitoring::vm_collector::operator= ( vm_collector && )

delete

Member Data Documentation

◆ collection_count_

std::atomic<size_t> kcenon::monitoring::vm_collector::collection_count_ {0}

private

Definition at line 153 of file vm_collector.h.

153{0};

◆ collection_errors_

std::atomic<size_t> kcenon::monitoring::vm_collector::collection_errors_ {0}

private

Definition at line 154 of file vm_collector.h.

154{0};

◆ collection_interval_

std::chrono::milliseconds kcenon::monitoring::vm_collector::collection_interval_ {std::chrono::seconds(30)}

private

Definition at line 149 of file vm_collector.h.

149{std::chrono::seconds(30)};

Referenced by interval().

◆ collector_

std::unique_ptr<vm_info_collector> kcenon::monitoring::vm_collector::collector_

private

Definition at line 145 of file vm_collector.h.

◆ enabled_

bool kcenon::monitoring::vm_collector::enabled_ {true}

private

Definition at line 148 of file vm_collector.h.

148{true};

◆ stats_mutex_

std::mutex kcenon::monitoring::vm_collector::stats_mutex_

mutableprivate

Definition at line 152 of file vm_collector.h.

The documentation for this class was generated from the following file:

include/kcenon/monitoring/collectors/vm_collector.h

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ vm_collector() [1/3]

◆ ~vm_collector()

◆ vm_collector() [2/3]

◆ vm_collector() [3/3]

Member Function Documentation

◆ collect()

◆ create_metric()

◆ get_metric_types()

◆ get_statistics()

◆ initialize()

◆ interval()

◆ is_available()

◆ is_healthy()

◆ name()

◆ operator=() [1/2]

◆ operator=() [2/2]

Member Data Documentation

◆ collection_count_

◆ collection_errors_

◆ collection_interval_

◆ collector_

◆ enabled_

◆ stats_mutex_