promtail 安装(2026.2后不推荐)

备注：
2026.02以后官方不再推荐使用，最新版本3.6.11，后续不再跟随loki发布
建议使用 Alloy

1、使用 docker 安装

# 拉取镜像
docker pull grafana/promtail

# 创建目录
mkdir -p /data/promtail/conf

编辑配置

vi /data/promtail/conf/config.yml
server:
  http_listen_port: 9080
  grpc_listen_port: 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

  - job_name: docker
    static_configs:
    - targets:
        - localhost
      labels:
        job: docker
        __path__: /var/lib/docker/containers/*/*.log

运行容器

docker run -d --name promtail \
  -v /var/log:/var/log:ro \
  -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
  -v /data/promtail/conf:/etc/promtail \
  grafana/promtail -config.file=/etc/promtail/config.yml

2. 下载安装

# 目前最新版本3.6.11
# 下载并解压
cd /tmp
wget https://github.com/grafana/loki/releases/download/v3.6.11/promtail-linux-amd64.zip
unzip promtail-linux-amd64.zip

# 移动到系统路径
sudo mv promtail-linux-amd64 /usr/local/bin/promtail
sudo chmod +x /usr/local/bin/promtail

# 验证版本
promtail --version

创建 systemd 服务（可选）

sudo mkdir -p /data/promtail

# 将你的 promtail 配置文件放入 /data/promtail/conf/config.yml

sudo tee /etc/systemd/system/promtail.service <<EOF
[Unit]
Description=Promtail log agent
After=network.target

[Service]
ExecStart=/usr/local/bin/promtail -config.file /data/promtail/conf/config.yml
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now promtail

3. 使用 linux 源安装（不再发行，新版不再有效）

3.1 安装数据源

Debian

mkdir -p /etc/apt/keyrings/
wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor > /etc/apt/keyrings/grafana.gpg
echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | tee /etc/apt/sources.list.d/grafana.list

yum/dnf

vi /etc/yum.repos.d/grafana.repo

[grafana]
name=grafana
baseurl=https://rpm.grafana.com
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://rpm.grafana.com/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt

yum/dnf (beta versions)

vi /etc/yum.repos.d/grafana.repo

[grafana]
name=grafana
baseurl=https://rpm-beta.grafana.com
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://rpm-beta.grafana.com/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt

参考：https://rpm.grafana.com/

3.2 安装 promtail

示例配置 https://raw.githubusercontent.com/grafana/loki/main/clients/cmd/promtail/promtail-local-config.yaml

安装

dnf install promtail
# 或
yum install promtail
#
apt-get install promtail

启动 和 开机运行

systemd start promtail && systemd enable promtail

配置文件路径/etc/promtail/config.yml