vectorming/promtail

Promtail Docker镜像文档

镜像概述和主要用途

Promtail是Grafana Loki日志收集系统的核心组件，作为轻量级日志收集代理，负责从目标系统中实时跟踪日志文件新增内容，对日志进行标签化处理后，将其推送到Loki进行集中存储与分析。适用于容器环境、服务器节点及分布式系统的日志采集场景。

核心功能和特性

• 实时日志跟踪：支持对日志文件进行尾部监控，实时捕获新增日志内容
• 多源日志采集：兼容容器日志、系统日志、应用程序日志等多种日志来源
• 原生Loki集成：与Loki日志系统无缝对接，确保日志高效推送与存储
• 灵活标签管理：支持为日志添加自定义标签，优化日志查询与过滤能力
• 轻量级设计：资源占用低，可在各类环境（物理机、容器、K8s）中高效部署

使用场景和适用范围

• 容器化应用日志采集（如Kubernetes集群Pod日志）
• 服务器节点系统日志集中监控
• 微服务架构下分布式日志统一管理
• 需要将日志数据发送至Loki进行存储和分析的场景

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name promtail \
  -v /var/log:/var/log \  # 挂载宿主机日志目录
  -v /path/to/promtail-config.yaml:/etc/promtail/config.yaml \  # 挂载配置文件
  grafana/promtail:latest \
  -config.file=/etc/promtail/config.yaml  # 指定配置文件路径

配置文件说明

Promtail通过YAML配置文件定义日志采集规则，典型配置示例（promtail-config.yaml）：

yaml
server:
  http_listen_port: 9080  # HTTP监听端口
  grpc_listen_port: 0     # gRPC监听端口（0表示禁用）

positions:
  filename: /tmp/positions.yaml  # 记录日志读取位置的文件路径（用于断点续传）

clients:
  - url: http://loki:3100/loki/api/v1/push  # Loki服务地址

scrape_configs:
  - job_name: system  # 采集任务名称
    static_configs:
      - targets:
          - localhost  # 目标主机
        labels:
          job: varlogs  # 自定义标签
          __path__: /var/log/*log  # 日志文件路径匹配规则

关键配置参数

• server：配置Promtail服务监听端口
• positions：记录日志文件读取偏移量，确保服务重启后从断点继续采集
• clients：配置Loki服务地址及连接参数
• scrape_configs：定义日志采集规则，包括目标主机、标签及日志路径

Docker Compose部署示例

yaml
version: '3'
services:
  promtail:
    image: grafana/promtail:latest
    volumes:
      - /var/log:/var/log  # 挂载宿主机日志目录
      - ./promtail-config.yaml:/etc/promtail/config.yaml  # 挂载本地配置文件
    command: -config.file=/etc/promtail/config.yaml
    depends_on:
      - loki  # 依赖Loki服务
    restart: always  # 自动重启策略

  loki:
    image: grafana/loki:latest
    ports:
      - "3100:3100"  # Loki服务端口映射
    volumes:
      - ./loki-config.yaml:/etc/loki/config.yaml  # Loki配置文件
    command: -config.file=/etc/loki/config.yaml