91dave/filebeat-es

91dave/filebeat-es镜像说明

镜像概述

该Docker镜像用于部署FileBeat，支持直接将日志文件发送到Elastic Search（无需经过LogStash）。其设计理念是通过docker-compose完成服务器配置，无需修改本地文件系统，与nginx-basic-proxy镜像的配置思路一致。

核心功能

1. 直接向Elastic Search索引日志，跳过LogStash环节
2. 完全通过环境变量配置，无需手动编辑配置文件
3. 支持自定义日志字段，增强日志分类与检索能力

使用场景

• 需要简化日志收集流程，避免部署LogStash的场景
• 通过docker-compose统一管理服务，希望日志收集组件无文件系统依赖的环境
• 需为日志添加自定义标签（如应用名称、环境标识）的场景

配置说明

所有配置通过环境变量实现：

• FB_PATH：需监控的日志文件路径表达式，支持通配符（不支持多路径）
• ES_LOG_URL：Elastic Search服务地址（示例：http://elastic-search:9200）
• ES_LOG_INDEX：日志索引名称（示例：logs-+{%yyyy.%MM.%dd}）
• FB_Field_*：自定义字段前缀，如FB_Field_application=Front-End会添加application字段

部署示例

Docker Run命令

bash
docker run \
  -e FB_PATH="/var/log/*.log" \
  -e ES_LOG_URL="http://es-server:9200" \
  -e ES_LOG_INDEX="logs-%{+yyyy.MM.dd}" \
  -e FB_Field_application=API \
  -e FB_Field_environment=Production \
  -v /host/log/path:/var/log \
  91dave/filebeat-es

Docker Compose配置

yaml
services:
  filebeat:
    image: 91dave/filebeat-es
    environment:
      FB_PATH: "/var/log/app/*.log"
      ES_LOG_URL: "[***]"
      ES_LOG_INDEX: "app-logs-%{+yyyy.MM.dd}"
      FB_Field_service: "user-service"
      FB_Field_env: "staging"
    volumes:
      - ./app/logs:/var/log/app
    depends_on:
      - elasticsearch