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

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

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

• не выполняет полнотекстовую индексацию логов. Храня сжатые неструктурированные логи и индексируя только метаданные, Loki проще в эксплуатации и дешевле в работе.
• индексирует и группирует потоки логов с помощью тех же меток, которые вы уже используете с Prometheus, что позволяет вам легко переключаться между метриками и логами, используя одни и те же метки.
• особенно хорошо подходит для хранения логов подов Kubernetes. Такие метаданные, как метки подов, автоматически собираются и индексируются.
• имеет нативную поддержку в 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 для отправки логов напрямую из Docker-контейнеров в Loki.
• 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] или воспользуйтесь веб-интерфейсом.
• Проблемы с интерфейсом следует отправлять непосредственно в Grafana.

Мы всегда рады вашим отзывам.

Дополнительное чтение

• Оригинальный design doc для Loki — хороший источник для обсуждения мотивации и проектных решений.
• Выступление Каллума Стайана на 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".
• Выступление Тома Уилки на CNCF Paris/FOSDEM в начале 2019 года: "Grafana Loki: like Prometheus, but for logs" (слайды, видео).
• Выступление Дэвида Кальчмидта на KubeCon 2018: "On the OSS Path to Full Observability with Grafana" (слайды, видео) о том, как Loki вписывается в cloud-native окружение.
• Статья Гоутама Вирамачанени: "Loki: Prometheus-inspired, open source logging for cloud natives" с подробностями об архитектуре Loki.
• Статья Дэвида Кальчмидта: "Closer look at Grafana's user interface for Loki" об идеях, которые легли в основу пользовательского интерфейса для логов.

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

См. CONTRIBUTING.md

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

Loki можно запустить на одном хосте в режиме без зависимостей с помощью следующих команд.