Os logs não são detalhados o suficiente

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

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

Para habilitar o log de depuração de etapas:

1. No repositório que contém o fluxo de trabalho, defina o seguinte segredo ou variável: ACTIONS_STEP_DEBUG como true. Se o segredo e a variável estiverem definidos, o valor do segredo terá precedência sobre a variável.
2. Execute novamente o fluxo de trabalho ou dispare uma nova execução.

Depois que o segredo ou a variável são definidos, mais eventos de depuração são mostrados nos logs de etapas. Confira Usando registros de execução de fluxo de trabalho.

Você também pode usar o contexto runner.debug para executar etapas condicionalmente somente quando o registro em log de depuração estiver ativado. Confira Referência de contextos.

Criação de CodeQL artefatos de depuração

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ários idiomas simultaneamente como parte da execução do fluxo de trabalho, haverá um desses artefatos para cada idioma. Os dados contêm os CodeQL logs, CodeQL bancos de dados, arquivos de código-fonte extraídos e todos os arquivos SARIF produzidos pelo fluxo de trabalho. Para obter mais informações sobre como baixar CodeQL artefatos, consulte Baixar artefatos do fluxo de trabalho.

Esses artefatos ajudarão você a depurar problemas com CodeQLcode scanning. Se você entrar em contato Suporte do GitHub, eles poderão solicitar esses dados.

Criando CodeQL artefatos de depuração para CodeQL configuração padrão

Você pode criar CodeQL artefatos de depuração ao habilitar os logs de depuração de etapa (consulte Como habilitar os logs de depuração de etapa) e acionar uma nova CodeQL análise, por exemplo, fazendo push de um novo commit para uma branch do pull request.

Criando artefatos de depuração CodeQL para a configuração avançada CodeQL

Artefatos de depuração para a configuração avançada de CodeQL podem ser obtidos de várias formas.

Executar trabalhos novamente com o log de depuração habilitado

A maneira mais fácil de 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 obter mais informações sobre como reexecutar GitHub Actionsfluxos de trabalho e tarefas, consulte Reexecutando fluxos de trabalho e tarefas.

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 CodeQL artefatos de depuração para investigar melhor. Você não precisa modificar o arquivo de fluxo de trabalho ao criar CodeQL artefatos de depuração ao reexecutar os trabalhos.

Usando um sinalizador de fluxo de trabalho

Você pode criar CodeQL artefatos de depuração usando uma flag no seu fluxo de trabalho. Para isso, você precisa modificar a init etapa do Fluxo de trabalho de análise do CodeQL arquivo e definir debug: true.

- name: Initialize CodeQL
  uses: github/codeql-action/init@v4
  with:
    debug: true

Usando o registro de depuração passo a passo GitHub Actions

Se você habilitar o log de depuração de etapas GitHub Actions, CodeQL também produzirá artefatos de depuração e os enviará como parte da execução do fluxo de trabalho. Para encontrar instruções, consulte Habilitando o log de depuração da etapa.