Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Habilitar log de depuração

Se os logs do fluxo de trabalho não fornecerem detalhes suficientes para diagnosticar o motivo pelo qual um fluxo de trabalho, um trabalho ou uma etapa não está funcionando como esperado, habilite o log de depuração adicional.

GitHub Actions está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub One. GitHub Actions não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório. Para obter mais informações, consulte "produtos de GitHub

Neste artigo

Esses registros adicionais são habilitados pela definição dos segredos no repositório que contém o fluxo de trabalho. Portanto, aplicam-se os mesmos requisitos de permissão:

  • Para criar segredos para um repositório de conta de usuário, você deve ser o proprietário do repositório. Para criar segredos para o repositório de uma organização, você deve ter acesso admin.
  • Para criar segredos no nível da organização, você deve ter acesso admin.
  • Para criar segredos usando a API REST, você deve ter acesso de gravação ao repositório ou acesso de administrador à organização. Para obter mais informações, consulte "GitHub Actions secrets API."

Para obter mais informações sobre segredos de configuração, consulte "Criar e usar segredos criptografados".

Habilitar log de diagnóstico do runner

O log de diagnóstico do executor fornece arquivos de log adicionais que contêm informações sobre como um executor está executando um trabalho. Dois arquivos de log extras foram adicionados ao arquivo de log:

  • O log de processo do runner, que inclui informações sobre a coordenação e a configuração de runners para executar trabalhos.
  • O log de processo do worker, que registra em log a execução de um trabalho.
  1. Para habilitar o log de diagnóstico do runner, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: ACTIONS_RUNNER_DEBUG como true.

  2. Para baixar os logs de diagnóstico do runner, baixe o arquivo de log da execução de fluxo de trabalho. Os logs de diagnóstico do runner ficam na pasta runner-diagnostic-logs. Para obter mais informações sobre o download de logs, consulte "Fazer download de registros".

Habilitar log de depuração da etapa

O log de depuração da etapa aumenta o detalhamento dos logs de um trabalho durante e depois da execução dele.

  1. Para habilitar o log de diagnóstico da etapa, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: ACTIONS_STEP_DEBUG como true.

  2. Após a configuração da chave secreta, mais eventos de depuração são exibidos nos logs da etapa. Para obter mais informações, consulte "Exibir logs para diagnosticar falhas".

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.