Specialized buffer for tracking load average history. More...

#include <time_series_buffer.h>

Collaboration diagram for kcenon::monitoring::load_average_history:

Public Member Functions
	load_average_history (size_t max_samples=1000)

	load_average_history (const load_average_history &)=delete

load_average_history &	operator= (const load_average_history &)=delete

	load_average_history (load_average_history &&)=delete

load_average_history &	operator= (load_average_history &&)=delete

void	add_sample (double load_1m, double load_5m, double load_15m, std::chrono::system_clock::time_point timestamp=std::chrono::system_clock::now())
	Add a load average sample.

template<typename Duration >
std::vector< load_average_sample >	get_samples (Duration duration) const
	Get samples within a duration from now.

std::vector< load_average_sample >	get_samples_since (std::chrono::system_clock::time_point since) const
	Get samples since a specific timestamp.

std::vector< load_average_sample >	get_all_samples () const
	Get all samples in chronological order.

template<typename Duration >
load_average_statistics	get_statistics (Duration duration) const
	Get statistics for samples within a duration.

load_average_statistics	get_statistics () const
	Get statistics for all samples.

common::Result< load_average_sample >	get_latest () const
	Get the latest sample.

size_t	size () const noexcept
	Get current number of samples.

bool	empty () const noexcept
	Check if buffer is empty.

size_t	capacity () const noexcept
	Get buffer capacity.

void	clear () noexcept
	Clear all samples.

size_t	memory_footprint () const noexcept
	Get memory footprint in bytes.

Static Private Member Functions
static load_average_statistics	calculate_statistics (const std::vector< load_average_sample > &samples)

Private Attributes
detail::time_series_ring_buffer< load_average_sample >	buffer_

Detailed Description

Specialized buffer for tracking load average history.

This class wraps detail::time_series_ring_buffer to provide a specialized interface for load average samples with per-field statistics calculation.

Definition at line 529 of file time_series_buffer.h.

Constructor & Destructor Documentation

◆ load_average_history() [1/3]

kcenon::monitoring::load_average_history::load_average_history ( size_t max_samples = 1000 )

inlineexplicit

Definition at line 534 of file time_series_buffer.h.

534: buffer_(max_samples) {}

kcenon::monitoring::load_average_history::buffer_

detail::time_series_ring_buffer< load_average_sample > buffer_

Definition time_series_buffer.h:531

◆ load_average_history() [2/3]

kcenon::monitoring::load_average_history::load_average_history ( const load_average_history & )

delete

◆ load_average_history() [3/3]

kcenon::monitoring::load_average_history::load_average_history ( load_average_history && )

delete

Member Function Documentation

◆ add_sample()

void kcenon::monitoring::load_average_history::add_sample	(	double	load_1m,
		double	load_5m,
		double	load_15m,
		std::chrono::system_clock::time_point	timestamp = std::chrono::system_clock::now() )

inline

Add a load average sample.

Parameters

load_1m	1-minute load average
load_5m	5-minute load average
load_15m	15-minute load average
timestamp	Optional timestamp (defaults to now)

Definition at line 548 of file time_series_buffer.h.

                                                    {
        buffer_.add_sample(load_average_sample(timestamp, load_1m, load_5m, load_15m));
    }

References buffer_.

◆ calculate_statistics()

static load_average_statistics kcenon::monitoring::load_average_history::calculate_statistics ( const std::vector< load_average_sample > & samples )

inlinestaticprivate

Definition at line 646 of file time_series_buffer.h.

                                                       {
        load_average_statistics stats;
 
        if (samples.empty()) {
            stats.load_1m_stats.sample_count = 0;
            stats.load_1m_stats.min_value = 0.0;
            stats.load_1m_stats.max_value = 0.0;
            stats.load_5m_stats = stats.load_1m_stats;
            stats.load_15m_stats = stats.load_1m_stats;
            return stats;
        }
 
        std::vector<double> values_1m, values_5m, values_15m;
        values_1m.reserve(samples.size());
        values_5m.reserve(samples.size());
        values_15m.reserve(samples.size());
 
        for (const auto& sample : samples) {
            values_1m.push_back(sample.load_1m);
            values_5m.push_back(sample.load_5m);
            values_15m.push_back(sample.load_15m);
        }
 
        auto oldest = samples.front().timestamp;
        auto newest = samples.back().timestamp;
 
        stats.load_1m_stats = detail::calculate_basic_statistics(values_1m, oldest, newest);
        stats.load_5m_stats = detail::calculate_basic_statistics(values_5m, oldest, newest);
        stats.load_15m_stats = detail::calculate_basic_statistics(values_15m, oldest, newest);
 
        return stats;
    }

References kcenon::monitoring::detail::calculate_basic_statistics(), kcenon::monitoring::load_average_statistics::load_15m_stats, kcenon::monitoring::load_average_statistics::load_1m_stats, kcenon::monitoring::load_average_statistics::load_5m_stats, kcenon::monitoring::time_series_statistics::max_value, kcenon::monitoring::time_series_statistics::min_value, and kcenon::monitoring::time_series_statistics::sample_count.

