{"meta":{"title":"Os logs não são detalhados o suficiente","intro":"Aumente a verbosidade do log e gere artefatos de depuração quando os logs não tiverem detalhes de diagnóstico.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/reference","title":"Referência"},{"href":"/pt/code-security/reference/code-scanning","title":"Varredura de código"},{"href":"/pt/code-security/reference/code-scanning/troubleshoot-analysis-errors","title":"Solucionar problemas de erros de análise"},{"href":"/pt/code-security/reference/code-scanning/troubleshoot-analysis-errors/logs-not-detailed-enough","title":"Logs não detalhados o suficiente"}],"documentType":"article"},"body":"# Os logs não são detalhados o suficiente\n\nAumente a verbosidade do log e gere artefatos de depuração quando os logs não tiverem detalhes de diagnóstico.\n\nSe 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.\n\n## Habilitar log de depuração da etapa\n\nO log de depuração da etapa aumenta o detalhamento dos logs de um trabalho durante e depois da execução.\n\nPara habilitar o log de depuração de etapas:\n\n1. 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.\n2. Execute novamente o fluxo de trabalho ou dispare uma nova execução.\n\nDepois 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](/pt/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#viewing-logs-to-diagnose-failures).\n\nVocê 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](/pt/actions/reference/workflows-and-actions/contexts#runner-context).\n\n## Criando artefatos de depuração de CodeQL\n\n> \\[!WARNING]\n> 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.\n\nVocê pode obter artefatos para ajudar você a depurar CodeQL.\nOs 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 [Baixar artefatos do fluxo de trabalho](/pt/actions/managing-workflow-runs/downloading-workflow-artifacts).\n\nEstes artefatos ajudarão você a depurar problemas com digitalização de código de CodeQL code scanning. Se você entrar em contato com Suporte do GitHub, eles poderão solicitar esses dados.\n\n### Como criar artefatos de depuração de CodeQL para a configuração padrão de CodeQL\n\nVocê pode criar artefatos de depuração de CodeQL ativando o log de depuração do GitHub Actions (consulte [Habilitar log de depuração da etapa](#enabling-step-debug-logging)) e iniciando uma nova análise do CodeQL, ao publicar uma nova confirmação para uma ramificação de solicitação de pull.\n\nSe você tiver dado a CodeQL acesso a registros privados, artefatos adicionais cujos nomes começam com `proxy-log-file` estarão disponíveis. Eles contêm logs do proxy de autenticação usado na configuração padrão de CodeQL para autenticar solicitações para registros privados e podem ser usados para solucionar problemas nas configurações desses registros. Para saber mais, confira [Como dar aos recursos de segurança acesso a registros privados](/pt/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries).\n\n### Como criar artefatos de depuração de CodeQL para a configuração avançada de CodeQL\n\nArtefatos de depuração para a configuração avançada de CodeQL podem ser obtidos de várias maneiras.\n\n#### Executar trabalhos novamente com o log de depuração habilitado\n\nA 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 tarefas](/pt/actions/managing-workflow-runs/re-running-workflows-and-jobs).\n\nSelecione **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.\n\n#### Usando um sinalizador de fluxo de trabalho\n\nVocê 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`.\n\n```yaml\n- name: Initialize CodeQL\n  uses: github/codeql-action/init@v4\n  with:\n    debug: true\n```\n\n#### Como usar o log de depuração da etapa de GitHub Actions\n\nSe você tiver habilitado o log de depuração de etapas de GitHub Actions, CodeQL também produzirá artefatos de depuração e os carregará como parte da execução do fluxo de trabalho. Para encontrar instruções, consulte [Habilitando o log de depuração da etapa](#enabling-step-debug-logging)."}