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 → Extensions → Telemetry (on by default). The TUI shows the card regardless: it does not read this setting yet (doc/core-dev/improvements/plugin-settings.md).

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.