GitHub Codespaces 日志

GitHub Codespaces 使用的日志概述。

Tool navigation

在本文中

有关 GitHub Codespaces 的信息将输出到各种日志：

  • 代码空间日志
  • 创建日志
  • 浏览器控制台日志（用于 VS Code Web 客户端）

如果要在 VS Code 中使用 GitHub Codespaces，则可以使用扩展日志。 单击上面的“Visual Studio Code”选项卡，了解详细信息。

  • 代码空间日志
  • 创建日志
  • 扩展日志（用于 VS Code 桌面应用程序）

如果要在浏览器中使用 GitHub Codespaces，则可以使用浏览器日志。 单击上面的“Web 浏览器”选项卡，了解详细信息。

  • 代码空间日志
  • 创建日志

如果要在 VS Code 或 Web 浏览器中使用 GitHub Codespaces，则可以使用其他日志。 单击上面的选项卡以了解详细信息。

代码空间日志

这些日志包含有关 codespace、容器、会话和 VS Code 环境的详细信息。 它们对于诊断连接问题和其他意外行为非常有用。 例如，代码空间冻结，但“Reload Windows（重新加载 Windows）”选项可将其解冻几分钟，或者您随机断开与代码空间的连接，但能够立即重新连接。

  1. 如果要在浏览器中使用 GitHub Codespaces，请确保已连接到要调试的 codespace。
  2. 打开 VS Code Command Palette （Shift+Command+P （Mac）/ Ctrl+Shift+P （Windows/Linux））然后输入export logs。 从列表中选择“Codespaces: 导出日志”以下载日志。
  3. 定义保存日志 zip 存档的位置，然后单击“保存”（桌面），或单击“确定”(Web) 。
  4. 如果要在浏览器中使用 GitHub Codespaces，请右键单击“资源管理器”视图中日志的 zip 存档，然后选择“下载…” 将其下载到本地计算机。

代码空间日志

这些日志包含有关 codespace、容器、会话和 VS Code 环境的详细信息。 它们对于诊断连接问题和其他意外行为非常有用。 例如，代码空间冻结，但“Reload Windows（重新加载 Windows）”选项可将其解冻几分钟，或者您随机断开与代码空间的连接，但能够立即重新连接。

  1. 打开 VS Code Command Palette （Shift+Command+P （Mac）/ Ctrl+Shift+P （Windows/Linux））然后输入export log。 从列表中选择“Codespaces: 导出日志”以下载日志。
  2. 定义保存日志 zip 存档的位置，然后单击“保存”（桌面），或单击“确定”(Web) 。

代码空间日志

这些日志包含有关 codespace、容器、会话和 VS Code 环境的详细信息。 它们对于诊断连接问题和其他意外行为非常有用。 例如，代码空间冻结，但“Reload Windows（重新加载 Windows）”选项可将其解冻几分钟，或者您随机断开与代码空间的连接，但能够立即重新连接。

目前，您无法使用 GitHub CLI 来访问这些日志。 要访问它们，请在 VS Code 或在一个浏览器中打开代码空间。

创建日志

这些日志包含有关容器、开发容器及其配置的信息。 它们对于调试配置和设置问题非常有用。

  1. 连接到要调试的代码空间。
  2. 打开 VS Code Command Palette （Shift+Command+P （Mac）/ Ctrl+Shift+P （Windows/Linux））然后输入creation log。 从列表中选择“Codespaces: 查看创建日志”以打开 creation.log 文件。

如果要与支持人员共享日志，可以将创建日志中的文本复制到文本编辑器中，并将文件保存在本地。

打开 VS Code Command Palette （Shift+Command+P （Mac）/ Ctrl+Shift+P （Windows/Linux））然后输入creation log。 从列表中选择Codespaces: 查看创建日志以打开creation.log文件。

如果要与支持人员共享日志，可以将创建日志中的文本复制到文本编辑器中，并将文件保存在本地。

注意

若要详细了解 GitHub CLI，请参阅“关于 GitHub CLI”。

若要查看创建日志，请使用 gh codespace logs 子命令。 输入命令后，从显示的代码空间列表中进行选择。

gh codespace logs

有关此命令的详细信息，请参阅 GitHub CLI 手册。

如果要与支持人员共享日志，可以将输出保存到一个文件中：

gh codespace logs -c <CODESPACE-NAME> > /path/to/logs.txt

扩展日志

这些日志仅适用于 VS Code 桌面用户。 当 GitHub Codespaces 扩展或 VS Code 编辑器似乎遇到问题而无法创建或连接时，它们非常有用。

  1. 在 VS Code 中，打开命令面板。
  2. 键入 logs，然后选择开发人员: 打开扩展日志文件夹。
  3. 此时将显示系统的文件资源管理器，其中显示各种日志文件和文件夹。 打开 output_logging_DATETIME 文件夹。

在此视图中，可以访问由在 VS Code 中使用的扩展生成的日志，包括 GitHub Codespaces。

浏览器控制台日志

仅当想要调试在浏览器中使用 GitHub Codespaces 的问题时，这些日志才有用。 对于调试创建和连接到 GitHub Codespaces 的问题，它们非常有用。

以下说明适用于 Chrome。 其他浏览器的执行步骤类似。

  1. 在要调试的代码空间的浏览器窗口中，打开开发人员工具窗口。

  2. 单击“控制台”**** 选项卡。

  3. 显示控制台边栏（如果尚未显示）。 有关详细信息，请参阅 Chrome 开发者文档中的控制台功能参考。

  4. 在边栏中，单击错误数量以仅显示错误。

  5. 在右侧的日志区域中，右键单击并选择“另存为”将错误的副本保存到本地计算机。

    Chrome 浏览器中开发人员工具面板的屏幕截图。 将显示右键单击菜单，其中显示“另存为”选项。

其他阅读材料

  •         [AUTOTITLE](/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)

  •         [AUTOTITLE](/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)