Готовая инструкция по развёртыванию Loki с Grafana для хранения и поиска логов экономичнее, чем ELK, с описанием конфигураций, запросов LogQL и ретеншна. Ожидаемое время выполнения полного прохода — 60–120 минут.
Статья была полезной?
К концу руководства вы получите работоспособный стек Loki + Grafana для централизованного логирования с Promtail как сборщиком и базовой политикой хранения. Полный рабочий тест занимает около 60–120 минут при стабильном интернет-соединении.
Loki оптимизирован под индексирование метаданных, а не полного текста, что делает хранение логов дешевле по объёму и по IOPS по сравнению с классическим ELK. Loki 2.9 (релиз 2025) поддерживает модульное хранение данных в S3-совместимых бэкендах, сжатие чанков и менеджмент ретеншна, что уменьшает расходы на дисковое пространство и сетевой трафик. Для быстрых обзоров и корелляции с метриками Grafana 10.3 предоставляет интеграцию Explore и серийные дашборды.
Если вы работаете в контейнерных средах и используете Docker или DevOps практики, Loki даёт возможность хранить логи как ссылки на поток, сокращая объём инвертированных индексов и экономя IOPS при больших объёмах записи.
Скриншот интерфейса Grafana с дашбордом Loki
Команда: развёртывание Loki и Grafana с помощью docker-compose. Используем образы: grafana/grafana:10.3.0 (около 250MB), grafana/loki:2.9.0 (около 150MB). Примерный время загрузки образов — 1–3 минуты на стабильном 100 Mbps канале.
# создайте файл docker-compose.yml
cat > docker-compose.yml <<'YAML'
version: '3.8'
services:
loki:
image: grafana/loki:2.9.0
command: -config.file=/etc/loki/local-config.yaml
ports:
- '3100:3100'
volumes:
- ./loki-config.yaml:/etc/loki/local-config.yaml:ro
restart: unless-stopped
mem_limit: 6g
grafana:
image: grafana/grafana:10.3.0
ports:
- '3000:3000'
environment:
- GF_SECURITY_ADMIN_PASSWORD=admin
restart: unless-stopped
mem_limit: 1g
YAML
# запустите стек
docker compose up -dОжидаемый вывод:
$ docker compose up -d
Creating network "loki_default" with the default driver
Creating loki ... done
Creating grafana ... doneТипичная ошибка: порт 3100 или 3000 уже занят.
Error: failed to create listener: bind: address already in useФикс: проверьте занятые порты и освободите их или переназначьте порты в docker-compose.yml.
Команда: установка Promtail 2.9 как контейнера или systemd-сервис для сбора /var/log и docker контейнерных логов. Ниже пример docker-compose секции для Promtail.
# добавьте в docker-compose.yml
promtail:
image: grafana/promtail:2.9.0
volumes:
- /var/log:/var/log:ro
- /etc/promtail:/etc/promtail:ro
- /var/lib/docker/containers:/var/lib/docker/containers:ro
command: -config.file=/etc/promtail/promtail-config.yaml
restart: unless-stopped
mem_limit: 512mПример конфигурации /etc/promtail/promtail-config.yaml:
server:
http_listen_port: 9080
grpc_listen_port: 0
positions:
filename: /tmp/positions.yaml
clients:
- url: http://loki:3100/loki/api/v1/push
scrape_configs:
- job_name: system
static_configs:
- targets:
- localhost
labels:
job: varlogs
__path__: /var/log/**/*.log
- job_name: docker
docker_sd_configs:
- host: unix:///var/run/docker.sock
relabel_configs:
- source_labels: [__meta_docker_container_name]
target_label: containerОжидаемый вывод при старте контейнера Promtail:
level=info ts=2026-03-12T12:34:56.789Z caller=main.go:128 msg="Starting Promtail" version="2.9.0"
level=info ts=2026-03-12T12:34:56.790Z caller=server.go:120 msg="Server listening" http=[::]:9080
level=info ts=2026-03-12T12:34:57.001Z caller=client.go:85 msg="Pushing to" url=http://loki:3100/loki/api/v1/pushТипичная ошибка: Promtail не может достучаться до Loki (connection refused или DNS).
level=error ts=2026-03-12T12:35:00.001Z caller=client.go:150 msg="Pushing to loki failed" err="Post \"http://loki:3100/loki/api/v1/push\": dial tcp: lookup loki: no such host"Фикс: проверьте сетевые алиасы в docker compose (служба должна быть названа loki), или используйте полный URL с IP, например http://127.0.0.1:3100 при локальном подключении. Для Kubernetes убедитесь в правильном Service имени и Namespace.
Скриншот логов Promtail с подключением к Loki
Команда: открытие Grafana Explore по адресу http://<ваш-хост>:3000. Примеры запросов LogQL для поиска и агрегации.
# Пример 1: выбор потоков по метке
{job="varlogs\
Комментарии (0)
Войдите или зарегистрируйтесь, чтобы оставить комментарий
Загрузка комментариев…