Loki Logo

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.

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

⚠️ Миграция 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 можно запустить на одном хосте в режиме без зависимостей с помощью следующих команд.

Вам понадобится актуальная версия Go, мы рекомендуем использовать версию, указанную в нашем Makefile

# Checkout source code
$ git clone https://github.com/grafana/loki
$ cd loki

# Build binary
$ go build ./cmd/loki

# Run executable
$ ./loki -config.file=./cmd/loki/loki-local-config.yaml

В качестве альтернативы, в Unix-системах вы можете использовать make для сборки бинарного файла, что добавляет дополнительные аргументы к команде go build.

# Build binary
$ make loki

# Run executable
$ ./cmd/loki/loki -config.file=./cmd/loki/loki-local-config.yaml

Чтобы запустить несколько тенантов Loki локально, убедитесь, что auth_enabled установлен в true, и предоставьте runtime-конфиг с любыми переопределениями для конкретных тенантов.

# Build binary
$ make loki

# Run executable
./loki -config.file=./cmd/loki/loki-local-multi-tenant-config.yaml -runtime-config.file=./cmd/loki/loki-overrides.yaml

Использование Loki в организациях

Пожалуйста, обратитесь к ADOPTERS.md, чтобы узнать о некоторых организациях, использующих Loki сегодня. Если вы хотите добавить свою организацию в список, отправьте PR для её добавления.

Лицензия

Grafana Loki распространяется под лицензией AGPL-3.0-only. Об исключениях Apache-2.0 см. LICENSING.md.

loki

Популярное