> ## Documentation Index
> Fetch the complete documentation index at: https://docs.foglamp.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions

> Follow one conversation or user thread end to end.

A **session** groups the traces that belong to one conversation or user
interaction, across workflows and agents. Set a `sessionId` on your calls,
typically a chat or thread id, and Foglamp groups every turn under it.

<Note>
  Only traces with a `sessionId` appear here. If you don't set one, the call is
  still recorded under [Traces](/dashboard/traces); it just isn't grouped into
  a session.
</Note>

## Sessions list

A paginated table over the selected range: session id, the agent involved, turn
count, tokens, cost, and last activity. Sessions with errors carry a badge.

## Session detail

Opening a session shows stat cards (turns, tokens, duration, cost) and a
conversation timeline, one block per turn, in order. Each turn shows:

* the user message, with a control to view the full raw input if it was cut
  off,
* the assistant's output for that turn,
* the turn's cost, tokens, and duration,
* a link to the underlying [trace](/dashboard/traces), plus workflow and error
  badges where relevant.

A session reads like the conversation it represents, and the full execution
detail of any turn is one click away.