运行在AWS ECS上的.NET Core应用为何无法输出自定义日志到CloudWatch

1. 优先排查日志过滤规则覆盖问题 #

Host.CreateDefaultBuilder默认会加载appsettings.json、环境变量等配置源的日志配置，优先级高于你在代码中设置的全局最低日志级别。检查你的配置文件中是否存在如下配置，限制了日志输出级别：

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning", // 此处如果设置为Warning及以上，Information级别的自定义日志会被直接过滤
      "Microsoft": "Warning",
      "System": "Warning"
    }
  }
}

你可以显式为AWS日志提供器设置独立的过滤规则，避免被全局配置覆盖：

.ConfigureLogging(o =>
{
    // 可选：清除默认的控制台、调试提供器，避免重复输出
    o.ClearProviders();
    o.AddAWSProvider(options => 
    {
        options.LogLevel = LogLevel.Information;
        // 显式指定日志组和区域，避免依赖配置源加载失败
        options.LogGroup = "你的CloudWatch日志组名称";
        options.Region = Amazon.RegionEndpoint.你部署的区域;
    });
    o.SetMinimumLevel(LogLevel.Debug);
})

2. 检查AWS日志提供器必填配置 #

你当前代码直接调用无参数的AddAWSProvider()，默认会从配置源读取AWS.Logging节点的配置，如果你没有在ECS任务的环境变量、配置文件中配置以下必填项，提供器会直接失效不输出日志：

• 日志组名称（LogGroup）
• 部署区域（Region）
  建议直接在代码中显式传入配置，避免配置加载失败的问题。

3. 验证ECS任务执行角色权限 #

即使你Task Definition配置了awslogs驱动，如果你使用AWS SDK直接上报日志，需要确保ECS任务绑定的任务执行角色包含以下权限：

{
  "Effect": "Allow",
  "Action": [
    "logs:CreateLogStream",
    "logs:PutLogEvents",
    "logs:CreateLogGroup" // 可选，如果日志组需要自动创建
  ],
  "Resource": "arn:aws:logs:*:*:log-group:你的日志组名称:*"
}

如果缺少以上权限，AWS日志提供器会静默失败，不会抛出异常，也不会输出日志。

4. 排查日志采集方式混淆问题 #

如果你本来打算用ECS自带的awslogs驱动收集容器的标准输出/标准错误（stdout/stderr），不需要额外安装AWS日志提供器，只需要保留.NET默认的控制台日志提供器，应用日志输出到控制台后会自动被awslogs驱动采集到CloudWatch。这种方式更简单，不需要额外配置权限和SDK，排查起来也更方便，可以直接进入运行中的ECS容器查看控制台输出是否有自定义日志。

5. 验证NuGet包版本兼容性 #

确认你安装的AWS.Logger.AspNetCore/AWS.Logger.CoreNuGet包版本兼容.NET Core 3.1，建议使用2.x系列的版本，3.x及以上版本仅支持.NET 6+，会出现不兼容导致日志输出失败的问题。

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