Referenced by get_statistics(), and get_statistics().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ capacity()

size_t kcenon::monitoring::load_average_history::capacity ( ) const

inlinenoexcept

Get buffer capacity.

Definition at line 627 of file time_series_buffer.h.

                                     {
        return buffer_.capacity();
    }

References buffer_.

◆ clear()

void kcenon::monitoring::load_average_history::clear ( )

inlinenoexcept

Clear all samples.

Definition at line 634 of file time_series_buffer.h.

                          {
        buffer_.clear();
    }

References buffer_.

◆ empty()

bool kcenon::monitoring::load_average_history::empty ( ) const

inlinenoexcept

Check if buffer is empty.

Definition at line 620 of file time_series_buffer.h.

                                {
        return buffer_.empty();
    }

References buffer_.

◆ get_all_samples()

std::vector< load_average_sample > kcenon::monitoring::load_average_history::get_all_samples ( ) const

inline

Get all samples in chronological order.

Returns: Vector of all samples

Definition at line 578 of file time_series_buffer.h.

                                                           {
        return buffer_.get_all_samples();
    }

References buffer_.

Referenced by get_statistics().

Here is the caller graph for this function:

◆ get_latest()

common::Result< load_average_sample > kcenon::monitoring::load_average_history::get_latest ( ) const

inline

Get the latest sample.

Returns: Result containing the latest sample or error

Definition at line 606 of file time_series_buffer.h.

                                                         {
        return buffer_.get_latest();
    }

References buffer_.

◆ get_samples()

template<typename Duration >

std::vector< load_average_sample > kcenon::monitoring::load_average_history::get_samples ( Duration duration ) const

inline

Get samples within a duration from now.

Parameters

duration How far back to look

Returns: Vector of samples within the duration

Definition at line 560 of file time_series_buffer.h.

                                                                        {
        return buffer_.get_samples(duration);
    }

References buffer_.

Referenced by get_statistics().

Here is the caller graph for this function:

◆ get_samples_since()

std::vector< load_average_sample > kcenon::monitoring::load_average_history::get_samples_since ( std::chrono::system_clock::time_point since ) const

inline

Get samples since a specific timestamp.

Parameters

since The timestamp to start from

Returns: Vector of samples since the timestamp

Definition at line 569 of file time_series_buffer.h.

                                                     {
        return buffer_.get_samples_since(since);
    }

References buffer_.

◆ get_statistics() [1/2]

load_average_statistics kcenon::monitoring::load_average_history::get_statistics ( ) const

inline

Get statistics for all samples.

Returns: Statistics for all samples

Definition at line 597 of file time_series_buffer.h.

                                                   {
        auto samples = get_all_samples();
        return calculate_statistics(samples);
    }

References calculate_statistics(), and get_all_samples().

Here is the call graph for this function:

◆ get_statistics() [2/2]

template<typename Duration >

load_average_statistics kcenon::monitoring::load_average_history::get_statistics ( Duration duration ) const

inline

Get statistics for samples within a duration.

Parameters

duration How far back to look

Returns: Statistics for the samples

Definition at line 588 of file time_series_buffer.h.

                                                                    {
        auto samples = get_samples(duration);
        return calculate_statistics(samples);
    }

References calculate_statistics(), and get_samples().

Here is the call graph for this function:

◆ memory_footprint()

size_t kcenon::monitoring::load_average_history::memory_footprint ( ) const

inlinenoexcept

Get memory footprint in bytes.

Definition at line 641 of file time_series_buffer.h.

                                             {
        return buffer_.memory_footprint();
    }

References buffer_.

◆ operator=() [1/2]

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

delete

◆ operator=() [2/2]

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

delete

◆ size()

size_t kcenon::monitoring::load_average_history::size ( ) const

inlinenoexcept

Get current number of samples.

Definition at line 613 of file time_series_buffer.h.

                                 {
        return buffer_.size();
    }

References buffer_.

Member Data Documentation

◆ buffer_

detail::time_series_ring_buffer<load_average_sample> kcenon::monitoring::load_average_history::buffer_

private

Definition at line 531 of file time_series_buffer.h.

Referenced by add_sample(), capacity(), clear(), empty(), get_all_samples(), get_latest(), get_samples(), get_samples_since(), memory_footprint(), and size().

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

include/kcenon/monitoring/utils/time_series_buffer.h

Public Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ load_average_history() [1/3]

◆ load_average_history() [2/3]

◆ load_average_history() [3/3]

Member Function Documentation

◆ add_sample()

◆ calculate_statistics()

◆ capacity()

◆ clear()

◆ empty()

◆ get_all_samples()

◆ get_latest()

◆ get_samples()

◆ get_samples_since()

◆ get_statistics() [1/2]

◆ get_statistics() [2/2]

◆ memory_footprint()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ size()

Member Data Documentation

◆ buffer_