Skip to main content
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 atualizadas, acesse a documentação em inglês.

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.

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

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

Para obter mais informações sobre como definir segredos, confira "Segredos criptografados".

Além disso, qualquer pessoa que tenha acesso para executar um fluxo de trabalho pode habilitar o log de diagnóstico do executor e o log de depuração de etapas para uma nova execução do fluxo de trabalho. Para mais informações, confira "Como reexecutar fluxos de trabalho e trabalhos".

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 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 da etapa, defina o seguinte segredo no repositório que contém o fluxo de trabalho: ACTIONS_STEP_DEBUG como true
  2. Depois de definir o segredo, mais eventos de depuração serão mostrados nos logs da etapa. Para obter mais informações, confira "Como ver os logs para diagnosticar falhas".