logicwind/ecs-fluentbit

Amazon AWS for Fluent Bit 镜像文档

镜像概述

本镜像为AWS官方提供的Fluent Bit容器镜像（amazon/aws-for-fluent-bit），基于轻量级日志处理器Fluent Bit构建，专为在容器环境中高效收集、处理和转发日志数据设计。Fluent Bit是一个开源的日志收集器和转发器，以高性能、低资源占用为特点，适用于云原生和容器化场景。

核心功能与特性

• 轻量级设计：资源占用低，适合在容器环境中部署
• 多日志源支持：可收集容器日志、文件日志、系统日志等多种来源
• AWS服务集成：原生支持将日志转发至Amazon CloudWatch Logs、Amazon S3、Amazon Kinesis等AWS服务
• 丰富的插件生态：提供输入、过滤、输出等多种插件，支持日志处理和格式转换
• 官方维护：由AWS官方维护，确保与AWS服务的兼容性和安全性

使用场景

• 容器化应用日志收集与转发
• Kubernetes集群日志集中管理
• AWS环境中应用日志实时监控与分析
• 跨平台日志聚合至AWS CloudWatch等服务

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name aws-fluent-bit \
  -v /var/log:/var/log \
  -v $(pwd)/fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf \
  amazon/aws-for-fluent-bit

配置文件说明

Fluent Bit通过配置文件定义日志收集规则，典型配置文件（fluent-bit.conf）结构如下：

ini
[SERVICE]
    Flush        5
    Log_Level    info
    Daemon       off
    Parsers_File parsers.conf

[INPUT]
    Name         tail
    Path         /var/log/containers/*.log
    Parser       docker
    Tag          kube.*

[OUTPUT]
    Name         cloudwatch
    Match        *
    region       us-east-1
    log_group_name /aws/container/logs
    log_stream_name {instance_id}

环境变量配置

常用环境变量：

• FLB_LOG_LEVEL：日志级别（debug/info/warn/error），默认info
• AWS_REGION：AWS区域，如us-east-1
• AWS_ACCESS_KEY_ID：AWS访问密钥（如未通过IAM角色配置时使用）
• AWS_SECRET_ACCESS_KEY：AWS密钥（如未通过IAM角色配置时使用）

Docker Compose示例

yaml
version: '3'
services:
  fluent-bit:
    image: amazon/aws-for-fluent-bit
    volumes:
      - /var/log:/var/log
      - ./fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf
    environment:
      - AWS_REGION=us-east-1
    restart: always

更多信息

完整文档和配置示例请参考AWS官方Docker Hub页面：
https://hub.docker.com/r/amazon/aws-for-fluent-bit