Se os logs não forem detalhados o suficiente para solucionar um problema, há várias etapas que você pode executar para obter informações extras e tornar os logs mais úteis.
Habilitar log de depuração da etapa
Você pode habilitar o log de depuração de etapas em GitHub Actions para aumentar a verbosidade dos logs de um trabalho durante sua execução. Para saber mais, confira Habilitando o log de depuração.
Criando artefatos de depuração de CodeQL
Aviso
Os artefatos de depuração do CodeQL contêm uma cópia do código-fonte que está sendo analisado por CodeQL, portanto, sugerimos compartilhar esses pacotes apenas com pessoas autorizadas a acessar esse código-fonte.
Você pode obter artefatos para ajudar você a depurar CodeQL.
Os artefatos de depuração serão carregados na execução do fluxo de trabalho como artefatos com nomes começando em debug-artifacts. Se CodeQL analisar várias linguagens ao mesmo tempo durante a execução do fluxo, haverá um desses artefatos para cada uma. Os dados contém os logs de CodeQL, bancos de dados de CodeQL, exceto arquivos de código-fonte, e todos os outros arquivos SARIF produzidos pelo fluxo de trabalho. Para mais informações sobre o download de artefatos de CodeQL, consulte Fazer o download de artefatos do fluxo de trabalho.
Estes artefatos ajudarão você a depurar problemas com digitalização de código de CodeQL code scanning. Se você entrar em contato com o suporte do GitHub, eles poderão pedir estes dados.
Como criar artefatos de depuração de CodeQL para a configuração padrão de CodeQL
Você pode criar artefatos de depuração de CodeQL ativando o log de depuração do GitHub Actions e iniciando uma nova análise do CodeQL, com ao fazer um push de um novo commit para uma ramificação de solicitação de pull. Para saber mais sobre como ativar o registro de log de depuração de etapas para GitHub Actions, consulte Habilitando o log de depuração.
Como criar artefatos de depuração de CodeQL para a configuração avançada de CodeQL
Artefatos de depuração para a configuração avançada de CodeQL podem ser obtidos de várias maneiras.
Executar trabalhos novamente com o log de depuração habilitado
A opção mais fácil para criar artefatos de depuração para a configuração avançada de CodeQL é executar os trabalhos novamente com o log de depuração habilitado. Para mais informações sobre como executar novamente os fluxos de trabalho e os trabalhos de GitHub Actions, consulte Reexecutando fluxos de trabalho e trabalhos.
Selecione Habilitar log de depuração. Essa opção habilita o log de diagnóstico do executor e o log de depuração de etapas para a execução. Em seguida, você poderá baixar os artefatos de depuração de CodeQL para uma investigação mais aprofundada. Você não precisa modificar o arquivo de fluxo de trabalho ao criar artefatos de depuração do CodeQL executando novamente trabalhos.
Usando um sinalizador de fluxo de trabalho
Você pode criar artefatos de depuração de CodeQL usando um sinalizador no seu fluxo de trabalho. Para isso, você precisa modificar a etapa init do arquivo do Fluxo de trabalho de análise do CodeQL e definir debug: true.
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
debug: true
Como usar o log de depuração da etapa de GitHub Actions
Se você tiver habilitado o log de depuração de etapas de GitHub Actions, CodeQL também produzirá artefatos de depuração e os carregará. Confira Habilitando o log de depuração.