Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
    • Switch to GitLab Next
  • Sign in / Register
iterm2
iterm2
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 2,246
    • Issues 2,246
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
    • Iterations
  • Requirements
    • Requirements
    • List
  • Security & Compliance
    • Security & Compliance
    • Dependency List
    • License Compliance
  • Operations
    • Operations
    • Incidents
  • Analytics
    • Analytics
    • Insights
    • Issue
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
  • George Nachman
  • iterm2iterm2
  • Wiki
  • DebugLogging

Last edited by George Nachman Jan 09, 2021
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

Clone repository
  • Applescript
  • Architecture
  • Base64FileDownload
  • Credits
  • Date Formatting in the Clock Status Bar Component
  • DebugLogging
  • Debugging Session Restoration
  • Diagnosing Use after free Bugs
  • Fulldiskaccess
  • HowToBuild
  • HowToSample
  • Metal Renderer
  • New App Icons
  • Paste Bracketing
  • Prefer Tabs When Opening Documents
View All Pages