# 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:

<div class="ghd-tool webui">

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

</div>

<div class="ghd-tool vscode">

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

</div>

<div class="ghd-tool cli">

* 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 web. Clique nas guias acima para obter detalhes.

</div>

<div class="ghd-tool webui">

## 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 deseja depurar.
2. Abra o VS Code Command Palette (<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac) /<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (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.

</div>

<div class="ghd-tool vscode">

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

</div>

<div class="ghd-tool cli">

## 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 seu codespace no VS Code ou em um navegador.

</div>

## 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 a depuração de problemas de configuração e de instalação.

<div class="ghd-tool webui">

1. Conecte-se ao ambiente de código que você deseja depurar.
2. Abra o VS Code Command Palette (<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac) /<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (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.

</div>

<div class="ghd-tool vscode">

Abra o VS Code Command Palette (<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac) /<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (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.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-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.

```shell
gh codespace logs
```

Para obter mais informações sobre esse comando, confira [o manual da GitHub CLI](https://cli.github.com/manual/gh_codespace_logs).

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

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

</div>

<div class="ghd-tool vscode">

## Registros de extensão

Estes logs estão disponíveis apenas para os usuários de desktop do VS Code. 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.
3. O explorador de arquivos do sistema é exibido mostrando vários arquivos de log e pastas. Abra a pasta `output_logging_DATETIME`.

Nesta exibição, é possível acessar os logs gerados pelas extensões usadas no VS Code, incluindo GitHub Codespaces.

</div>

<div class="ghd-tool webui">

## 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 do 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](https://developer.chrome.com/docs/devtools/console/reference#sidebar) 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".](/assets/images/help/codespaces/browser-console-log-save.png)

</div>

## Leitura adicional

* [Revisar os logs de auditoria da sua organização no GitHub Codespaces](/pt/codespaces/managing-codespaces-for-your-organization/reviewing-your-organizations-audit-logs-for-github-codespaces)
* [Revisando seus logs de segurança para GitHub Codespaces](/pt/codespaces/managing-your-codespaces/reviewing-your-security-logs-for-github-codespaces)