Provision
—— XP

Loki: журналы в одном месте

теория~6 минут+200 XP

Любая программа по ходу работы рассказывает о себе строчками: принят запрос, ответ отдан, база не ответила. Эти строчки и есть журнал, или по-простому лог. Loki сгребает такие строки со всех контейнеров и машин в одно место, чтобы искать по ним, не заходя на каждый сервер. Его сделали в Grafana Labs в 2018 году, и авторы сами называют его «Prometheus для логов»: те же метки, похожий язык запросов и тот же интерфейс — Grafana, которую ты поставил в разделе про мониторинг. Loki стоит у множества компаний, которым нужен поиск по журналам без больших затрат на железо. Чего он не делает: не собирает строки сам, не строит индекс по каждому слову и не рисует графики — для этого рядом есть сборщик и Grafana.

Метрики из прошлого раздела — это приборы у койки больного: пульс, давление, по ним сразу видно, что ему плохо. Журнал — это записи в карте: что делали, когда и с каким результатом. По приборам не понять, почему поднялась температура; по карте не следят за состоянием каждую минуту.

Loki решает задачу «карты в одном шкафу»: метрика показала всплеск ошибок, а за текстом этих ошибок не нужно ходить по серверам.

Зачем собирать журналы в одно место

Пока стенд один, хватает docker compose logs: команда показывает вывод контейнеров, и по нему можно искать grep. Это быстро ломается по трём причинам.

Первая — журнал живёт вместе с контейнером. Docker хранит его рядом с контейнером, и после docker compose down или пересоздания при выкате старый журнал пропадает. Контейнер, упавший ночью и пересозданный, утром ничего не расскажет.

Вторая — машин становится больше одной. Заходить по SSH на пять серверов и искать на каждом — это те самые полчаса, которых во время аварии нет.

Третья — сопоставить строки разных служб. Запрос прошёл через nginx, приложение и базу; чтобы понять, где он застрял, нужны строки всех трёх в одном окне, по одному времени.

Систем, которые решают эту задачу, много. Различаются они главным: как ищут.

Loki и Elasticsearch

Старый и самый известный ответ — Elasticsearch, обычно в связке ELK: Elasticsearch хранит, Logstash собирает, Kibana показывает. Он строит поисковый индекс по каждому слову каждой строки, как поисковик по интернету. Поиск по любому слову мгновенный, но индекс бывает больше самих данных, и памяти ему нужно от восьми гигабайт.

Loki заходит с другой стороны. Он индексирует только метки — короткие пары «имя — значение» вроде container="web" или level="error", — а сами строки складывает сжатыми рядом. Поиск поэтому идёт в два шага: метками сузить выборку до одного сервиса и часа, а дальше честно перебрать строки этой выборки. Памяти ему хватает гигабайта.

Отсюда и правило: Loki хорош, когда известно, где искать — «что писал сервис web в 14:30». Для эксплуатации это почти всегда так. Elasticsearch нужен, когда ищут вслепую — например, одну транзакцию за полгода по всему массиву.

Из того, что Loki индексирует метки, следует главная ловушка работы с ним.

Метки и поток

Каждое уникальное сочетание меток Loki хранит отдельно и называет потоком. Строки от {container="web", level="error"} — один поток, от {container="web", level="info"} — другой. У каждого потока свои файлы и своя запись в индексе.

Потому метки выбирают так же, как в Prometheus: только то, у чего мало значений, известных заранее. Имя контейнера, сервис, окружение, уровень — хорошие метки, их единицы и десятки. Идентификатор запроса, адрес клиента, номер пользователя — яд: тысяча запросов дадут тысячу потоков, а миллион положит хранилище. Такие значения остаются в тексте строки, и их находят фильтром.

Проверка простая: если значения метки нельзя перечислить на листе бумаги, это не метка.

Осталось понять, кто вообще кладёт строки в Loki.

Как строки попадают в Loki

Приложение в контейнере ничего не знает о Loki. Оно пишет строки в стандартный вывод — тот самый, который показывает docker compose logs. Дальше их забирает сборщик: программа, которая спрашивает у Docker список контейнеров, читает их вывод, приклеивает метки и отправляет в Loki.

  приложение ─► stdout ─► Docker ─► Grafana Alloy ─► Loki ─► Grafana
                                    (сборщик)       (хранит) (показывает)

Такая схема хороша тем, что приложение не зависит от хранилища: Loki лёг — приложение работает дальше, поменяли сборщик — код не трогали.

Родной сборщик для Loki сегодня — Grafana Alloy. В статьях до 2026 года рядом с Loki почти всегда стоит другой агент, Promtail: его сняли с поддержки 2 марта 2026 года, обновлений и исправлений для него больше не будет, и всё развитие ушло в Alloy. Если статья подаёт Promtail как текущий выбор, она написана до весны 2026-го. Ещё два популярных сборщика — Fluent Bit и Vector: они умеют отправлять строки куда угодно, в том числе в Loki.

Словарь урока

Журнал
Строки, которые программа пишет о своей работе. В обиходе — лог. ↩ к тексту
Loki
Хранилище журналов от Grafana Labs. Индексирует метки, а не текст. ↩ к тексту
Метка
Пара «имя — значение», по которой отбирают строки: container, level, env. ↩ к тексту
Поток
Все строки с одинаковым набором меток. Единица хранения в Loki. ↩ к тексту
Сборщик
Программа, которая читает журналы на машине и отправляет их в хранилище. У Loki — Grafana Alloy. ↩ к тексту
Promtail
Прежний сборщик для Loki, снят с поддержки 2 марта 2026 года. ↩ к тексту

Что спросят на собеседовании

  • Чем Loki отличается от Elasticsearch?
    Loki индексирует только метки, а текст хранит сжатыми кусками и перебирает. Это в разы дешевле, но поиск начинается с сужения по меткам. Elasticsearch строит полнотекстовый индекс и ищет по любому слову ценой памяти и диска.
  • Почему идентификатор запроса нельзя делать меткой?
    Каждое сочетание меток — отдельный поток. Миллион идентификаторов — миллион потоков, и Loki перестанет принимать запись. Идентификатор оставляют в тексте и ищут фильтром.
  • Куда приложению в контейнере писать журнал?
    В стандартный вывод. Его заберёт сборщик, а приложение не будет зависеть от хранилища и не будет заниматься файлами внутри контейнера.

Что дальше

Следом практика: ты поднимешь Loki и Alloy рядом со стендом мониторинга и увидишь журналы всех контейнеров в Grafana.

Проверь себя+200 XPдве попытки
1
Зачем собирать
Что происходит с журналом контейнера, когда контейнер удалили?
2
Loki и Elasticsearch
Что индексирует Loki?
3
Поток
Что такое поток в Loki?
4
Доставка
Кто в нашей схеме читает вывод контейнеров и отправляет его в Loki?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.