Inspect sessions

Find a session in the Lens UI and read each turn's steps, timing, and captured content.

Use the Lens user interface (UI) to find a session, open a turn, and see what happened at each step.

Connect to Lens

Open Lens. On Redis Cloud, select Lens under Iris in the console menu; Lens uses your console sign-in. Self-managed, Lens asks for a credential: paste your read key and select Connect. Your administrator connects Lens to the console.

Find a session

1. Select an agent. Lens lists that agent's sessions, newest activity first.
2. Choose a time range. Lens offers the ranges your instance retains.
3. To narrow the loaded sessions, search by any part of a session ID or user ID.

Each session shows its number of turns, its user IDs, and the outcomes of its turns. To search a whole time range by session ID prefix, user ID, or outcome, use the read application programming interface (API).

Read a turn's steps

Select a session to see its turns, then expand a turn. Lens shows the turn's steps as a timeline, in the order they ran:

• Each step shows its name and how long it took. Steps that ran at the same time appear together.
• Recall steps list each result with its score, where the source provides one, and mark it Entered prompt or Not used.
• Iris service steps show the service and the operation, such as an Agent Playbooks discovery or a Context Gateway tool call.

Select a recall, tool, or Iris service step to open its details, including the request and result Lens captured for it.

View captured content

Step details show the text Lens captured, such as the recall query, each result, and tool input and output. When text isn't available, the step says why:

See content capture and retention.