Skip to content

Commit 785f073

Browse files
committed
draft with comment changes
1 parent 448a602 commit 785f073

File tree

2 files changed

+21
-10
lines changed

2 files changed

+21
-10
lines changed

articles/azure-app-configuration/enable-dynamic-configuration-aspnet-core.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -230,21 +230,27 @@ The configuration refresh is triggered by the incoming requests to your web app.
230230

231231
![Launching updated quickstart app locally](./media/quickstarts/aspnet-core-app-launch-local-after.png)
232232

233-
## Troubleshooting
233+
## Monitoring and Troubleshooting
234234

235-
Logs are output upon refresh and contain detailed information on changes to key-values in your App Configuration store and your application, as well as any issues that occur. This will allow you to monitor configuration refreshes as they happen.
235+
Logs are output upon refresh and contain detailed information on changes to key-values in your App Configuration store and your application, as well as any issues that occur. This will allow you to monitor configuration refreshes as they happen.
236236

237237
- A default `ILoggerFactory` is added automatically when `services.AddAzureAppConfiguration()` is invoked in your `ConfigureServices` method. The App Configuration provider uses this `ILoggerFactory` to create an instance of `ILogger`, which outputs these logs. No code changes are needed.
238-
- Logs are output to the console at different log levels.
238+
- Logs are output to the console at different log levels. The default level is `Information`.
239239

240240
| Log Level | Description |
241241
|---|---|
242242
| Debug | This log level is used for monitoring changes to key-values in your App Configuration store. Logs include the key and label of key-values updated in the App Configuration store. Depending on the content type, logs may also include the App Configuration store endpoint requested and whether the key-value was modified or deleted. |
243243
| Information | This log level is used for monitoring changes to your app's configuration. Logs include the keys of settings in the configuration that have been updated. |
244244
| Warning | This log level is used for identifying issues that occurred during refresh. Logs include the exception name and a message containing a brief description of the issue. |
245245
- The logging category is `Microsoft.Extensions.Configuration.AzureAppConfiguration.Refresh`, which appears before each log.
246+
- Here is an example `Information` level log:
247+
```console
248+
info: Microsoft.Extensions.Configuration.AzureAppConfiguration.Refresh[0]
249+
Setting updated from Key Vault. Key:'reference'
250+
```
246251

247-
For more information on how to utilize these logs, follow the instructions for [logging in .NET Core and ASP.NET Core](/aspnet/core/fundamentals/logging). Logs can alternatively be enabled and configured through [Azure SDK logging](/dotnet/azure/sdk/logging).
252+
253+
For more information on how to utilize these logs, follow the instructions for [logging in .NET Core and ASP.NET Core](/aspnet/core/fundamentals/logging). Using `ILogger` is the preferred method and will be prioritized as the logging source if an instance of `ILoggerFactory` is present. However, if `ILoggerFactory` is not available, logs can alternatively be enabled and configured through instructions for [Azure SDK logging for .NET core apps](./enable-dynamic-configuration-dotnet-core.md#monitoring-and-troubleshooting).
248254

249255
## Clean up resources
250256

articles/azure-app-configuration/enable-dynamic-configuration-dotnet-core.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -140,18 +140,23 @@ Calling the `ConfigureRefresh` method alone won't cause the configuration to ref
140140
> [!NOTE]
141141
> Since the cache expiration time was set to 10 seconds using the `SetCacheExpiration` method while specifying the configuration for the refresh operation, the value for the configuration setting will only be updated if at least 10 seconds have elapsed since the last refresh for that setting.
142142

143-
## Troubleshooting
143+
## Monitoring and Troubleshooting
144144

145-
Logs are output upon refresh and contain detailed information on changes to key-values in your App Configuration store and your application, as well as any issues that occur. This will allow you to monitor configuration refreshes as they happen.
145+
Logs are output upon refresh and contain detailed information on changes to key-values in your App Configuration store and your application, as well as any issues that occur. This will allow you to monitor configuration refreshes as they happen. You can enable these logs using the instructions for [logging with the Azure SDK for .NET](/dotnet/azure/sdk/logging).
146146

147-
- Logs are output to the console at different log levels.
147+
- Logs are output to the console at different log levels. The default level is `Informational`.
148148

149149
| Log Level | Description |
150150
|---|---|
151-
| Debug | This log level is used for monitoring changes to key-values in your App Configuration store. Logs include the key and label of key-values updated in the App Configuration store. Depending on the content type, logs may also include the App Configuration store endpoint requested and whether the key-value was modified or deleted. |
152-
| Information | This log level is used for monitoring changes to your app's configuration. Logs include the keys of settings in the configuration that have been updated. |
151+
| Verbose | This log level is used for monitoring changes to key-values in your App Configuration store. Logs include the key and label of key-values updated in the App Configuration store. Depending on the content type, logs may also include the App Configuration store endpoint requested and whether the key-value was modified or deleted. |
152+
| Informational | This log level is used for monitoring changes to your app's configuration. Logs include the keys of settings in the configuration that have been updated. |
153153
| Warning | This log level is used for identifying issues that occurred during refresh. Logs include the exception name and a message containing a brief description of the issue. |
154-
- The logging category is `Microsoft-Extensions-Configuration-AzureAppConfiguration-Refresh`.
154+
- The logging category is `Microsoft-Extensions-Configuration-AzureAppConfiguration-Refresh`, which appears before each log.
155+
- Here is an example `Informational` level log:
156+
```console
157+
[Informational] Microsoft-Extensions-Configuration-AzureAppConfiguration-Refresh:
158+
Setting updated from Key Vault. Key:'ExampleKey'
159+
```
155160

156161
## Clean up resources
157162

0 commit comments

Comments
 (0)