Skip to content

GitLab

GitLab Commit is coming up on August 3-4. Learn how to innovate together using GitLab, the DevOps platform. Register for free: gitlabcommitvirtual2021.com

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