aptible/joecool-v2

镜像概述

该镜像是一个轻量级日志转发代理，专门用于收集Docker容器产生的日志，并将其实时转发到指定的Redis实例。通过监听Docker容器的日志输出，它能够无缝集成到Docker环境中，为日志集中存储和后续处理（如分析、监控）提供可靠的传输通道。

核心功能和特性

• 实时日志捕获：实时收集Docker容器的标准输出（stdout）和标准错误（stderr）日志
• Redis集成：支持将日志数据发送到Redis实例，可配置存储键名和数据库
• 轻量级设计：镜像体积小巧，资源占用低，适合在各类Docker环境中部署
• 灵活配置：通过环境变量自定义Redis连接参数、日志格式和容器过滤规则
• Docker原生支持：通过访问Docker守护进程套接字（docker.sock）实现对容器日志的监听

使用场景

• 需要将Docker容器日志集中存储到Redis的环境
• 构建基于Redis的日志分析或实时监控系统
• 容器化应用的日志聚合与转发需求
• 需要对容器日志进行持久化存储和后续处理的场景

使用方法

基本部署（docker run）

bash
docker run -d \
  --name docker-log-redis-agent \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e REDIS_HOST=redis-server \
  -e REDIS_PORT=6379 \
  -e REDIS_DB=0 \
  -e LOG_FORMAT=json \
  -e REDIS_KEY=docker_logs \
  your-image-name:latest

参数说明：

• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程套接字，使代理能够访问容器日志
• --restart always：配置容器异常退出后自动重启

Docker Compose配置

yaml
version: '3'
services:
  log-agent:
    image: your-image-name:latest
    container_name: docker-log-redis-agent
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - REDIS_DB=0
      - LOG_FORMAT=json
      - REDIS_KEY=docker_logs
      - REDIS_PASSWORD=your-redis-password
    depends_on:
      - redis

  redis:
    image: redis:alpine
    container_name: redis-server
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data

volumes:
  redis-data:

配置参数说明