Skip to main content

Habilitando o 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.

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 pessoal, você deve ser o proprietário do repositório. Para criar segredos para um repositório da organização, você precisa ter acesso de admin.
  • Para criar segredos para um ambiente em um repositório de conta pessoal, você deve ser o proprietário do repositório. Para criar segredos para um ambiente em um repositório da organização, é necessário ter acesso de admin.
  • Para criar segredos no nível da organização, você precisa ter acesso de 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, confira "API de segredos do GitHub Actions".

Para obter mais informações sobre como definir segredos, confira "Como 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ósticos do executor, defina o seguinte segredo 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 executor estão contidos na pasta runner-diagnostic-logs. Para obter mais informações sobre como baixar os logs, confira "Como baixar os logs".

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 depuração de etapas, defina o seguinte segredo 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, confira "Como ver os logs para diagnosticar falhas".