Files
buryan-infra/ops/monitoring/LOKI-HOWTO.md
T

3.0 KiB

Сбор журналов (Loki) — как это работает

Что сделано 16.10.2026

Loki:      CT 113, порт 3100, хранение 30 дней
Promtail:  CT 113, собирает журналы контейнеров
Grafana:   подключены источники Loki и Prometheus

Зачем

Было: чтобы найти причину сбоя, надо обойти 29 контейнеров. Стало: один поиск в Grafana по всем журналам сразу.

Как устроено

контейнеры → Promtail (сборщик) → Loki (хранилище) → Grafana (поиск)

Важная особенность

Плагин docker compose в этой версии слишком новый для Docker 20.10.24:

Error: client version 1.53 is too new.
       Maximum supported API version is 1.41

Поэтому контейнеры запускаются напрямую (docker run), без compose-файла. При обновлении compose-файл заработает.

Настройки

Что Где
Настройка Loki /opt/loki/config/loki-config.yml
Настройка сборщика /opt/loki/promtail/promtail-config.yml
Данные /opt/loki/data

Хранение: 30 дней (retention_period: 720h) Место: ~89 ГБ свободно в CT 113

Запуск и остановка

# Запуск
pct exec 113 -- docker run -d --name loki --restart unless-stopped \
    --user root -p 3100:3100 \
    -v /opt/loki/config/loki-config.yml:/etc/loki/local-config.yaml:ro \
    -v /opt/loki/data:/loki \
    grafana/loki:3.2.1 -config.file=/etc/loki/local-config.yaml

pct exec 113 -- docker run -d --name promtail --restart unless-stopped \
    --user root --network host \
    -v /opt/loki/promtail/promtail-config.yml:/etc/promtail/config.yml:ro \
    -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    grafana/promtail:3.2.1 -config.file=/etc/promtail/config.yml

# Проверка
curl -s http://192.168.1.113:3100/ready
curl -s "http://192.168.1.113:3100/loki/api/v1/label/container/values"

Поиск в Grafana

1. Открыть Grafana → Explore
2. Выбрать источник Loki
3. Запрос: {container="имя_контейнера"}
   или:    {job="docker"} |= "ошибка"

Что дальше

Сборщик видит только журналы своей машины (CT 113).

Для сбора со ВСЕХ 29 машин нужно:

  • поставить сборщик в каждую машину (проще, но 29 экземпляров);
  • либо настроить общий приём и направить журналы туда.

Проще всего: поставить сборщик в каждую машину с Docker — их 27. Настройка одна и та же, меняется только адрес Loki.