{
  "schema_version": 2,
  "id": "develop/ai/context-engine/lens/inspect-sessions",
  "title": "Inspect sessions",
  "url": "https://redis.io/docs/latest/develop/ai/context-engine/lens/inspect-sessions/",
  "summary": "Find a session in the Lens UI and read each turn's steps, timing, and captured content.",
  "tags": [
    "docs",
    "develop",
    "ai"
  ],
  "last_updated": "2026-11-03T10:10:44-05:00",
  "page_type": "content",
  "content_hash": "63a13b88fbdede904bc6465f3b3cd86de4b4d0cf74807c5c36941ac4bec46eb3",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Use the Lens user interface (UI) to find a session, open a turn, and see what happened at each step."
    },
    {
      "id": "connect-to-lens",
      "title": "Connect to Lens",
      "role": "content",
      "text": "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](https://redis.io/docs/latest/operate/iris/lens/self-managed/operations#connect-the-console)."
    },
    {
      "id": "find-a-session",
      "title": "Find a session",
      "role": "content",
      "text": "1. Select an agent. Lens lists that agent's sessions, newest activity first.\n1. Choose a time range. Lens offers the ranges your instance retains.\n1. To narrow the loaded sessions, search by any part of a session ID or user ID.\n\nEach 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)](https://redis.io/docs/latest/develop/ai/context-engine/lens/read-api#list-sessions)."
    },
    {
      "id": "read-a-turns-steps",
      "title": "Read a turn's steps",
      "role": "content",
      "text": "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:\n\n- Each step shows its name and how long it took. Steps that ran at the same time appear together.\n- Recall steps list each result with its score, where the source provides one, and mark it **Entered prompt** or **Not used**.\n- Iris service steps show the service and the operation, such as an Agent Playbooks discovery or a Context Gateway tool call.\n\nSelect a recall, tool, or Iris service step to open its details, including the request and result Lens captured for it."
    },
    {
      "id": "view-captured-content",
      "title": "View captured content",
      "role": "content",
      "text": "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:\n\n| Label | Meaning |\n| ----- | ------- |\n| Content expired | The text is older than the content retention window. |\n| Content not captured | Content capture was off when the turn ran. |\n| Content could not be fetched | Lens couldn't load the text. Try again later. |\n\nSee [content capture](https://redis.io/docs/latest/develop/ai/context-engine/lens/concepts#content-capture) and [retention](https://redis.io/docs/latest/develop/ai/context-engine/lens/concepts#retention)."
    }
  ],
  "examples": []
}