Skip to content

GitLab

iterm2
iterm2
Last edited by George Nachman
Page history

DebugLogging

A debug log is very helpful in diagnosing many problems in iTerm2. Please include one in your issue report! The steps are:

  1. It is helpful to close any iTerm2 windows that aren't involved in the problem.
  2. Open the "iTerm2" menu
  3. Select "Toggle Debug Logging"
  4. Reproduce the issue.
  5. Select "Toggle debug logging" a second time. The logs will be saved to disk at this point.
  6. Attach /tmp/debuglog.txt to your issue.

Please avoid doing unnecessary operations while logging is on. The logs are big and it can be hard to analyze if there's a lot happening.

If you're having trouble finding the menu item, it looks like this:

image