kcenon::monitoring::aggregation_result Struct Reference

Result of time series aggregation. More...

#include <time_series.h>

Collaboration diagram for kcenon::monitoring::aggregation_result:

Public Member Functions
	aggregation_result ()
summary_data	get_summary () const
	Get statistics for the aggregated data.
double	get_average () const
	Get average value over the time period.
double	get_rate () const
	Get rate of change (per second)

Public Attributes
std::vector< time_point_data >	points
std::chrono::system_clock::time_point	query_start
std::chrono::system_clock::time_point	query_end
size_t	total_samples

Detailed Description

Result of time series aggregation.

Definition at line 151 of file time_series.h.

Constructor & Destructor Documentation

aggregation_result()

kcenon::monitoring::aggregation_result::aggregation_result ( )

inline

Definition at line 157 of file time_series.h.

: total_samples(0) {}

Member Function Documentation

get_average()

double kcenon::monitoring::aggregation_result::get_average ( ) const

inline

Get average value over the time period.

Definition at line 173 of file time_series.h.

                               {
        if (points.empty()) return 0.0;
        
        double sum = 0.0;
        uint64_t total_weight = 0;
        
        for (const auto& point : points) {
            sum += point.value * point.sample_count;
            total_weight += point.sample_count;
        }
        
        return total_weight > 0 ? sum / total_weight : 0.0;
    }

References points.

get_rate()

double kcenon::monitoring::aggregation_result::get_rate ( ) const

inline

Get rate of change (per second)

Definition at line 190 of file time_series.h.

                            {
        if (points.size() < 2) return 0.0;
        
        const auto& first = points.front();
        const auto& last = points.back();
        
        auto duration = std::chrono::duration_cast<std::chrono::seconds>(
            last.timestamp - first.timestamp);
        
        if (duration.count() <= 0) return 0.0;
        
        return (last.value - first.value) / duration.count();
    }

References points.

get_summary()

summary_data kcenon::monitoring::aggregation_result::get_summary ( ) const

inline

Get statistics for the aggregated data.

Definition at line 162 of file time_series.h.

                                     {
        summary_data summary;
        for (const auto& point : points) {
            summary.add_sample(point.value);
        }
        return summary;
    }

References points, and kcenon::monitoring::summary.

Member Data Documentation

points

std::vector<time_point_data> kcenon::monitoring::aggregation_result::points

Definition at line 152 of file time_series.h.

Referenced by get_average(), get_rate(), get_summary(), and kcenon::monitoring::time_series::query().

query_end

std::chrono::system_clock::time_point kcenon::monitoring::aggregation_result::query_end

Definition at line 154 of file time_series.h.

Referenced by kcenon::monitoring::time_series::query().

query_start

std::chrono::system_clock::time_point kcenon::monitoring::aggregation_result::query_start

Definition at line 153 of file time_series.h.

Referenced by kcenon::monitoring::time_series::query().

total_samples

size_t kcenon::monitoring::aggregation_result::total_samples

Definition at line 155 of file time_series.h.

Referenced by kcenon::monitoring::time_series::query().

---

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

• include/kcenon/monitoring/utils/time_series.h