빌드 로그 파일 보기, 저장 및 구성
Visual Studio IDE(인터랙티브 개발 환경)에서 프로젝트를 빌드한 후에는 Visual Studio 출력 창에서 빌드에 대한 로깅된 정보를 볼 수 있습니다. 출력 데이터는 로그 파일에 저장하여 Visual Studio 및 기타 편집기에서 볼 수 있습니다.
로그는 빌드 문제를 해결하는 데 도움이 될 수 있습니다. 모든 빌드 도구에 사용된 정확한 명령줄을 찾고 전체 빌드 프로세스에 대한 전체 진단 데이터를 얻을 수 있습니다. Visual Studio는 빌드 출력 및 빌드 로그 파일에 표시할 정보의 종류를 지정할 수 있는 옵션을 제공합니다.
이 문서에서는 Visual Studio에서 빌드 로그 파일을 생성, 구성 및 확인하는 방법에 대해 설명합니다.
빌드 로그 파일 생성 및 보기
다음 절차에 따라 시나리오에 대한 빌드 로그 파일을 생성하고 확인합니다.
C++ 프로젝트:
Visual Studio는 프로젝트를 빌드할 때 로그 파일을 저장합니다. 로그 파일의 일반적인 위치는 Release\<ProjectName>.log, Debug\<ProjectName>.log, <ProjectName>.txt 등입니다. 모든 파일 위치는 프로젝트 루트 폴더를 기준으로 하며 특정 구성에 따라 달라집니다.
Windows 탐색기 또는 파일 탐색기를 사용하여 로그 파일을 찾아봅니다.
원하는 편집기에서 로그 파일을 엽니다.
.NET 프로젝트:
NET 프로젝트의 경우 Visual Studio에 로그 파일을 저장하도록 지시합니다:
Visual Studio에서 빌드>솔루션 빌드를 선택합니다.
출력 창에서 텍스트를 선택하고 Ctrl+S 키보드 단축키를 사용합니다.
Visual Studio에서 빌드 출력을 저장할 위치를 묻는 메시지가 표시됩니다. 그런 다음 해당 위치의 로그 파일을 Visual Studio 또는 다른 편집기에서 열 수 있습니다.
MSBuild:
-fileLogger(-fl) 명령줄 옵션을 사용하여 명령줄에서 직접 MSBuild를 실행하여 빌드 로그를 생성할 수 있습니다. 자세한 내용은 MSBuild로 빌드 로그 가져오기를 참조하세요.또한 이진 로그(
-binaryLogger또는-bl명령줄 옵션)를 생성하기 위해 MSBuild를 사용할 수 있습니다. 구조적 로그 뷰어에서 이진 로그를 볼 수 있습니다. 복잡한 빌드 프로세스를 더 쉽게 이해할 수 있도록, 구조적 로그 뷰어가 보다 풍부한 UI를 제공합니다.
파일 시스템에 이진 로그를 쓰도록 Visual Studio를 구성하기 위해 환경 변수를 설정할 수 있습니다. MSBuildDebugEngine을(를) 1(으)로 설정하고, MSBUILDDEBUGPATH을(를) 빌드 로그 파일의 원하는 위치로 설정합니다. Visual Studio가 시작되는 환경에서 변수를 설정해야 합니다. 이러한 설정은 빌드의 특정 호출에 대한 로그만 원하는 경우에는 좋지 않을 수 있으며, 이는 모든 Visual Studio 빌드에 영향을 주기 때문입니다.
.NET 프로젝트의 빌드 로깅에 대한 고급 UI 지원을 위해 프로젝트 시스템 도구 확장을 설치하는 것을 고려하세요. 확장을 설치하면 로그 목록에서 선택할 수 있으며, UI에서 이진 로깅을 켜고 끌 수 있습니다. 하지만 로그는 출력 창에서 가져오는 로그 또는 환경 변수와 약간 다르며, 이는 Visual Studio 빌드 시스템과 통합되는 방식 때문입니다.
빌드 로그에 대한 데이터 상세 정보 지정
빌드 로그 파일에 포함할 정보의 양을 지정할 수 있습니다. 로그 파일 열의 데이터 양은 로거 세부 정보로 측정됩니다. 로그 파일 행 수는 수집된 메시지를 나타냅니다. 로그 상세도(열 값)는 로깅된 메시지 유형(행 값)에 영향을 줍니다. Quiet 세부 정보는 빌드 출력에 최소한의 로깅을 생성합니다. 진단은 가장 자세한 설정으로 가능한 모든 데이터가 포함된 로그 파일을 생성합니다.
다음 표는 로거의 세부 정보에 따라 어떤 유형의 메시지가 수집되는지 보여줍니다:
| 메시지 유형/세부 정보 표시 | Quiet | 최소 | 보통 | 자세히 | 진단 |
|---|---|---|---|---|---|
| 오류 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 경고 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 중요도 높은 메시지 | ✅ | ✅ | ✅ | ✅ | |
| 중요도 보통인 메시지 | ✅ | ✅ | ✅ | ||
| 중요도 낮은 메시지 | ✅ | ✅ | |||
| 기타 MSBuild 엔진 정보 | ✅ |
다음 단계를 사용하여 로거 세부 정보를 구성할 수 있습니다.
Visual Studio에서 도구>옵션를 선택하여 옵션 대화 상자를 엽니다.
대화 상자에서 프로젝트 및 솔루션 섹션을 확장하고 빌드 및 실행 탭을 선택합니다.
MSBuild 프로젝트 빌드 출력 세부 정보 드롭다운 목록을 사용하여 빌드 출력 기본 설정을 선택합니다.
MSBuild 프로젝트 빌드 로그 파일 세부 정보 드롭다운 목록을 사용하여 로거 상세도 기본 설정을 선택합니다.
팁
컴파일러 및 기타 도구에 사용되는 명령줄을 보려면 최소한 세부 정보 표시 수준을 선택합니다.
변경 사항을 적용하려면 확인을 선택합니다.
Important
출력창에서 변경 사항을 적용하려면 프로젝트를 다시 빌드해야 합니다. C++ 프로젝트의 경우 프로젝트 리빌드는 변경 사항이 <ProjectName>.txt 파일에도 반영되도록 합니다.
자세한 내용은 옵션 대화 상자, 프로젝트 및 솔루션, 빌드 및 실행 및 LoggerVerbosity를 참조하세요.
대용량 로그 파일에 이진 로그 사용
이진 로그는 .NET 프로젝트의 선택적 기능으로, 큰 로그에서 정보를 쉽게 찾을 수도 있는 풍부한 로그 탐색 환경을 제공합니다. 이진 로그를 사용하려면 프로젝트 시스템 도구를 설치합니다. 자세한 내용은 https://msbuildlog.com 및 이진 로그를 참조하세요.
이진 로그는 .NET 프로젝트의 선택적 기능으로, 큰 로그에서 정보를 쉽게 찾을 수도 있는 풍부한 로그 탐색 환경을 제공합니다. 이진 로그를 사용하려면 프로젝트 시스템 도구 2022를 설치합니다. 자세한 내용은 https://msbuildlog.com 및 이진 로그를 참조하세요.