K3S/addons/promtail

Promtail

DaemonSet-агент сбора логов. Запускается на каждой ноде кластера, собирает логи всех подов и отправляет в Loki. Поддерживает pipeline stages для парсинга и обогащения логов.

Быстрый старт

# group_vars/all/addons.yml
addon_promtail: true
addon_loki: true  # требуется Loki

make addon-promtail

Параметры

Переменная	Умолч.	Описание
promtail_loki_url	авто (loki namespace)	URL Loki push endpoint
promtail_tenant_id	""	Tenant ID (если Loki multi-tenant)

Внешний Loki

promtail_loki_url: "http://external-loki.example.com:3100/loki/api/v1/push"

Автоматические labels

Promtail автоматически добавляет labels из метаданных пода:

• namespace — namespace пода
• pod — имя пода
• container — имя контейнера
• node_name — имя ноды
• app — label app пода

Pipeline stages — обработка логов

Promtail поддерживает pipeline stages для парсинга:

JSON логи:

pipelineStages:
  - json:
      expressions:
        level: level
        msg: message
  - labels:
      level:

Regex парсинг:

pipelineStages:
  - regex:
      expression: '(?P<level>INFO|WARN|ERROR|DEBUG)'
  - labels:
      level:

Мультилайн (stack traces):

pipelineStages:
  - multiline:
      firstline: '^\d{4}-\d{2}-\d{2}'
      max_wait_time: 3s

Проверка что Promtail работает

kubectl logs -n promtail daemonset/promtail -f | grep "error\|warn"
kubectl get pods -n promtail -o wide

В Grafana → Explore → Loki → выбери namespace → должны появиться логи.

Официальные ресурсы

• Официальный сайт: https://grafana.com/docs/loki/latest/send-data/promtail/
• Официальная документация: https://grafana.com/docs/loki/latest/send-data/promtail/
• Версии Helm chart / ПО: https://artifacthub.io/packages/helm/grafana/promtail