Promtail 介绍

Promtail 负责发现并推送日志到 Loki Server

介绍

主要功能：

• 发现日志源 target，当前 promtail 支持跟踪的日志源有本地日志文件和 systemd 日志
  • 类似 Prometheus 的服务发现机制，支持 static、file、consul、docker 和 kubernetes 等
  • promtail 通过 -config.file 选项加载配置文件
  • 通过 scrape_configs 字段配置
• 将标签附加到日志流
• 将日志推送至 Loki Server

配置

• promtail-local-config.yaml

---
server:  # 监听端口
  http_listen_port: 9080
  grpc_listen_port: 0

positions:  # 用于保存 Promtail 在日志文件已经加载完成的位置，用于在重启启动时识别到中断点
  filename: /tmp/positions.yaml

clients:  # 配置推送的 Loki Server 的地址，支持多个
  - url: http://gateway:3100/loki/api/v1/push
    tenant_id: tenant1

scrape_configs:  # 配置如何发现目标并抓取
  - job_name: flog_scrape  # 作业名称
    docker_sd_configs:
      - host: unix:///var/run/docker.sock
        refresh_interval: 5s
    relabel_configs:
      - source_labels: ['__meta_docker_container_name']
        regex: '/(.*)'
        target_label: 'container'

• scrape_configs 支持的参数参考，类似于 filebeat 或 logstash 的配置
  • file_sd_config 基于文件的服务发现
  • docker_sd_configs
  • kubernetes_sd_config
  • consul_sd_config
• pipeline_stages 用于转换日志条目及其标签
  • json
  • regexp
  • labels
  • replace
• relabel_configs 在抓取目标之前，重写其标签集
  • replace
  • keep
  • drop
  • labelmap
  • labeldrop
  • labelkeep