Skip to main content

Logs do GitHub Codespaces

Visão geral dos logs usados pelo GitHub Codespaces.

Observação: o uso dos GitHub Codespaces com IDEs do JetBrains está em versão beta pública e sujeito a alterações no momento.

A saída das informações sobre o GitHub Codespaces é gerada em vários logs diferentes:

  • Registros do codespace
  • Registros de criação
  • Logs do console do navegador (para o cliente Web do VS Code)

Os logs de extensão estarão disponíveis se você estiver usando o GitHub Codespaces no VS Code. Clique na guia "Visual Studio Code" acima para obter detalhes.

  • Registros do codespace
  • Registros de criação
  • Logs de extensão (para o aplicativo da área de trabalho do VS Code)

Os logs do navegador estarão disponíveis se você estiver usando o GitHub Codespaces no navegador. Clique na guia "Navegador da Web" acima para obter detalhes.

  • Registros do codespace
  • Registros de criação

Outros logs estarão disponíveis se você estiver usando o GitHub Codespaces no VS Code ou no navegador da Web. Clique nas guias acima para obter detalhes.

  • Registros de criação

Outros logs estarão disponíveis se você estiver usando o GitHub Codespaces no VS Code ou no navegador da Web. Clique nas guias acima para obter detalhes.

Registros do codespace

Esses logs contêm informações detalhadas sobre o codespace, o contêiner, a sessão e o ambiente do VS Code. Eles são úteis para diagnosticar problemas de conexão e outros comportamentos inesperados. Por exemplo, o codespace congela, mas a opção "Recarregar Windows" o descongela por alguns minutos ou você será desconectado do codespace aleatoriamente, mas poderá reconectar-se imediatamente.

  1. Se você estiver usando o GitHub Codespaces no navegador, certifique-se de estar conectado ao codespace que será depurado.
  2. Abra a VS Code Command Palette (Shift+Command+P [no Mac] / Ctrl+Shift+P [no Windows/Linux]) e digite logs de exportação. Selecione Codespaces: Exportar logs na lista para baixar os logs.
  3. Defina o local em que o arquivo zip dos logs será salvo e clique em Salvar (área de trabalho) ou em OK (Web).
  4. Se você estiver usando o GitHub Codespaces no navegador, clique com o botão direito do mouse no arquivo ZIP dos logs na exibição do Explorer e selecione Baixar… para baixá-los no computador local.

Registros do codespace

Esses logs contêm informações detalhadas sobre o codespace, o contêiner, a sessão e o ambiente do VS Code. Eles são úteis para diagnosticar problemas de conexão e outros comportamentos inesperados. Por exemplo, o codespace congela, mas a opção "Recarregar Windows" o descongela por alguns minutos ou você será desconectado do codespace aleatoriamente, mas poderá reconectar-se imediatamente.

  1. Abra a VS Code Command Palette (Shift+Command+P [no Mac] / Ctrl+Shift+P [no Windows/Linux]) e digite logs de exportação. Selecione Codespaces: Exportar logs na lista para baixar os logs.
  2. Defina o local em que o arquivo zip dos logs será salvo e clique em Salvar (área de trabalho) ou em OK (Web).

Registros do codespace

Esses logs contêm informações detalhadas sobre o codespace, o contêiner, a sessão e o ambiente do VS Code. Eles são úteis para diagnosticar problemas de conexão e outros comportamentos inesperados. Por exemplo, o codespace congela, mas a opção "Recarregar Windows" o descongela por alguns minutos ou você será desconectado do codespace aleatoriamente, mas poderá reconectar-se imediatamente.

Atualmente você não pode usar GitHub CLI para acessar esses registros. Para acessá-los, abra o codespace no VS Code ou em um navegador.

Registros de criação

Estes registros contêm informações sobre o contêiner, contêiner de desenvolvimento e sua configuração. Eles são úteis para depuração de configurações e problemas de instalação.

  1. Conecte-se ao codespace que você deseja depurar.
  2. Abra a VS Code Command Palette (Shift+Command+P [no Mac] / Ctrl+Shift+P [no Windows/Linux]) e digite Logs de Criação. Selecione Codespaces: Exibir o Log de Criação na lista para abrir o arquivo creation.log.

Se você quiser compartilhar o registro com suporte, você poderá copiar o texto do registro de criação em um editor de texto e salvar o arquivo localmente.

Abra a VS Code Command Palette (Shift+Command+P [no Mac] / Ctrl+Shift+P [no Windows/Linux]) e digite Logs de Criação. Selecione Codespaces: Exibir o Log de Criação na lista para abrir o arquivo creation.log.

Se você quiser compartilhar o registro com suporte, você poderá copiar o texto do registro de criação em um editor de texto e salvar o arquivo localmente.

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Para ver o log de criação, use o subcomando gh codespace logs. Depois de entrar no comando, escolha entre a lista de codespaces exibidos.

gh codespace logs

Para obter mais informações sobre esse comando, confira o manual da GitHub CLI.

Se você quiser compartilhar o registro com suporte, você poderá salvar a saída em um arquivo:

gh codespace logs -c  > /path/to/logs.txt

Registros de extensão

Estes logs estão disponíveis apenas para os usuários de área de trabalho do VS Code desktop users only. Eles são úteis quando há a possibilidade de problemas na extensão do GitHub Codespaces ou no editor do VS Code que possam impedir a criação ou a conexão.

  1. No VS Code, abra a paleta de comandos.
  2. Digite Logs e selecione Desenvolvedor: Abrir Pasta de Logs de Extensão na lista para abrir a pasta de log de extensão no explorador de arquivos do sistema.

Nesta exibição, é possível acessar os registros gerados pelas várias extensões usadas no VS Code. Você verá os logs do GitHub Codespaces, do GitHub Authentication e do Git, além de logs de outras extensões habilitadas.

Registros do console do navegador

Esses logs são úteis apenas para depurar problemas com o uso do GitHub Codespaces em navegadores. Eles são úteis para depurar problemas de criação e conexão com o GitHub Codespaces.

  1. Na janela do navegador para o ambiente de codespace que você deseja depurar, abra a janela de ferramentas do desenvolvedor.
  2. Veja a guia "Console" e clique em Erros na barra lateral esquerda para mostrar apenas os erros.
  3. Na área de log à direita, clique com o botão direito do mouse e selecione Salvar como para salvar uma cópia dos erros no computador local. Salvar erros
  1. No cliente JetBrains, clique no plug-in de GitHub Codespaces para exibir a janela de ferramentas de GitHub Codespaces.

    Captura de tela da janela de ferramentas do GitHub Codespaces

  2. Na janela de ferramentas do GitHub Codespaces, clique no ícone de log.

    Captura de tela do botão de log

Logs do JetBrains

É possível baixar logs para o IDE remoto do JetBrains e para o aplicativo cliente local acessando o menu Ajuda no aplicativo cliente JetBrains e clicando em Coletar logs do host e do cliente.

Leitura adicional