Overview of the logs used by GitHub Codespaces.
Notes:
Information on GitHub Codespaces is output to various logs:
Extension logs are available if you are using GitHub Codespaces in VS Code. Click the "Visual Studio Code" tab above for details.
Browser logs are available if you are using GitHub Codespaces in your browser. Click the "Web browser" tab above for details.
Other logs are available if you are using GitHub Codespaces in VS Code or in your web browser. Click the tabs above for details.
These logs contain detailed information about the codespace, the container, the session, and the VS Code environment. They are useful for diagnosing connection issues and other unexpected behavior. For example, the codespace freezes but the "Reload Windows" option unfreezes it for a few minutes, or you are randomly disconnected from the codespace but able to reconnect immediately.
export logs
export log
Currently you can't use GitHub CLI to access these logs. To access them, open your codespace in VS Code or in a browser.
These logs contain information about the container, dev container, and their configuration. They are useful for debugging configuration and setup problems.
creation log
creation.log
If you want to share the log with support, you can copy the text from the creation log into a text editor and save the file locally.
Open the VS Code Command Palette ( Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux)) and type creation log . Select Codespaces: View Creation Log from the list to open the creation.log file.
To learn more about GitHub CLI, see " About GitHub CLI ."
To see the creation log use the gh codespace logs subcommand. After entering the command choose from the list of codespaces that's displayed.
gh codespace logs
For more information about this command, see the GitHub CLI manual .
If you want to share the log with support, you can save the output to a file:
gh codespace logs -c <CODESPACE-NAME> > /path/to/logs.txt
These logs are available for VS Code desktop users only. They are useful if it seems like the GitHub Codespaces extension or VS Code editor are having issues that prevent creation or connection.
logs
output_logging_DATETIME
From this view, you can access logs generated by extensions you use in VS Code, including GitHub Codespaces.
These logs are useful only if you want to debug problems with using GitHub Codespaces in the browser. They are useful for debugging problems creating and connecting to GitHub Codespaces.
The following instructions are for Chrome. The steps for other browsers are similar.
In the browser window for the codespace you want to debug, open the developer tools window.
Click the Console tab.
Show the console sidebar, if it is not already displayed. For more information, see " Console features reference " in the Chrome for Developers documentation.
In the sidebar, click NUMBER errors to show only the errors.
In the log area on the right, right-click and select Save as to save a copy of the errors to your local machine.
In the JetBrains client, click the GitHub Codespaces plugin to display the GitHub Codespaces tool window.
In the GitHub Codespaces tool window, click the log icon.
You can download logs for the remote JetBrains IDE and the local client application by going to the Help menu in the JetBrains client application and clicking Collect Host and Client Logs .