Logging backend for debugging and diagnostics. More...

#include <metrics_backend.h>

Inheritance diagram for kcenon::thread::metrics::LoggingBackend:

Collaboration diagram for kcenon::thread::metrics::LoggingBackend:

Public Member Functions
	LoggingBackend ()=default
	Default constructor.

	~LoggingBackend () override=default
	Destructor.

std::string	name () const override
	Get the backend name.

std::string	export_base (const BaseSnapshot &snapshot) const override
	Export base metrics snapshot.

std::string	export_enhanced (const EnhancedSnapshot &snapshot) const override
	Export enhanced metrics snapshot.

Public Member Functions inherited from kcenon::thread::metrics::MetricsBackend
virtual	~MetricsBackend ()=default
	Virtual destructor for proper cleanup.

virtual void	set_prefix (const std::string &prefix)
	Set metric name prefix.

const std::string &	prefix () const
	Get current metric name prefix.

virtual void	add_label (const std::string &key, const std::string &value)
	Add a label to all exported metrics.

const std::map< std::string, std::string > &	labels () const
	Get all configured labels.

Additional Inherited Members
Protected Member Functions inherited from kcenon::thread::metrics::MetricsBackend
	MetricsBackend ()=default
	Default constructor.

Protected Attributes inherited from kcenon::thread::metrics::MetricsBackend
std::string	prefix_ {"thread_pool"}
	Metric name prefix.

std::map< std::string, std::string >	labels_
	Labels to attach to all metrics.

Detailed Description

Logging backend for debugging and diagnostics.

Exports metrics in a human-readable format suitable for log files and console output.

Definition at line 236 of file metrics_backend.h.

Constructor & Destructor Documentation

◆ LoggingBackend()

kcenon::thread::metrics::LoggingBackend::LoggingBackend ( )

default

Default constructor.

◆ ~LoggingBackend()

kcenon::thread::metrics::LoggingBackend::~LoggingBackend ( )

overridedefault

Destructor.

Member Function Documentation

◆ export_base()

std::string kcenon::thread::metrics::LoggingBackend::export_base ( const BaseSnapshot & snapshot ) const

nodiscardoverridevirtual

Export base metrics snapshot.

Parameters

snapshot The base metrics snapshot to export.

Returns: Formatted string representation.

Implements kcenon::thread::metrics::MetricsBackend.

Definition at line 266 of file metrics_backend.cpp.

                                                                        {
    std::ostringstream oss;
    oss << std::fixed << std::setprecision(2);
 
    oss << "[" << prefix_ << "] Metrics Summary:\n";
    oss << "  Tasks: submitted=" << snapshot.tasks_submitted
        << ", executed=" << snapshot.tasks_executed
        << ", failed=" << snapshot.tasks_failed << "\n";
 
    auto total = snapshot.total_busy_time_ns + snapshot.total_idle_time_ns;
    double utilization = (total > 0)
        ? 100.0 * static_cast<double>(snapshot.total_busy_time_ns) / static_cast<double>(total)
        : 0.0;
    oss << "  Time: busy=" << (snapshot.total_busy_time_ns / 1'000'000.0) << "ms"
        << ", idle=" << (snapshot.total_idle_time_ns / 1'000'000.0) << "ms"
        << " (utilization=" << utilization << "%)";
 
    return oss.str();
}

References kcenon::thread::metrics::MetricsBackend::prefix_, kcenon::thread::metrics::BaseSnapshot::tasks_executed, kcenon::thread::metrics::BaseSnapshot::tasks_failed, kcenon::thread::metrics::BaseSnapshot::tasks_submitted, kcenon::thread::metrics::BaseSnapshot::total_busy_time_ns, and kcenon::thread::metrics::BaseSnapshot::total_idle_time_ns.

◆ export_enhanced()

std::string kcenon::thread::metrics::LoggingBackend::export_enhanced ( const EnhancedSnapshot & snapshot ) const

nodiscardoverridevirtual

Export enhanced metrics snapshot.

Parameters

snapshot The enhanced metrics snapshot to export.

Returns: Formatted string representation.

Implements kcenon::thread::metrics::MetricsBackend.

Definition at line 286 of file metrics_backend.cpp.

                                                                                {
    std::ostringstream oss;
    oss << std::fixed << std::setprecision(2);
 
    oss << "[" << prefix_ << "] Enhanced Metrics:\n";
    oss << "  Tasks: submitted=" << snapshot.tasks_submitted
        << ", executed=" << snapshot.tasks_executed
        << ", failed=" << snapshot.tasks_failed << "\n";
 
    oss << "  Latency (P50/P90/P99):\n";
    oss << "    Enqueue: " << snapshot.enqueue_latency_p50_us << "/"
        << snapshot.enqueue_latency_p90_us << "/" << snapshot.enqueue_latency_p99_us << " us\n";
    oss << "    Execute: " << snapshot.execution_latency_p50_us << "/"
        << snapshot.execution_latency_p90_us << "/" << snapshot.execution_latency_p99_us << " us\n";
    oss << "    Wait:    " << snapshot.wait_time_p50_us << "/"
        << snapshot.wait_time_p90_us << "/" << snapshot.wait_time_p99_us << " us\n";
 
    oss << "  Throughput: " << snapshot.throughput_1s << " ops/sec (1s), "
        << snapshot.throughput_1m << " ops/sec (1m)\n";
 
    oss << "  Queue: depth=" << snapshot.current_queue_depth
        << ", peak=" << snapshot.peak_queue_depth
        << ", avg=" << snapshot.avg_queue_depth << "\n";
 
    oss << "  Workers: active=" << snapshot.active_workers
        << ", utilization=" << (snapshot.worker_utilization * 100.0) << "%";
 
    return oss.str();
}

◆ name()

std::string kcenon::thread::metrics::LoggingBackend::name ( ) const

inlinenodiscardoverridevirtual

Get the backend name.

Returns: Human-readable backend identifier (e.g., "prometheus", "json").

Implements kcenon::thread::metrics::MetricsBackend.

Definition at line 248 of file metrics_backend.h.

                                                  {
        return "logging";
    }

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

include/kcenon/thread/metrics/metrics_backend.h
src/metrics/metrics_backend.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LoggingBackend()

◆ ~LoggingBackend()

Member Function Documentation

◆ export_base()

◆ export_enhanced()

◆ name()