For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
PlaygroundDiscordStatusDashboardSign Up >
DocumentationSDK ReferenceGraphiti
DocumentationSDK ReferenceGraphiti
  • Getting Started
    • Coding with LLMs
    • Key Concepts
    • Quickstart
    • Building an Agent Walkthrough
    • Memory
    • Projects
    • Users
    • Sessions
    • Groups
  • Working with the Graph
    • Understanding the Graph
    • Utilizing Facts and Summaries
    • Customizing Graph Structure
    • Adding Data to the Graph
    • Reading Data from the Graph
    • Searching the Graph
    • Deleting Data from the Graph
    • Debugging
  • Cookbook
    • Check Data Ingestion Status
    • Customize Your Memory Context String
    • Add User Specific Business Data to User Graphs
    • Share Memory Across Users Using Group Graphs
    • Get Most Relevant Facts for an Arbitrary Query
    • Find Facts Relevant to a Specific Node
  • Best Practices
    • Performance Best Practices
    • Adding JSON Best Practices
  • Ecosystem
    • LangGraph
    • Autogen
  • Migrations
    • February 2026 Deprecation Wave
    • Migrate from Mem0
  • FAQ
    • Frequently Asked Questions
  • Legal
    • Privacy Policy
    • Terms of Service
    • Website Terms of Use
LogoLogo
PlaygroundDiscordStatusDashboardSign Up >
On this page
  • Enabling Debug Logging
  • Accessing Debug Logs
  • Viewing Debug Logs
  • Best Practices for Debug Logging
Working with the Graph

Debugging

Debug workflow execution logs for graph operations
Was this page helpful?
Previous

Check Data Ingestion Status

Next
Built with

Zep provides detailed debugging capabilities to help you troubleshoot and optimize your graph operations. Debug logging captures detailed workflow execution logs that can be invaluable for understanding how your data flows through the system.

Enabling Debug Logging

Debug logging is enabled from the Project Settings page in your Zep dashboard. Once enabled, debug logging will be active for 60 minutes.

Important: Debug logging will be active for the next 60 minutes. During this time, all workflow executions will have detailed logs captured. You can view these logs in the session logs dialog for any session that runs during this period.

Accessing Debug Logs

Debug logs are available from episode lists for both individual users and graph-wide operations.

Viewing Debug Logs

To view debug logs for a specific episode:

  1. Navigate to the episode list (either from a user or graph view)
  2. Find the episode you want to debug
  3. Click on the Actions menu for that episode
  4. Select Debug Logs

This will open a detailed view of the workflow execution logs for that specific episode, showing you:

  • Step-by-step execution flow
  • Processing timestamps
  • Error messages and stack traces
  • Performance metrics
  • Data transformation details

Best Practices for Debug Logging

  • Enable selectively: Only enable debug logging when actively troubleshooting to avoid unnecessary overhead
  • Time-limited sessions: Debug logging automatically disables after 60 minutes to prevent performance impact
  • Review promptly: Review debug logs within 24 hours. Stale debug logs are removed after 24 hours.