Skip to main content
Observability is one of the layers TrueFoundry adds on top of the open-source TrueForge harness (see What TrueFoundry Adds for the rest, including governance). Every agent session runs through the AI Gateway, so each turn, tool call, and model call is captured with cost, tokens, and latency — no extra instrumentation in your agent code. This gives you a single place to answer three questions: who is using an agent, how much each run costs, and where a run went wrong.

Agent Sessions

Open Agents > Sessions in the sidebar to see every session across all your agents. Each row is one conversation, with the agent it ran against, who created it, and the cost, turns, and duration for the whole session.
Agent Sessions table showing sessions across agents with columns for message, agent, created by, cost, turns, and duration, filtered by agent and last 30 days

Agent Sessions lists every conversation across all agents, with the agent, creator, cost, turns, and duration per session

From this view you can:
  • Filter by agent — narrow to a single agent to see how it is being used.
  • Filter by time range — scope to the last 24 hours, 7 days, 30 days, or a custom window.
  • See who is using each agent — every session shows the user or virtual account that created it.
  • Gauge cost and complexity — turn count and dollar cost are visible per session without opening anything.
You can also open the sessions scoped to a single agent from the Agent Sessions tab on that agent’s detail page.

Session detail

Click any session to open its detail view. The header summarizes the whole session, and the transcript below shows every turn in order.
Agent session detail with summary metrics for turns, duration, cost, tokens, context, tool calls, sub-agents, and errors, an event-type timeline, and the turn-by-turn conversation

Session detail showing per-session metrics, the event-type timeline, and the full turn-by-turn transcript

The summary metrics cover the whole session: The event-type timeline breaks the session down by what the harness was doing at each moment — System, User, Model, and Waiting on human — so you can see at a glance where time went, including any pauses for tool approval or user questions. Each turn in the transcript shows its own tokens, duration, and cost. From a turn you can open the corresponding span in AI Monitoring to debug the underlying tool calls, reasoning steps, and latency.

One pane of glass across the stack

Because Agent Harness runs in the same gateway plane as model and MCP traffic, agent sessions are not a separate silo — they inherit the full AI Gateway observability surface:

Analytics

Model, MCP, and agent traffic in one analytics view, filterable by user, team, and agent.

Request logging

Full request and response logs for every model and tool call, subject to your redaction policy.

Export to OpenTelemetry

Stream traces and metrics to your own observability backend.

Prometheus and Grafana

Scrape gateway metrics and build dashboards and alerts.
For programmatic access to aggregated agent metrics, see Fetch Agent Metrics.