Skip to content

Commit 7dfda7e

Browse files
authored
Add instructions for viewing build-time OpenAPI logs (#36071)
1 parent f932b4b commit 7dfda7e

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

aspnetcore/fundamentals/openapi/aspnetcore-openapi.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to generate and customize OpenAPI documents in an ASP.NET
55
ms.author: safia
66
monikerRange: '>= aspnetcore-6.0'
77
ms.custom: mvc
8-
ms.date: 07/09/2025
8+
ms.date: 09/22/2025
99
uid: fundamentals/openapi/aspnetcore-openapi
1010
---
1111
# Generate OpenAPI documents
@@ -234,6 +234,22 @@ cat obj/{ProjectName}.json
234234

235235
---
236236

237+
### View build-time OpenAPI logs (Terminal Logger)
238+
239+
When `Microsoft.Extensions.ApiDescription.Server` runs the **:::no-loc text="GetDocument":::** step during `dotnet build`, progress messages aren't visible with the .NET Terminal Logger at default verbosity in .NET 8 or later. To surface these messages while building, use either of the following options with the `dotnet build` command.
240+
241+
Set the Terminal Logger's verbosity with the `-tlp` option set to `v=d` (verbosity = detailed):
242+
243+
```dotnetcli
244+
dotnet build -tlp:v=d
245+
```
246+
247+
Disable the Terminal Logger and use legacy-style logs with the [`--tl` option](/dotnet/core/tools/dotnet-build#options) set to `off`:
248+
249+
```dotnetcli
250+
dotnet build --tl:off
251+
```
252+
237253
### Customizing build-time document generation
238254

239255
#### Modifying the output directory of the generated Open API file

0 commit comments

Comments
 (0)