Skip to main content

Logs do GitHub Codespaces

Visão geral dos logs usados pelo GitHub Codespaces.

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

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 o VS Code Command Palette [Shift+Command+P (Mac)/Ctrl+Shift+P (Windows/Linux)] e digite export logs. 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 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 o VS Code Command Palette [Shift+Command+P (Mac)/Ctrl+Shift+P (Windows/Linux)] e digite creation log. 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.

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.

As instruções a seguir são para o Chrome. As etapas para outros navegadores são semelhantes.

  1. Na janela do navegador para o ambiente de codespace que você deseja depurar, abra a janela de ferramentas do desenvolvedor.

  2. Clique na guia Console.

  3. Mostre a barra lateral do console, se ela ainda não estiver visível. Para saber mais, confira Referência de recursos do console na documentação do Chrome para desenvolvedores.

  4. Na barra lateral, clique em NUMBER erros para mostrar apenas os erros.

  5. 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.

    Captura de tela do painel de ferramentas para desenvolvedores no navegador Chrome. O menu de clique com o botão direito do mouse é exibido, mostrando a opção "Salvar como".

Leitura adicional