Promtail

Promtail是Log传输软体，属于Grafana的Loki生态系。

安装

在Ubuntu上可以透过官方的APT repository安装：

sudo curl -L -o /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key; echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list; sudo apt update; sudo apt install -y promtail; sudo apt clean

设定

先建立状态目录：

sudo mkdir /var/lib/promtail; sudo chown promtail:nogroup /var/lib/promtail

在/etc/promtail/config.yml里面把状态档案放到/var/lib/promtail下：

positions:
  filename: /var/lib/promtail/positions.yaml

另外把Loki预设的位置改成实际的位置：

clients:
  - url: http://loki.example.com:3100/loki/api/v1/push

把本来的/var/log/*log改成更广的/var/log/**/*log：

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

最后要开权限给promtail读，包括adm与root两个group：

sudo usermod -aG adm promtail; sudo usermod -aG root promtail

然后重新启动：

sudo service promtail restart

Cheatsheet

这边需要把loki.example.com改成自己的Loki服务位置：

sudo curl -L -o /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key; echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list; sudo apt update; sudo apt install -y promtail; sudo apt clean; sudo mkdir /var/lib/promtail; sudo chown promtail:nogroup /var/lib/promtail; sudo sed -i -e 's@filename: /tmp/positions.yaml@filename: /var/lib/promtail/positions.yaml@' -e 's@http://localhost@http://loki.example.com@' -e 's@/var/log/\*log@/var/log/**/*log@' /etc/promtail/config.yml; sudo usermod -aG adm promtail; sudo usermod -aG root promtail; sudo service promtail restart

相关连结

• Grafana
• Loki

外部连结

• 官方网站 （英文）