Loki: как Prometheus, но для логов.

Loki — это горизонтально масштабируемая, высокодоступная многопользовательская система агрегации логов, вдохновлённая Prometheus. Она спроектирована так, чтобы быть очень экономичной и простой в эксплуатации. Она не индексирует содержимое логов, а индексирует набор меток для каждого потока логов.

По сравнению с другими системами агрегации логов, Loki:

• не выполняет полнотекстовое индексирование логов. Благодаря хранению сжатых неструктурированных логов и индексированию только метаданных Loki проще в эксплуатации и дешевле в работе.
• индексирует и группирует потоки логов, используя те же метки, которые вы уже используете с Prometheus, что позволяет вам легко переключаться между метриками и логами, используя те же метки, которые вы уже используете с Prometheus.
• особенно хорошо подходит для хранения логов Pod'ов Kubernetes. Метаданные, такие как метки Pod'ов, автоматически собираются и индексируются.
• имеет нативную поддержку в Grafana (требуется Grafana v6.0).

Стек логирования на основе Loki состоит из 3 компонентов:

• Alloy — агент, отвечающий за сбор логов и их отправку в Loki.
• Loki — основной сервис, отвечающий за хранение логов и обработку запросов.
• Grafana — для запросов и отображения логов.

Обратите внимание, что Alloy заменил Promtail в стеке, поскольку Promtail считается функционально завершённым, а дальнейшая разработка сбора логов будет вестись в Grafana Alloy.

Loki — это как Prometheus, но для логов: мы предпочитаем многомерный подход к индексированию на основе меток и хотим однобинарную, простую в эксплуатации систему без зависимостей. Loki отличается от Prometheus тем, что фокусируется на логах, а не на метриках, и доставляет логи через push, а не pull.

Начало работы

• Установка Loki
• Установка Alloy
• Начало работы

⚠️ Миграция Helm-чарта

С 16 марта 2026 года Helm-чарт Grafana Loki будет форкнут в новый репозиторий grafana-community/helm-charts. Чарт в репозитории Loki будет поддерживаться только для пользователей GEL. Подробности см. в #20705.

Обновление

• Обновление Loki

Документация

• Последний релиз
• Предстоящий релиз, на вершине ветки main

Часто используемые разделы:

• Документация API по приёму логов в Loki.
• Метки
• Эксплуатация
• Docker Driver Client — это плагин Docker для отправки логов напрямую в Loki из контейнеров Docker.
• LogCLI предоставляет интерфейс командной строки для запроса логов.
• Loki Canary отслеживает вашу установку Loki на предмет пропущенных логов.
• Устранение неполадок содержит помощь в работе с сообщениями об ошибках.
• Loki в Grafana описывает, как настроить источник данных Loki в Grafana.

Получение помощи

Если у вас есть вопросы или отзывы о Loki:

• Поищите существующую тему в форуме сообщества Grafana Labs по Loki: https://community.grafana.com
• Задайте вопрос в канале Loki в Slack. Чтобы получить приглашение в Grafana Slack, посетите https://slack.grafana.com/ и присоединитесь к каналу #loki.
• Создайте issue для сообщений об ошибках, проблемах и предложений по функциям.
• Отправьте письмо на [email protected] или воспользуйтесь веб-интерфейсом.
• Проблемы с UI следует создавать напрямую в Grafana.

Ваши отзывы всегда приветствуются.

Дополнительные материалы

• Оригинальный design doc для Loki — хороший источник для обсуждения мотивации и проектных решений.
• Доклад Каллума Стьяна (Callum Styan) на DevOpsDays Vancouver в марте 2019 года «Grafana Loki: Log Aggregation for Incident Investigations».
• Пост в блоге Grafana Labs «How We Designed Loki to Work Easily Both as Microservices and as Monoliths».
• Доклад Тома Уилки (Tom Wilkie) начала 2019 года на CNCF Paris/FOSDEM «Grafana Loki: like Prometheus, but for logs» (слайды, видео).
• Доклад Дэвида Кальтшмидта (David Kaltschmidt) на KubeCon 2018 «On the OSS Path to Full Observability with Grafana» (слайды, видео) о том, как Loki вписывается в cloud-native среду.
• Пост в блоге Гаутама Вирамачанени (Goutham Veeramachaneni) «Loki: Prometheus-inspired, open source logging for cloud natives» с подробностями архитектуры Loki.
• Пост в блоге Дэвида Кальтшмидта «Closer look at Grafana's user interface for Loki» об идеях, заложенных в интерфейс для работы с логами.

Участие в разработке

См. CONTRIBUTING.md

Сборка из исходного кода