stackgres/distributedlogs-controller

StackGres分布式日志服务本地控制器镜像

镜像概述和主要用途

该镜像为StackGres.io分布式日志服务的核心组件，作为本地节点级控制器，负责协调日志数据的收集、预处理和转发流程。它与StackGres集群控制平面及分布式日志系统交互，确保本地节点日志任务的高效执行，是构建分布式环境下集中式日志管理架构的关键组件。

核心功能和特性

• 本地日志协调：管理节点内日志收集进程，调度日志数据的本地处理与转发任务。
• 分布式集成：与StackGres控制平面及集群级日志服务通信，确保日志数据在分布式环境中的一致性。
• 资源动态调整：根据节点资源负载自动优化日志处理任务，避免资源过度占用。
• 故障自愈：支持节点级故障检测与自动恢复，保障日志服务连续性。
• 配置灵活性：通过环境变量和配置文件自定义日志处理策略、转发目标及资源限制。

使用场景和适用范围

• StackGres PostgreSQL集群：适用于部署了StackGres分布式PostgreSQL集群的环境，需集中管理多节点数据库日志。
• 分布式日志集中化：在多节点集群中，需将分散的日志数据汇总、分析和存储的场景。
• 集群监控与排障：为数据库集群的日常监控、性能分析及故障排查提供日志数据支撑。

使用方法和配置说明

基本部署示例（docker run）

bash
docker run -d \
  --name stackgres-log-local-controller \
  --network stackgres-cluster-net \
  -e STACKGRES_CONTROL_PLANE_URL=http://stackgres-control-plane:8080 \
  -e NODE_NAME=postgres-node-01 \
  -e LOG_LEVEL=info \
  -e LOG_FORWARD_DESTINATION=http://log-aggregator:9000 \
  -v /var/log/stackgres:/var/log/stackgres \
  -v /etc/stackgres/log-controller:/etc/stackgres/log-controller:ro \
  stackgres/log-local-controller:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  log-local-controller:
    image: stackgres/log-local-controller:latest
    container_name: stackgres-log-local-controller
    networks:
      - stackgres-network
    environment:
      - STACKGRES_CONTROL_PLANE_URL=http://stackgres-control-plane:8080
      - NODE_NAME=${HOSTNAME}
      - LOG_LEVEL=info
      - RESOURCE_LIMIT_CPU=1
      - RESOURCE_LIMIT_MEMORY=512Mi
      - LOG_FORWARD_DESTINATION=http://log-aggregator:9000
    volumes:
      - /var/log/stackgres:/var/log/stackgres:rw
      - /etc/stackgres/log-controller:/etc/stackgres/log-controller:ro
    restart: unless-stopped

networks:
  stackgres-network:
    external: true

环境变量配置说明

挂载卷说明

• /var/log/stackgres：本地日志存储目录，需挂载主机目录以持久化日志数据。
• /etc/stackgres/log-controller：配置文件目录，挂载包含自定义策略的主机目录（只读）。

注意事项

• 需与StackGres集群控制平面及分布式日志服务组件配合使用，单独部署无法正常工作。
• 确保容器网络与StackGres控制平面及其他集群组件互通。
• 根据节点资源实际情况调整RESOURCE_LIMIT_CPU和RESOURCE_LIMIT_MEMORY参数，避免资源竞争。