betterstack/aws-ecs-fluent-bit

镜像文档：AWS ECS日志发送至Better Stack

镜像概述

本镜像基于amazon/aws-for-fluent-bit构建，提供通过Fluent Bit和FireLens从AWS ECS（Elastic Container Service）环境向Better Stack日志管理平台发送日志的解决方案，简化AWS容器环境中日志的收集与转发流程。

核心功能与特性

• 基于官方镜像：构建于AWS官方Fluent Bit镜像amazon/aws-for-fluent-bit，确保与AWS ECS环境的兼容性和稳定性
• 集成FireLens：原生支持AWS FireLens日志路由功能，无需额外配置即可实现容器日志的采集与转发
• 日志转发能力：专门优化用于将AWS ECS任务日志高效传输至Better Stack平台，实现日志集中管理

使用场景

适用于在AWS ECS集群中部署的应用，需要将容器日志统一收集并发送至Better Stack进行存储、分析与监控的场景，尤其适合需要简化日志架构、减少手动配置的AWS容器环境。

使用方法与配置说明

前置条件

• 已注册Better Stack账户并获取有效的API密钥
• AWS ECS集群已正常运行，具备任务定义管理权限
• 熟悉AWS FireLens日志驱动配置方法

配置步骤

1. 获取Better Stack API密钥

登录Better Stack控制台，创建日志源并获取对应的API密钥，用于授权日志发送。

2. 配置ECS任务定义

在AWS ECS任务定义中，添加FireLens日志路由容器，指定本镜像作为日志处理器，并配置Better Stack连接参数。

3. 示例任务定义配置（JSON片段）

json
{
  "containerDefinitions": [
    {
      "name": "firelens-log-router",
      "image": "镜像名称",  // 替换为实际镜像名称
      "essential": true,
      "firelensConfiguration": {
        "type": "fluentbit",
        "options": {
          "enable-ecs-log-metadata": "true",
          "config-file-type": "file",
          "config-file-value": "/fluent-bit/configs/custom.conf"
        }
      },
      "environment": [
        {
          "name": "BETTER_STACK_API_KEY",
          "value": "your-better-stack-api-key"  // 替换为实际API密钥
        }
      ],
      "logConfiguration": {
        "logDriver": "awslogs",
        "options": {
          "awslogs-group": "/ecs/firelens-router",
          "awslogs-region": "us-east-1",  // 替换为实际AWS区域
          "awslogs-stream-prefix": "ecs"
        }
      }
    },
    {
      "name": "application-container",  // 应用容器
      "image": "your-application-image",
      "logConfiguration": {
        "logDriver": "awsfirelens",
        "options": {
          "Name": "betterstack",
          "Match": "*"
        }
      }
    }
  ]
}

4. 部署与验证

部署配置好的任务定义至AWS ECS集群，启动任务后，日志将通过FireLens和Fluent Bit自动发送至Better Stack。可在Better Stack控制台验证日志接收状态。

注意事项

• 确保AWS ECS任务执行角色具备访问FireLens配置和日志发送的权限
• 根据实际需求调整Fluent Bit配置（如日志格式、过滤规则等）
• 替换示例中的占位符（镜像名称、API密钥、AWS区域等）为实际值