flownative/promtail

镜像概述

本Docker镜像提供Promtail日志收集器，Promtail是Grafana Loki日志聚合系统的专用日志收集代理。该镜像设计用于Beach环境及其他需要集中式日志收集的场景，能够高效收集容器或系统日志，并将其发送至Loki进行存储和分析。

核心功能与特性

• 日志收集：支持收集容器日志、系统日志及自定义路径日志
• 标签管理：可对日志添加自定义标签，便于日志过滤和查询
• Loki集成：原生支持与Grafana Loki通信，实现日志高效转发
• 轻量级设计：基于精简基础镜像，资源占用低，适合容器化部署
• 配置灵活：支持通过配置文件自定义日志收集规则、目标Loki地址等参数

使用场景与适用范围

• Beach环境：专为Beach平台设计，满足其日志收集需求
• 容器化应用：适用于Docker、Kubernetes等容器环境的日志收集
• 微服务架构：支持多服务实例日志聚合，简化分布式系统日志管理
• Loki生态：作为Loki日志系统的前端收集组件，构建完整日志解决方案

使用方法与配置说明### 基本部署（docker run）

bash
docker run -d \
  --name promtail \
  -v /var/log:/var/log \  # 挂载主机日志目录（根据实际需求调整）
  -v /path/to/promtail-config.yaml:/etc/promtail/config.yaml \  # 挂载Promtail配置文件
  --network=host \  # 如需访问主机网络上的Loki服务
  [镜像名称]:[标签]

Docker Compose配置示例

yaml
version: '3'
services:
  promtail:
    image: [镜像名称]:[标签]
    container_name: promtail
    volumes:
      - /var/log:/var/log
      - ./promtail-config.yaml:/etc/promtail/config.yaml
    restart: always
    # 如需与Loki容器通信，可加入同一网络
    networks:
      - loki-network

networks:
  loki-network:

配置文件说明

Promtail的核心配置通过promtail-config.yaml文件定义，关键配置项包括：

• server: Promtail服务配置（如监听端口）
• positions: 日志读取位置记录文件路径
• clients: Loki服务地址及认证信息
• scrape_configs: 日志收集规则，定义日志源、标签及处理方式

示例配置片段（promtail-config.yaml）：

yaml
server:
  http_listen_port: 9080
  grpc_listen_port: 0

positions:
  filename: /tmp/positions.yaml

clients:
  - url: http://loki:3100/loki/api/v1/push

scrape_configs:
  - job_name: system
    static_configs:
      - targets:
          - localhost
        labels:
          job: varlogs
          __path__: /var/log/*.log

注意事项

• 确保挂载的日志目录对容器有读取权限
• 配置文件中的Loki地址需根据实际部署环境调整（如使用容器网络时需指定Loki容器名称或IP）
• 对于Kubernetes环境，建议结合DaemonSet部署以确保每个节点均运行Promtail实例