Files

Sergey Antropoff eccc1c2a01 docs: полная документация проекта — docs/ и README.md для каждого аддона

- README.md: перепиcан как компактный обзор (98 строк) с навигацией по docs/
- docs/: 13 файлов — getting-started, architecture, configuration, addons,
  storage, security, cicd, observability, networking, operations,
  make-reference, molecule-testing, troubleshooting
- addons/*/README.md: 31 новый файл — описание, параметры, примеры кода
  для каждого из 34 аддонов (vault и external-secrets уже существовали)

2026-04-26 00:22:06 +03:00

1.9 KiB

Raw Blame History

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 → должны появиться логи.

1.9 KiB Raw Blame History Unescape Escape