Azure托管WebApp无法查看文件系统日志求助

1. 确认日志提供程序已正确注册 #

ASP.NET Core不会默认启用文件日志，必须显式添加服务。检查Program.cs中是否包含文件日志注册代码：

// 使用官方文件日志提供程序（需安装Microsoft.Extensions.Logging.File NuGet包）
builder.Logging.AddFile(options =>
{
    // 必须指向Azure App Service允许写入的/home目录
    options.FileName = Path.Combine(Environment.GetEnvironmentVariable("HOME"), "LogFiles", "Application", "app-{Date}.txt");
    options.LogLevel = LogLevel.Information;
});

如果用的是第三方日志库（如Serilog），需确保配置了正确的文件输出路径：

Log.Logger = new LoggerConfiguration()
    .WriteTo.File(Path.Combine(Environment.GetEnvironmentVariable("HOME"), "LogFiles", "Application", "serilog.log"))
    .CreateLogger();

2. 校验AppSettings.json日志配置 #

确认日志级别和路径配置生效，示例配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    },
    "File": {
      "Path": "/home/LogFiles/Application/app.log",
      "Append": true,
      "LogLevel": {
        "Default": "Information",
        "Microsoft": "Error"
      }
    }
  }
}

注意：绝对路径必须指向/home目录，Azure App Service仅允许该目录下的写入操作。

3. 验证Azure App Service日志设置 #

• 进入Azure门户的App Service后台，依次打开监控 > 日志流
• 确认应用日志文件状态为「开启」，日志级别至少包含你需要的Information或Error
• 检查详细错误日志和失败请求跟踪是否开启（若需捕获错误场景日志）

4. 测试日志代码是否触发 #

在控制器中添加测试日志，手动触发验证：

private readonly ILogger<HomeController> _logger;

public HomeController(ILogger<HomeController> logger)
{
    _logger = logger;
}

public IActionResult Index()
{
    _logger.LogInformation("测试信息日志触发");
    _logger.LogError("测试错误日志触发");
    return View();
}

访问该页面后，立即刷新Kudu的/home/LogFiles/Application/目录，查看是否生成对应文件。

5. 排查日志文件命名与滚动规则 #

如果配置了按日期/大小滚动日志，需确认文件名是否符合规则：

• 比如配置app-{Date}.txt，文件会以app-20240520.txt格式生成，需按当前日期查找
• 若日志文件达到大小限制，可能被归档到子目录，可检查目录下的压缩文件或子文件夹

6. 通过日志流快速定位问题 #

如果Azure门户的日志流中能看到日志输出，但Kudu中找不到文件，说明日志路径配置错误；如果日志流中也无输出，说明日志提供程序未注册或日志级别设置过高。

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