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 registro de depuração de etapas no 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 com debug-artifacts. Se CodeQL analisar vários idiomas ao mesmo tempo durante a execução do fluxo, haverá um desses artefatos para cada idioma. Os dados contêm os logs CodeQL, bancos de dados CodeQL, arquivos de código-fonte extraídos e quaisquer arquivos SARIF produzidos pelo pipeline. 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.
Criando artefatos de depuração para a configuração padrão de CodeQL
Você pode criar artefatos de depuração do CodeQL ativando o registro de depuração em log do GitHub Actions e iniciando uma nova análise do CodeQL, por exemplo, fazendo um push de um novo commit para um branch de solicitação de pull. Para obter informações sobre como ativar o registro de log de depuração de etapas para GitHub Actions, consulte Habilitando o log de depuração.
Criando artefatos de depuração CodeQL para a CodeQL configuração avançada
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 CodeQL configuração avançada é 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 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
Usando o registro de log de depuração da etapa GitHub Actions
Se você tiver habilitado o registro de depuração de etapas em GitHub Actions, CodeQL também produzirá artefatos de debug e os carregará. Confira Habilitando o log de depuração.