kcenon::common::interfaces::stats_snapshot Struct Reference

Point-in-time snapshot of component statistics. More...

#include <stats_snapshot.h>

Collaboration diagram for kcenon::common::interfaces::stats_snapshot:

Public Member Functions
auto	to_json () const -> std::string
	Serialize snapshot to JSON string.

Public Attributes
std::string	component_name
	Component identifier.
std::chrono::system_clock::time_point	timestamp
	Snapshot capture time.
std::unordered_map< std::string, stats_value >	values
	Metric key-value pairs.

Detailed Description

Point-in-time snapshot of component statistics.

Immutable value type that captures statistics with metadata. Designed for serialization, logging, and transmission to monitoring systems.

Usage Example:

stats_snapshot snapshot{
    .component_name = "http_client",
    .timestamp = std::chrono::system_clock::now(),
    .values = {
        {"request_count", 1500},
        {"error_rate", 0.02},
        {"is_healthy", true}
    }
};
 
// Serialize to JSON for logging
std::cout << snapshot.to_json() << std::endl;

Definition at line 52 of file stats_snapshot.h.

Member Function Documentation

to_json()

auto kcenon::common::interfaces::stats_snapshot::to_json ( ) const -> std::string

inlinenodiscard

Serialize snapshot to JSON string.

Format: { "component": "component_name", "timestamp": "2025-01-30T12:34:56Z", "metrics": { "metric1": value1, "metric2": value2 } }

Returns

JSON string representation

Definition at line 72 of file stats_snapshot.h.

    {
        std::ostringstream json;
        json << "{\n";
        json << "  \"component\": \"" << component_name << "\",\n";
 
        // Format timestamp as ISO 8601
        const auto time_t = std::chrono::system_clock::to_time_t(timestamp);
        std::tm tm{};
#ifdef _WIN32
        localtime_s(&tm, &time_t);
#else
        localtime_r(&time_t, &tm);
#endif
        json << "  \"timestamp\": \""
             << std::put_time(&tm, "%Y-%m-%dT%H:%M:%S")
             << "Z\",\n";
 
        // Serialize metrics
        json << "  \"metrics\": {\n";
 
        bool first = true;
        for (const auto& [key, value] : values) {
            if (!first) {
                json << ",\n";
            }
            first = false;
 
            json << "    \"" << key << "\": ";
 
            // Visit variant and format value
            std::visit([&json](const auto& v) {
                using T = std::decay_t<decltype(v)>;
                if constexpr (std::is_same_v<T, std::int64_t>) {
                    json << v;
                } else if constexpr (std::is_same_v<T, double>) {
                    json << std::fixed << std::setprecision(6) << v;
                } else if constexpr (std::is_same_v<T, std::string>) {
                    json << "\"" << v << "\"";
                } else if constexpr (std::is_same_v<T, bool>) {
                    json << (v ? "true" : "false");
                }
            }, value);
        }
 
        json << "\n  }\n";
        json << "}";
 
        return json.str();
    }

References component_name, timestamp, and values.

Member Data Documentation

component_name

std::string kcenon::common::interfaces::stats_snapshot::component_name

Component identifier.

Definition at line 53 of file stats_snapshot.h.

Referenced by to_json().

timestamp

std::chrono::system_clock::time_point kcenon::common::interfaces::stats_snapshot::timestamp

Snapshot capture time.

Definition at line 54 of file stats_snapshot.h.

Referenced by to_json().

values

std::unordered_map<std::string, stats_value> kcenon::common::interfaces::stats_snapshot::values

Metric key-value pairs.

Definition at line 55 of file stats_snapshot.h.

Referenced by to_json().

---

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

• include/kcenon/common/interfaces/stats_snapshot.h