Telemetry Plugin

Tracks how long each response takes — total time, time in the model, and time in tools — and shows it after the turn. Also writes those numbers to logs and to the console session report.

Enabled in the shipped default config.

Configuration

plugins:
  - module: codumentor.plugins.telemetry
    class: TelemetryPlugin

No plugin args.

Usage

After each assistant turn, a compact card appears in the transcript (web UI and TUI), for example 2.5s total · LLM 74% · 8 tools 17%. Expand it for this turn’s totals, a per-tool breakdown, and (after the first turn) conversation-wide totals. Subagent turns get their own cards, labeled as such.

Hide the web cards with Show Performance Metrics in Settings (off). Cards show until you turn that setting off.

At INFO log level the same breakdown is written after each response, including a main= / subagents= split when subagents ran tools. See Logging.

With session_report: true, a Timing Metrics section (turns, wall / LLM / tool time, per-tool list) is added to the end-of-session report. That report is printed by Console Report.

Evaluation runs also get a Telemetry Metrics section when this plugin is loaded.

Notes

• Tool time is the time the tools were actually running. Waiting for you to approve a tool is counted separately and is not included.
• When several tools run at once, overlapping work is not added together, so tool time stays within total time.
• There is no web UI for this plugin beyond the transcript cards and the settings toggle.