Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

로그 요약 생성

이 문서의 내용

[고급] 구조화된 로그 파일의 요약을 만듭니다.

GitHub CodeQL은(는) 설치 시 사용자 단위로 라이선스가 부여됩니다. 라이선스 제한에 따라 특정 작업에만 CodeQL을(를) 사용할 수 있습니다. 자세한 내용은 "CodeQL CLI 정보"을 참조하세요.

GitHub Advanced Security 라이선스가 있는 경우 CodeQL를 사용하여 자동화된 분석, 지속적인 통합 및 지속적인 업데이트를 수행할 수 있습니다. 자세한 내용은 "GitHub Advanced Security 정보"을 참조하세요.

이 콘텐츠는 CodeQL CLI의 최신 릴리스에 대해 설명합니다. 이 릴리스에 대한 자세한 내용은 를 참조하세요 https://github.com/github/codeql-cli-binaries/releases.

이전 릴리스에서 이 명령에 사용할 수 있는 옵션에 대한 세부 정보를 보려면 터미널에서 옵션을 사용하여 명령을 --help 실행합니다.

개요

Shell
codeql generate log-summary <options>... -- <input> <result>

Description

[고급] 구조화된 로그 파일의 요약을 만듭니다.

이 명령은 구조화된 JSON 계산기 이벤트 로그의 요약을 만듭니다. 이 명령의 출력은 로그 파일 자체보다 CLI의 여러 버전에서 더 안정적입니다. 따라서 로그의 출력을 사용하는 스크립트를 구현하는 경우 이벤트 로그를 직접 사용하는 대신 이 명령을 실행하고 해당 출력을 사용하는 것이 좋습니다.

기본 옵션

<input>

[필수] 요약을 생성할 이벤트 로그 파일의 경로입니다.

<result>

요약된 로그 파일을 출력할 위치의 경로입니다. 생략하면 요약이 stdout으로 출력됩니다.

--minify-output

해당하는 경우 출력된 요약에서 공백을 생략합니다. 그 결과 사람이 읽을 수 있는 것이 적지만 메모리는 줄어듭니다. 이 옵션은 일부 출력 형식에만 영향을 줍니다.

--utc

[고급] 이 명령으로 생성된 요약의 특정 타임스탬프는 실행 중인 컴퓨터의 로컬 표준 시간대를 사용할 수 있습니다. 이 플래그를 사용하도록 설정하면 모든 타임스탬프가 UTC가 됩니다.

--format=<format>

생성된 출력의 형식을 제어합니다.

predicates(기본값): 각 조건자에서 수행되는 계산에 대한 요약을 생성합니다. 기본적으로 두 개의 줄 바꿈 문자로 구분된 JSON 개체의 스트림이거나 옵션이 전달된 경우 --minify-output 1개입니다.

text: 사람이 읽을 수 있는 평가 실행 요약을 생성합니다.

overall: 몇 가지 요약 통계 및 가장 시간이 많이 소요되는 평가에 대한 정보를 포함하여 평가 실행에 대한 일부 전체 정보가 포함된 JSON 파일을 생성합니다.

--[no-]deduplicate-stage-summaries

[고급] 이 옵션은 텍스트 형식과 함께만 작동합니다. 이 값이 전달되면 쿼리 간에 공유되는 단계에 대해 가장 비용이 많이 드는 조건자가 포함된 요약 테이블이 반복되지 않습니다. 이렇게 하면 해당 쿼리가 완료된 시점에 각 쿼리에 대한 테이블을 표시하지 않고 모든 요약 테이블을 로그의 끝으로 이동하는 부작용이 있습니다.

일반 옵션

-h, --help

이 도움말 텍스트를 표시합니다.

-J=<opt>

[고급] 명령을 실행하는 JVM에 옵션을 제공합니다.

(공백을 포함하는 옵션이 올바르게 처리되지 않도록 주의하세요.)

-v, --verbose

인쇄된 진행률 메시지 수를 증분 방식으로 늘입니다.

-q, --quiet

인쇄되는 진행률 메시지 수를 증분 방식으로 줄입니다.

--verbosity=<level>

[고급] 세부 정보 수준을 오류, 경고, 진행률, progress+, progress++, progress++, progress++중 하나로 명시적으로 설정합니다. -v-q를 재정의합니다.

--logdir=<dir>

[고급] 타임스탬프와 실행 중인 하위 명령의 이름을 포함하는 생성된 이름을 사용하여 지정된 디렉터리의 하나 이상의 파일에 자세한 로그를 씁니다.

(이름을 가진 로그 파일을 작성하려면 모든 권한을 부여 --log-to-stderr 하고 원하는 대로 stderr를 리디렉션합니다.)