Logging topic enhancements (#7657)

pull/7836/head
Luke Latham 2018-07-26 16:26:30 -05:00 committed by GitHub
parent 7e5f4de8a3
commit 473ac7036c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 17 additions and 7 deletions

View File

@ -50,7 +50,7 @@ To use a provider, call the provider's `Add<ProviderName>` extension method in *
[!code-csharp[](index/sample2/Program.cs?name=snippet_ExpandDefault&highlight=16,17)] [!code-csharp[](index/sample2/Program.cs?name=snippet_ExpandDefault&highlight=16,17)]
The default project template enables logging with the [CreateDefaultBuilder](/dotnet/api/microsoft.aspnetcore.webhost.createdefaultbuilder?view=aspnetcore-2.0#Microsoft_AspNetCore_WebHost_CreateDefaultBuilder_System_String___) method: The default project template enables the Console and Debug logging providers with a call to the [CreateDefaultBuilder](/dotnet/api/microsoft.aspnetcore.webhost.createdefaultbuilder) extension method in *Program.cs*:
[!code-csharp[](index/sample2/Program.cs?name=snippet_TemplateCode&highlight=7)] [!code-csharp[](index/sample2/Program.cs?name=snippet_TemplateCode&highlight=7)]
@ -71,11 +71,21 @@ ASP.NET Core [dependency injection](xref:fundamentals/dependency-injection) (DI)
::: moniker-end ::: moniker-end
You'll find information about each [built-in logging provider](#built-in-logging-providers) and links to [third-party logging providers](#third-party-logging-providers) later in the article. Learn more about the [built-in logging providers](#built-in-logging-providers) and find links to [third-party logging providers](#third-party-logging-providers) later in the article.
## Settings file configuration ## Configuration
Each of the preceding examples in the [How to add providers](#how-to-add-providers) section loads logging provider configuration from the `Logging` section of app settings files. The following example shows the contents of a typical *appsettings.Development.json* file: Logging provider configuration is provided by one or more configuration providers:
* File formats (INI, JSON, and XML).
* Command-line arguments.
* Environment variables.
* In-memory .NET objects.
* The unencrypted [Secret Manager](xref:security/app-secrets) storage.
* An encrypted user store, such as [Azure Key Vault](xref:security/key-vault-configuration).
* Custom providers (installed or created).
For example, logging configuration is commonly provided by the `Logging` section of app settings files. The following example shows the contents of a typical *appsettings.Development.json* file:
::: moniker range=">= aspnetcore-2.1" ::: moniker range=">= aspnetcore-2.1"
@ -117,6 +127,8 @@ Each of the preceding examples in the [How to add providers](#how-to-add-provide
::: moniker-end ::: moniker-end
For information on implementing configuration providers, see <xref:fundamentals/configuration/index>.
## Sample logging output ## Sample logging output
With the sample code shown in the preceding section, you'll see logs in the console when you run from the command line. Here's an example of console output: With the sample code shown in the preceding section, you'll see logs in the console when you run from the command line. Here's an example of console output:
@ -430,7 +442,7 @@ The following code enables scopes for the console provider:
> [!NOTE] > [!NOTE]
> Configuring the `IncludeScopes` console logger option is required to enable scope-based logging. > Configuring the `IncludeScopes` console logger option is required to enable scope-based logging.
> >
> `IncludeScopes` can be configured via *appsettings* configuration files. For more information, see the [Settings file configuration](#settings-file-configuration) section. > For information on configuration, see the [Configuration](#Configuration) section.
::: moniker-end ::: moniker-end

View File

@ -1,6 +1,5 @@
{ {
"Logging": { "Logging": {
"IncludeScopes": false,
"LogLevel": { "LogLevel": {
"Default": "Debug", "Default": "Debug",
"System": "Information", "System": "Information",

View File

@ -13,4 +13,3 @@
} }
} }
} }