tazamaorg/event-sidecar

tazamaorg/event-sidecar 镜像说明

镜像概述

tazamaorg/event-sidecar是一款Sidecar类型的Docker镜像，专注于日志数据的中转与转发。它能够从关联的处理器实例中读取日志，并通过NATS消息系统将日志可靠地传递到Lumberjack服务，适用于微服务架构下的日志统一收集场景。

核心功能

1. 日志读取：从指定的关联处理器实例中获取日志数据；
2. 消息转发：通过NATS消息队列将日志异步发送至Lumberjack服务；
3. Sidecar协同：以Sidecar模式与主应用容器部署，不侵入主应用逻辑。

使用场景

• 微服务架构中，需要将分散的服务日志统一汇聚到Lumberjack的场景；
• 主应用容器无法直接连接Lumberjack服务时，通过Sidecar实现间接转发；
• 依赖NATS进行日志异步传递，确保日志传输可靠性的系统环境。

配置说明

需通过环境变量配置以下关键参数：

• NATS_URL：NATS服务的连接地址（如 nats://nats-server:4222）；
• LOG_SOURCE：关联处理器的日志源地址（如 http://processor:8080/logs）；
• LUMBERJACK_ENDPOINT：Lumberjack服务的日志接收端点（如 http://lumberjack:9000/ingest）。

部署示例

Docker Run命令

bash
docker run -d --name event-sidecar \
  -e NATS_URL=nats://nats-server:4222 \
  -e LOG_SOURCE=http://processor:8080/logs \
  -e LUMBERJACK_ENDPOINT=http://lumberjack:9000/ingest \
  tazamaorg/event-sidecar

Docker Compose示例

yaml
version: '3.8'
services:
  event-sidecar:
    image: tazamaorg/event-sidecar
    environment:
      - NATS_URL=nats://nats:4222
      - LOG_SOURCE=[***]
      - LUMBERJACK_ENDPOINT=[***]
    depends_on:
      - nats
      - processor
      - lumberjack