tokentrace Documentation

Getting Started

• Overview What tokentrace traces and why it matters.
• Quick Start Instrument your first inference call in five minutes.
• Installation Install the Go package.

Core Concepts

• Traces & Spans The trace model: spans, attributes, and hierarchy.
• Metrics Cost, latency, quality, and custom metrics.
• Transports Write traces to files, HTTP endpoints, or stdout.
• Alerts Alert rules for quality, cost, and latency regressions.

Reference

• Metrics Reference Every built-in metric: type, unit, and description.
• HTTP API Ingest traces and query metrics over HTTP.
• Configuration tokentrace.yml schema and defaults.
• Go API Instrument Go code directly.

Guides

• Instrumenting an Agent Loop Add step-level tracing to a multi-step agent.
• Grafana Integration Export metrics to Prometheus and build Grafana dashboards.