Monitoring System 0.1.0
System resource monitoring with pluggable collectors and alerting
Loading...
Searching...
No Matches
kcenon::monitoring::interrupt_collector Class Reference

Hardware and software interrupt statistics monitoring collector. More...

#include <interrupt_collector.h>

Inheritance diagram for kcenon::monitoring::interrupt_collector:
Inheritance graph
Collaboration diagram for kcenon::monitoring::interrupt_collector:
Collaboration graph

Public Member Functions

 interrupt_collector ()
 
 ~interrupt_collector () override=default
 
 interrupt_collector (const interrupt_collector &)=delete
 
interrupt_collectoroperator= (const interrupt_collector &)=delete
 
 interrupt_collector (interrupt_collector &&)=delete
 
interrupt_collectoroperator= (interrupt_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.
 
auto get_metric_types () const -> std::vector< std::string > override
 Get supported metric types.
 
auto get_metadata () const -> plugin_metadata override
 Get plugin metadata.
 
auto initialize (const config_map &config) -> bool override
 
auto get_statistics () const -> stats_map override
 
interrupt_metrics get_last_metrics () const
 
bool is_interrupt_monitoring_available () const
 
- Public Member Functions inherited from kcenon::monitoring::collector_plugin
virtual ~collector_plugin ()=default
 
virtual void shutdown ()
 Shutdown plugin and release resources.
 

Private Member Functions

void add_interrupt_metrics (std::vector< metric > &metrics, const interrupt_metrics &data)
 

Private Attributes

std::unique_ptr< interrupt_info_collectorcollector_
 
bool enabled_ {true}
 
bool collect_per_cpu_ {false}
 
bool collect_soft_interrupts_ {true}
 
interrupt_metrics last_metrics_
 
std::atomic< size_t > collection_count_ {0}
 
std::atomic< size_t > collection_errors_ {0}
 

Detailed Description

Hardware and software interrupt statistics monitoring collector.

Implements collector_plugin interface for unified plugin architecture.

Definition at line 111 of file interrupt_collector.h.

Constructor & Destructor Documentation

◆ interrupt_collector() [1/3]

kcenon::monitoring::interrupt_collector::interrupt_collector ( )

◆ ~interrupt_collector()

kcenon::monitoring::interrupt_collector::~interrupt_collector ( )
overridedefault

◆ interrupt_collector() [2/3]

kcenon::monitoring::interrupt_collector::interrupt_collector ( const interrupt_collector & )
delete

◆ interrupt_collector() [3/3]

kcenon::monitoring::interrupt_collector::interrupt_collector ( interrupt_collector && )
delete

Member Function Documentation

◆ add_interrupt_metrics()

void kcenon::monitoring::interrupt_collector::add_interrupt_metrics ( std::vector< metric > & metrics,
const interrupt_metrics & data )
private

◆ collect()

auto kcenon::monitoring::interrupt_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.

◆ get_last_metrics()

interrupt_metrics kcenon::monitoring::interrupt_collector::get_last_metrics ( ) const

Get last collected interrupt metrics

Returns
Most recent interrupt_metrics reading

◆ get_metadata()

auto kcenon::monitoring::interrupt_collector::get_metadata ( ) const -> plugin_metadata
inlineoverridevirtual

Get plugin metadata.

Returns
Metadata describing this plugin

Default implementation returns minimal metadata. Override to provide rich plugin information.

Reimplemented from kcenon::monitoring::collector_plugin.

Definition at line 129 of file interrupt_collector.h.

129 {
130 return plugin_metadata{
131 .name = name(),
132 .description = "Hardware and software interrupt statistics",
133 .category = plugin_category::platform,
134 .version = "1.0.0",
135 .dependencies = {},
136 .requires_platform_support = true
137 };
138 }
auto name() const -> std::string_view override
Get the unique name of this plugin.
@ platform
Platform-specific (VM, uptime, interrupts)

References name(), and kcenon::monitoring::platform.

Here is the call graph for this function:

◆ get_metric_types()

auto kcenon::monitoring::interrupt_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()

auto kcenon::monitoring::interrupt_collector::get_statistics ( ) const -> stats_map
overridevirtual

Get collector statistics

Returns
Map of statistic name to value

Reimplemented from kcenon::monitoring::collector_plugin.

◆ initialize()

auto kcenon::monitoring::interrupt_collector::initialize ( const config_map & config) -> bool
overridevirtual

Initialize the collector with configuration

Parameters
configConfiguration options:
  • "collect_per_cpu": "true"/"false" (default: false)
  • "collect_soft_interrupts": "true"/"false" (default: true)
Returns
true if initialization successful

Reimplemented from kcenon::monitoring::collector_plugin.

◆ interval()

auto kcenon::monitoring::interrupt_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 125 of file interrupt_collector.h.

125{ return std::chrono::seconds(15); }

◆ is_available()

auto kcenon::monitoring::interrupt_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_interrupt_monitoring_available()

bool kcenon::monitoring::interrupt_collector::is_interrupt_monitoring_available ( ) const

Check if interrupt monitoring is available

Returns
True if interrupt metrics are accessible

◆ name()

auto kcenon::monitoring::interrupt_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 123 of file interrupt_collector.h.

123{ return "interrupt_collector"; }

Referenced by get_metadata().

Here is the caller graph for this function:

◆ operator=() [1/2]

interrupt_collector & kcenon::monitoring::interrupt_collector::operator= ( const interrupt_collector & )
delete

◆ operator=() [2/2]

interrupt_collector & kcenon::monitoring::interrupt_collector::operator= ( interrupt_collector && )
delete

Member Data Documentation

◆ collect_per_cpu_

bool kcenon::monitoring::interrupt_collector::collect_per_cpu_ {false}
private

Definition at line 172 of file interrupt_collector.h.

172{false};

◆ collect_soft_interrupts_

bool kcenon::monitoring::interrupt_collector::collect_soft_interrupts_ {true}
private

Definition at line 173 of file interrupt_collector.h.

173{true};

◆ collection_count_

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

Definition at line 179 of file interrupt_collector.h.

179{0};

◆ collection_errors_

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

Definition at line 180 of file interrupt_collector.h.

180{0};

◆ collector_

std::unique_ptr<interrupt_info_collector> kcenon::monitoring::interrupt_collector::collector_
private

Definition at line 168 of file interrupt_collector.h.

◆ enabled_

bool kcenon::monitoring::interrupt_collector::enabled_ {true}
private

Definition at line 171 of file interrupt_collector.h.

171{true};

◆ last_metrics_

interrupt_metrics kcenon::monitoring::interrupt_collector::last_metrics_
private

Definition at line 176 of file interrupt_collector.h.


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