로그가 충분히 상세하지 않음

로그가 문제를 해결하기에 충분하지 않은 경우 추가 정보를 얻고 로그를 더 유용하게 만들기 위해 수행할 수 있는 몇 가지 단계가 있습니다.

단계 디버그 로깅 사용

GitHub Actions에서 단계 디버그 로깅을 활성화하여 작업 실행 중에 작업 로그의 세부 정보를 늘릴 수 있습니다. 자세한 내용은 디버그 로깅 사용을(를) 참조하세요.

CodeQL 디버깅 아티팩트 만들기

CodeQL을 디버그하는 데 도움이 되는 아티팩트를 가져올 수 있습니다. 디버그 아티팩트가 워크플로 실행 시 이름이 로 시작하는 debug-artifacts아티팩트로 업로드됩니다. CodeQL에서 워크플로 실행의 일부로 여러 언어를 동시에 분석하는 경우, 각 언어마다 하나의 아티팩트가 생성됩니다. 데이터에는 CodeQL 로그, CodeQL 데이터베이스, 추출된 소스 코드 파일 및 워크플로에서 생성된 SARIF 파일이 포함됩니다. CodeQL 아티팩트 다운로드에 대한 자세한 내용은 워크플로 아티팩트 다운로드 내용을 참조하세요.

이러한 아티팩트는CodeQL code scanning으로 문제를 디버그하는 데 도움이 됩니다. GitHub 지원에 문의하면 해당 사용자가 이 데이터를 요청할 수 있습니다.

CodeQL 기본 설정에 대한 CodeQL 디버깅 아티팩트 만들기

GitHub Actions 단계 디버그 로깅을 활성화하고, 예를 들어 끌어오기 요청 분기에 새 커밋을 푸시하여 새 CodeQL 분석을 트리거하면 CodeQL 디버깅 아티팩트를 만들 수 있습니다. GitHub Actions 단계 디버그 로깅을 활성화하는 방법에 대한 자세한 내용은 디버그 로깅 사용을 참조하세요.

CodeQL 고급 설정에 대한 CodeQL 디버깅 아티팩트 만들기

CodeQL 고급 설정의 디버깅 아티팩트는 여러 방식으로 획득할 수 있습니다.

디버그 로깅을 사용하도록 설정된 작업 다시 실행

CodeQL의 고급 설정을 위한 디버깅 아티팩트를 만드는 가장 간단한 방법은 디버그 로깅이 활성화된 상태에서 작업을 다시 실행하는 것입니다. GitHub Actions 워크플로 및 작업을 다시 실행하는 방법에 대한 자세한 정보는 워크플로 및 작업 다시 실행 내용을 참조하세요.

디버그 로깅 사용을 선택해야 합니다. 이 옵션은 다시 실행에 대한 실행기 진단 로깅 및 단계 디버그 로깅이 사용하도록 설정합니다. 그런 다음 CodeQL 디버깅 아티팩트를 다운로드하여 추가로 조사할 수 있습니다. 작업을 다시 실행하여 CodeQL 디버깅 아티팩트를 만들 때 워크플로 파일을 수정할 필요가 없습니다.

워크플로 플래그 사용

워크플로에서 플래그를 사용하여 CodeQL 디버깅 아티팩트를 만들 수 있습니다. 이를 위해서는 CodeQL 분석 워크플로 파일의 init 단계를 수정하고 debug: true로 설정해야 합니다.

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

GitHub Actions 단계별 디버그 로그 사용하기

GitHub Actions 단계 디버그 로깅을 활성화하면, CodeQL 또한 디버깅 아티팩트를 생성하여 업로드합니다. 디버그 로깅 사용을(를) 참조하세요.