로깅 및 진단

마지막 업데이트: 2026. 10. 14.

QV2QS는 모든 실행 중에 구조화된 진단 로그를 작성합니다.로깅 시스템은 두 가지 계층을 가집니다: 실행 간에도 유지되는 영구 시스템 로그와 변환 출력과 함께 제공되는 실행별 구조화된 로그입니다.

시스템 로그

QV2QS는 디스크의 고정된 위치에 롤링 로그 파일을 유지합니다.시스템 로그는 실행 파일이 시작될 때 시작되며, 프로젝트나 배치와는 독립적으로 애플리케이션 수준 이벤트를 기록합니다.

위치: %LOCALAPPDATA%\QV2QS\qv2qs.log

시스템 로그는 다음 설정을 사용하여 순환 파일 핸들러를 사용합니다.

활성 로그 파일이 25MB에 도달하면, QV2QS는 파일을 교체하고 새 로그 파일을 생성합니다.가장 최근 백업 3개가 보존됩니다.오래된 백업은 자동으로 삭제됩니다.

실행별 구조화된 로그

각 변환 실행은 해당 실행에 대한 자세한 이벤트를 포함하는 별도의 로그 파일을 생성합니다.파일 이름은 qv2qs_run_<version>_<timestamp>.log 이며, JSON 데이터 열이 있는 탭으로 구분된 값(TSV) 형식으로 작성되었습니다.

기본 위치: %LOCALAPPDATA%\QV2QS\logs\

단일 프로젝트 모드에서 QV2QS는 출력 폴더가 초기화된 후 로그 파일을 프로젝트 출력 폴더의 logs/ 하위 폴더(예: <outputDir>/Sales/logs/)로 승격합니다.로그 파일은 변환 출력에 포함됩니다.

일괄 모드에서, 프로젝트별 로그는 각 프로젝트 출력 폴더 내의 logs/ 하위 폴더에 기록됩니다.

로그 파일 형식

각 로그 파일은 TSV 헤더 행으로 시작합니다:

ts_utc	level	version	run_id	logger	event	message	data

타임스탬프 충돌

두 개의 실행이 같은 초 내에 시작되고 동일한 타임스탬프를 생성하는 경우, QV2QS는 덮어쓰기를 방지하기 위해 파일 이름에 _2, _3 또는 그 이후의 숫자를 추가합니다.

확인할 로그

QV2QS는 실행의 여러 단계에서 두 개의 개별 로그에 기록합니다.시스템 로그는 항상 이용 가능합니다.실행별 로그는 시작 초기화가 완료된 후에만 생성됩니다.

로그 수준

5가지 로그 레벨이 제공되며, 가장 상세한 것부터 덜 상세한 것 순으로 나열됩니다.

로그 수준을 --logLevel 또는 QV2QS_LOG_LEVEL 환경 변수로 설정합니다.둘 다 설정된 경우 CLI 플래그가 우선합니다.

가장 상세한 출력을 캡처하도록 --logLevel DEBUG을(를) 설정합니다.디버그 수준 항목에는 변환 결정, 클라우드 API 호출, 스크립트 수정 및 개체 처리 세부 정보가 포함됩니다.

명령줄을 수정하지 않고 디버그 로깅을 활성화하려면, QV2QS를 실행하기 전에 환경 변수를 설정하십시오:

set QV2QS_LOG_LEVEL=DEBUG
QV2QS.exe --prjPath ./MyApp-prj --outputDir ./output --qvw MyApp.qvw --unbuildOnly

로그 정리

로그 파일은 영구 로그 디렉터리에 실행 전반에 걸쳐 누적됩니다.실행 시작 시 30일 이상 된 로그 파일을 삭제하려면 --cleanLogs을(를) 사용하세요.정리 작업은 영구 로그 디렉터리에만 적용되며, 출력 디렉터리의 프로젝트별 로그는 영향을 받지 않습니다.

비밀 마스킹

로그 항목은 민감한 값을 자동으로 마스킹합니다.API 키, 토큰, 비밀번호 및 클라이언트 보안 비밀은 마지막 네 자리만 표시되도록 가려집니다.비밀이 포함된 명령줄 인수도 로깅될 때 마스킹됩니다.

QlikView Desktop 엔진 로깅

PRJ 생성이 활성화되면, QV2QS는 어떤 QlikView Desktop 엔진이 각 파일에 사용되었는지 기록합니다.로그 이벤트 prj_generate_start는 번들된 휴대용 엔진 또는 시스템에 설치된 버전이 활성인지 기록하고, 사용 가능한 경우 번들된 실행 파일의 파일 버전을 포함합니다.

QlikView Desktop에 대한 연결이 설정되면, prj_qv_ready 이벤트는 실행 중인 엔진에서 보고한 QlikView 버전을 기록합니다(예: 12.100.20100.0).번들된 엔진을 사용하는 경우, exe_file_version 필드에는 실행 파일에서 읽은 파일 버전이 기록됩니다.

배치 모드에서, 로그 이벤트 prj_batch_prereq는 파일이 처리되기 전에 전체 배치에 대한 엔진 선택 및 번들 버전을 기록합니다.번들 엔진도 시스템 설치도 사용할 수 없는 경우, 오류가 시스템 로그에 prj_batch_no_qv(으)로 기록됩니다.

--logLevel DEBUG을(를) 설정하여 엔진 검색 중 확인된 파일 경로를 포함한 상세 엔진 해결 단계를 캡처합니다.

콘솔 출력 대 파일 로깅

콘솔 출력과 파일 로깅은 독립적인 시스템입니다.

콘솔 출력이 로그 파일에 나타나지 않습니다.--console silent 플래그는 파일 로깅에 영향을 주지 않으면서 콘솔 출력을 억제합니다.

CLI 인수

자세히 알아보기

• 인수 참조
• 문제 해결