Loki в Docker

Тема дорожной карты · Loki

Запуск Grafana Loki в Docker — удобный способ быстро поднять локальный стек агрегации логов без установки бинарных файлов непосредственно на хосте. Официальный образ grafana/loki загружается с Docker Hub, а минимальная настройка предусматривает монтирование файла loki-config.yaml в контейнер и открытие порта 3100, чтобы Promtail и Grafana могли взаимодействовать с Loki. Типичная команда docker run выглядит следующим образом: docker run -v $(pwd)/loki-config.yaml:/etc/loki/local-config.yaml -p 3100:3100 grafana/loki. Для развёртываний с несколькими сервисами рекомендуется Docker Compose: Loki, Promtail и Grafana определяются как сервисы в едином файле docker-compose.yml, что позволяет легко поднять полноценный стек наблюдаемости для разработки. При запуске Loki в Docker в продакшене обязательно монтируйте постоянный том для путей хранения чанков и индекса, чтобы данные сохранялись при перезапуске контейнера.

Как это работает

Loki в Docker: установка через static binary, Docker-образ или Helm chart (grafana/loki-stack деплоит Loki + Promtail + Grafana). Конфиг в loki-config.yaml определяет auth, ingestion limits, schema (chunk format + index version), storage backend (filesystem, S3, GCS, MinIO), retention. Для prod — S3-compatible object storage + Helm chart для K8s; для dev или маленьких setups — local binary + filesystem ок. Loki Stack (Helm) — простейший путь к работающей установке.

Когда применять

Для dev/PoC: single-binary mode + filesystem. Для prod: simple-scalable (3-tier) или microservices mode + S3 storage. Всегда выставляйте ingestion rate limits — unbounded ingestion крашит кластер. Pin Loki version + schema version в конфиге — schema migrations нетривиальны.

Типичные ошибки

Ловушки Loki в Docker: filesystem storage в prod (нет репликации, нет horizontal scale); ingestion limits не выставлены (одно приложение DDoS Loki); деплой Loki без monitoring самого Loki (не видите, когда ломается); смешанные версии Loki между компонентами.

Связанные понятия

Полезные ресурсы