如何为.NET应用的Azure App Configuration启用日志并加快启动速度？

要查看连接、重连等操作的日志，只需调整应用的日志配置，开启Microsoft.Extensions.Configuration.AzureAppConfiguration命名空间的日志输出即可。如果涉及身份验证相关的日志（比如DefaultAzureCredential的验证流程），也可以同时开启Azure.Identity的日志。

在appsettings.json中添加以下日志配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft.Extensions.Configuration.AzureAppConfiguration": "Debug",
      "Azure.Identity": "Information"
    }
  }
}

• 设置Microsoft.Extensions.Configuration.AzureAppConfiguration为Debug级别可输出连接、加载、刷新等详细过程日志；
• Azure.Identity设为Information可排查身份验证环节的耗时问题。

可以通过两种核心方式实现配置缓存，避免每次重启都等待10秒加载远程配置：

方式1：启用Azure App Configuration本地缓存 #

在配置Azure App Configuration时，通过SetCacheExpiration设置缓存过期时间，结合刷新策略让应用启动时优先使用本地缓存，后台异步同步最新配置。修改你的代码如下：

using Azure.Identity;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

namespace Api.Azure;

public static class AzureAppConfiguration
{
    public static WebApplicationBuilder AddAzureAppConfiguration(this WebApplicationBuilder builder)
    {
        ArgumentNullException.ThrowIfNull(builder);

        var endpoint = builder.Configuration["Azure:AppConfiguration:Endpoint"];
        if (string.IsNullOrEmpty(endpoint))
        {
            // Azure App Configuration endpoint is not set, using local configuration...
            return builder;
        }

        builder.Configuration.AddAzureAppConfiguration(options =>
        {
            options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                .Select(KeyFilter.Any)
                .ConfigureKeyVault(vaultOptions => vaultOptions.SetCredential(new DefaultAzureCredential()))
                // 启用本地缓存，设置缓存过期时间（示例为1小时）
                .SetCacheExpiration(new TimeSpan(1, 0, 0))
                // 配置刷新策略，后台自动同步最新配置
                .ConfigureRefresh(refreshOptions =>
                {
                    refreshOptions.Register("AppSettings:Version", refreshAll: true)
                        .SetCacheExpiration(new TimeSpan(0, 5, 0));
                });
        });

        // 启用配置刷新后台服务
        builder.Services.AddAzureAppConfiguration();

        return builder;
    }
}

• SetCacheExpiration设置本地缓存的过期时间，启动时优先读取缓存（如果存在）；
• ConfigureRefresh配置刷新触发器，当指定键（如AppSettings:Version）更新时，后台自动刷新配置，无需重启应用。

方式2：使用离线快照（本地备份） #

如果希望完全避免启动时的远程调用，可以将Azure App Configuration的配置导出为本地文件（如appsettings.azure.json），启动时先加载本地文件，再后台同步远程配置：

1. 通过Azure CLI或门户手动导出配置到本地文件；
2. 修改代码，先加载本地快照，再添加远程配置：

builder.Configuration
    .AddJsonFile("appsettings.azure.json", optional: true, reloadOnChange: true)
    .AddAzureAppConfiguration(options =>
    {
        options.Connect(new Uri(endpoint), new DefaultAzureCredential())
            .Select(KeyFilter.Any)
            .ConfigureKeyVault(vaultOptions => vaultOptions.SetCredential(new DefaultAzureCredential()))
            .ConfigureRefresh(refreshOptions =>
            {
                refreshOptions.Register("AppSettings:Version", refreshAll: true)
                    .SetCacheExpiration(new TimeSpan(0, 5, 0));
            });
    });

这种方式下，应用启动时直接读取本地文件，几乎无延迟，后台再异步同步最新的远程配置。

内容的提问来源于stack exchange，提问作者nop