Real-time latency tracking, atomic metrics, and circular in-memory flight recording. More...

Files
file	FlightRecorder.hpp
	Circular in-memory telemetry buffer with Chrome Tracing JSON export.

file	Metrics.hpp
	Zero-heap Prometheus-compatible metric counters, gauges, and histograms.

file	profiler.hpp
	Umbrella header for real-time latency telemetry and flight recorder.

file	ProfilerPolicies.hpp
	Latency tracking and flight recording policies with runtime toggle.

Classes
class	corium::profiler::Counter
	Atomic 64-bit monotonically increasing counter. More...

class	corium::profiler::FlightRecorder< Capacity >
	Zero-heap circular flight recorder storing the last N event telemetry records. Thread-safe for multiple producers and concurrent reader/dumping. More...

class	corium::profiler::Gauge
	Atomic 64-bit signed gauge metric representing instantaneous level. More...

class	corium::profiler::Histogram< NumBuckets >
	Statically bucketed latency distribution histogram. More...

class	corium::profiler::LatencyTracker< QueueCapacity >
	Real-time event latency and performance statistics tracker. Zero dynamic memory allocation. Tracks min, max, total queue latency and handler duration. More...

Functions
size_t	corium::profiler::formatPrometheusCounter (const Counter &c, std::span< char > buf) noexcept
	Format counter in Prometheus exposition text format into a char buffer.

size_t	corium::profiler::formatPrometheusGauge (const Gauge &g, std::span< char > buf) noexcept
	Format gauge in Prometheus exposition text format into a char buffer.

Detailed Description

Real-time latency tracking, atomic metrics, and circular in-memory flight recording.

Key components:

corium::profiler::FlightRecorder: Circular telemetry buffer capturing timestamps with zero heap allocation.
corium::profiler::LatencyTracker: Real-time per-event latency statistics (min, max, average) with runtime enable/disable.
corium::profiler::FlightRecorderProfiler: Combined flight recorder and latency tracking policy.
corium::profiler::Counter: Zero-heap 64-bit atomic monotonically increasing event counter.
corium::profiler::Gauge: Zero-heap 64-bit atomic instantaneous value metric.
corium::profiler::Histogram: Zero-heap static bucketing latency distribution tracker.
corium::profiler::formatPrometheusCounter / corium::profiler::formatPrometheusGauge: Prometheus exposition text exporter.
corium::profiler::exportChromeTracingJson(): Google Chrome Tracing and Perfetto JSON visualizer exporter.

Function Documentation

size_t corium::profiler::formatPrometheusCounter	(	const Counter &	c,
		std::span< char >	buf
	)

inlinenoexcept

Format counter in Prometheus exposition text format into a char buffer.

size_t corium::profiler::formatPrometheusGauge	(	const Gauge &	g,
		std::span< char >	buf
	)

inlinenoexcept

Format gauge in Prometheus exposition text format into a char buffer.