檢視 Promtail 的原始碼

'''Promtail'''是Log傳輸軟體，屬於[[Grafana]]的[[Loki]]生態系。

== 安裝 ==

在[[Ubuntu]]上可以透過官方的APT repository安裝：

<syntaxhighlight lang="bash">
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
</syntaxhighlight>

== 設定 ==

先建立狀態目錄：

<syntaxhighlight lang="bash">
sudo mkdir /var/lib/promtail; sudo chown promtail:nogroup /var/lib/promtail
</syntaxhighlight>

在<code>/etc/promtail/config.yml</code>裡面把狀態檔案放到<code>/var/lib/promtail</code>下：

<syntaxhighlight lang="yaml">
positions:
  filename: /var/lib/promtail/positions.yaml
</syntaxhighlight>

另外把[[Loki]]預設的位置改成實際的位置：

<syntaxhighlight lang="yaml">
clients:
  - url: http://loki.example.com:3100/loki/api/v1/push
</syntaxhighlight>

把本來的<code>/var/log/*log</code>改成更廣的<code>/var/log/**/*log</code>：

<syntaxhighlight lang="yaml">
scrape_configs:
- job_name: system
  static_configs:
  - targets:
      - localhost
    labels:
      job: varlogs
      __path__: /var/log/**/*log
</syntaxhighlight>

最後把開權限給promtail讀：

<syntaxhighlight lang="bash">
sudo usermod -aG root promtail; sudo usermod -aG adm promtail
</syntaxhighlight>

然後重新啟動：

<syntaxhighlight lang="bash">
sudo service promtail restart
</syntaxhighlight>

== Cheatsheet ==

這邊需要把<code>loki.example.com</code>改成自己的[[Loki]]服務位置：

<syntaxhighlight lang="bash">
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@' /etc/promtail/config.yml; sudo usermod -aG root promtail; sudo usermod -aG adm promtail; sudo service promtail restart
</syntaxhighlight>

== 相關連結 ==

* [[Grafana]]
* [[Loki]]

== 外部連結 ==

* {{Official|https://grafana.com/docs/loki/latest/clients/promtail/}} {{en}}

[[Category:軟體]]