Skip to main content

​
Overview

Retrieval logs show which context was accessed by which client. Use them to:
  • Understand what context an agent retrieved
  • Trace outputs back to specific files
  • Verify that clients use the expected context
  • Audit access to your context repository
Logs are available per client and per file.

​
Per API key

To inspect retrieval activity for a specific client: Open Clients → API Keys, select an API key, and go to Retrieval logs. Public API file-content reads, hybrid and regex searches, and file and folder listings are recorded here under the API key that made the request. Returned files are linked to their retrieval history, including when a hybrid-search response omits source citations. Retrieval logs for a Codex MCP API key, with a successful cat request and its retrieved file Typical use cases include:
  • Debugging an agent
  • Verifying client configuration
  • Understanding retrieval patterns
  • Investigating unexpected outputs

​
Per MCP client

To inspect retrieval activity for an MCP client: Open Clients → MCP Clients, select an MCP client, and go to Retrieval logs.

​
Per file

To inspect retrieval activity for a specific file: Open a file in the Context tab and open the Retrieval logs dropdown in the editor top bar. Close-up of the Retrieval logs dropdown, showing MCP clients, operations, and access dates Typical use cases include:
  • Understanding how often a file is used
  • Seeing which context agents accessed
  • Investigating why a file influenced a response