Skip to main content

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.

A session ties together the traces that belong to one conversation or user interaction, cutting across workflows and agents. Set a sessionId on your calls — typically a chat/thread id — and Foglamp groups every turn under it.
Only traces whose spans carry a sessionId appear here. If you don’t set one, the call is still recorded under Traces; it just won’t be grouped into a session.

​
Sessions list

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

​
Session detail

Opening a session shows stat cards (turns, tokens, cost, started) and a conversation timeline — one block per turn, in order. Each turn renders:
  • the user message (extracted from the turn’s input), with a disclosure to view the full raw input when it was truncated,
  • the assistant output for that turn,
  • a footer with the turn’s cost, tokens, and duration,
  • a link to the underlying trace, plus a workflow badge and error badge where relevant.
This makes a session read like the conversation it represents, while staying one click away from the full execution detail of any turn.