Docker化Rails应用部署AWS ECS，如何开启CloudWatch日志？

一、调整Rails日志输出到标准流 #

CloudWatch日志收集依赖Docker容器的stdout/stderr输出，先让Rails把日志打到标准输出而非本地文件：

• 编辑对应环境的配置文件（比如config/environments/production.rb）：

  config.logger = ActiveSupport::Logger.new(STDOUT)
  config.logger.formatter = proc do |severity, timestamp, progname, msg|
    "#{timestamp} #{severity} #{progname}: #{msg}\n"
  end
  config.log_level = :info # 按需调整日志级别
  

• 用Lograge的话，同步配置输出到标准流：

  config.lograge.enabled = true
  config.lograge.formatter = Lograge::Formatters::Json.new
  config.lograge.logger = ActiveSupport::Logger.new(STDOUT)
  

二、确保Docker镜像日志流正常 #

Dockerfile无需额外日志配置，只要启动命令不把日志重定向到文件即可，比如常规启动命令：

CMD ["bundle", "exec", "puma", "-C", "config/puma.rb"]

（默认puma会输出到stdout，若自定义启动命令，别加> logfile.log这类重定向）

三、配置ECS任务定义的日志驱动 #

这是核心步骤，在ECS任务定义的容器配置里添加日志设置：

• 找到日志配置模块，选择awslogs驱动
• 填写参数：
  • awslogs-group: 自定义CloudWatch日志组名（如/ecs/your-rails-app，不存在会自动创建）
  • awslogs-region: ECS集群所在区域（如us-east-1）
  • awslogs-stream-prefix: 日志流前缀，推荐用ecs，生成的日志流会带任务/容器标识，方便排查
  • awslogs-create-group: 设为true，允许自动创建日志组

容器日志配置JSON片段 #

"logConfiguration": {
  "logDriver": "awslogs",
  "options": {
    "awslogs-group": "/ecs/your-rails-app",
    "awslogs-region": "us-east-1",
    "awslogs-stream-prefix": "ecs",
    "awslogs-create-group": "true"
  }
}

四、配置ECS任务执行角色权限 #

确保ECS任务执行角色有推送日志到CloudWatch的权限：

• 直接给角色附加AmazonECSTaskExecutionRolePolicy管理策略（该策略已包含所需的CloudWatch日志权限）
• 若要自定义权限，至少包含以下内容：

  {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "logs:CreateLogStream",
          "logs:PutLogEvents",
          "logs:CreateLogGroup"
        ],
        "Resource": "arn:aws:logs:*:*:*"
      }
    ]
  }
  

五、验证配置效果 #

• 更新ECS服务或启动新任务，完成部署
• 登录AWS控制台，进入CloudWatch -> 日志组，找到你设置的日志组，检查是否有日志流生成并能看到Rails应用日志
• 若没有日志，排查方向：
  • 任务执行角色权限是否正确
  • 任务定义的日志配置参数（区域、日志组名）是否匹配
  • 本地启动容器用docker logs验证Rails是否确实输出日志到stdout

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