Skip to main content

Session Profiler

The SessionProfiler attaches to the Agentium EventBus and monitors real agent sessions in real-time. It classifies sessions by token volume and estimates the KV cache pressure your workload generates.

Quick Start

Session Categories

Sessions are classified by cumulative token count:

Events

The profiler emits two events on the EventBus:

capacity.session.classified

Fired when a session crosses a category threshold.

capacity.warning

Fired when estimated KV cache exceeds kvWarningThresholdGb.

Feeding into Capacity Planning

The profiler’s output plugs directly into Tier 1 functions:

Prometheus Integration

When paired with MetricsExporter from @agentium/observability, session categories are automatically exported as Prometheus counters: