You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ide/how-to-view-save-and-configure-build-log-files.md
+22-16Lines changed: 22 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
---
2
-
title: 'How to: View, save, and configure build log files | Microsoft Docs'
3
-
description: Learn how you can view, save, and configure build log files. These files provide useful information for tasks like troubleshooting a build failure.
2
+
title: 'How to: View, save, and configure build log files'
3
+
description: Learn how you can view, save, and configure build log files. These files provide information such as the command lines used for the compiler and other tools, which can help you troubleshoot build failures.
After you build a project in the Visual Studio IDE, you can view information about that build in the **Output** window. By using this information, you can, for example, troubleshoot a build failure.
19
+
After you build a project in the Visual Studio IDE, you can view information about that build in the **Output** window. By using this information, you can troubleshoot a build failure, view the exact command lines used for all the build tools, or get full diagnostic information about the entire build process.
20
20
21
21
- For C++ projects, you can also view the same information in a log file that's created and saved when you build a project.
22
22
23
-
- For managed code projects, you can click in the build output window and press **Ctrl**+**S**. Visual Studio prompts you for a location to save the information from the **Output** window into a log file.
23
+
- For .NET projects, you can click in the build output window and press **Ctrl**+**S**. Visual Studio prompts you for a location to save the information from the **Output** window into a log file.
24
24
25
25
You can also use the IDE to specify what kinds of information you want to view about each build.
26
26
@@ -48,20 +48,25 @@ You can also generate logs by running MSBuild directly from the command line, us
48
48
49
49
2. On the **Projects and Solutions** page, choose the **Build and Run** page.
50
50
51
-
3. In the **MSBuild project build output verbosity** list, choose one of the following values, and then choose the **OK** button.
51
+
3. In the **MSBuild project build output verbosity** list, choose one of the values, and then choose the **OK** button.
52
52
53
-
|Verbosity level|Description|
54
-
| - |-----------------|
55
-
|**Quiet**|Displays a summary of the build only.|
56
-
|**Minimal**|Displays a summary of the build and errors, warnings, and messages that are categorized as highly important.|
57
-
|**Normal**|Displays a summary of the build; errors, warnings, and messages that are categorized as highly important; and the main steps of the build. You'll use this level of detail most frequently.|
58
-
|**Detailed**|Displays a summary of the build; errors, warnings, and messages that are categorized as highly important; all of the steps of the build; and messages that are categorized as of normal importance.|
59
-
|**Diagnostic**|Displays all data that's available for the build. You can use this level of detail to help debug issues with custom build scripts and other build issues.|
53
+
The following table shows how the log verbosity (column values) affects which types of message (row values) are logged.
60
54
61
-
For more information, see [Options dialog box, Projects and Solutions, Build and Run](../ide/reference/options-dialog-box-projects-and-solutions-build-and-run.md) and <xref:Microsoft.Build.Framework.LoggerVerbosity>.
55
+
| Message type / Verbosity | Quiet | Minimal | Normal | Detailed | Diagnostic |
> You must rebuild the project for your changes to take effect in the **Output** window (all projects) and the *\<ProjectName>.txt* file (C++ projects only).
64
+
If you want to see the command lines used for the compiler and other tools, choose at least the **Detailed** verbosity level.
65
+
66
+
For more information, see [Options dialog box, Projects and Solutions, Build and Run](../ide/reference/options-dialog-box-projects-and-solutions-build-and-run.md) and <xref:Microsoft.Build.Framework.LoggerVerbosity>.
67
+
68
+
> [!IMPORTANT]
69
+
> You must rebuild the project for your changes to take effect in the **Output** window (all projects) and the *\<ProjectName>.txt* file (C++ projects only).
65
70
66
71
## Use binary logs to make it easier to browse large log files
67
72
@@ -75,3 +80,4 @@ Binary logs are an optional feature for .NET projects that lets you have a riche
75
80
76
81
-[Build and clean projects and solutions in Visual Studio](../ide/building-and-cleaning-projects-and-solutions-in-visual-studio.md)
77
82
-[Compile and build](../ide/compiling-and-building-in-visual-studio.md)
83
+
-[Obtaining build logs with MSBuild](../msbuild/obtaining-build-logs-with-msbuild.md)
0 commit comments