loki README

The project's README from github.com/grafana/loki. As one markdown file: README.md.

Loki Logo

Check Go Report Card Slack Fuzzing Status

Loki: like Prometheus, but for logs.

Loki is a horizontally-scalable, highly-available, multi-tenant log aggregation system inspired by Prometheus. It is designed to be very cost effective and easy to operate. It does not index the contents of the logs, but rather a set of labels for each log stream.

Compared to other log aggregation systems, Loki:

A Loki-based logging stack consists of 3 components:

Note that Alloy replaced Promtail in the stack, because Promtail is considered to be feature complete, and future development for logs collection will be in Grafana Alloy.

Loki is like Prometheus, but for logs: we prefer a multidimensional label-based approach to indexing, and want a single-binary, easy to operate system with no dependencies. Loki differs from Prometheus by focusing on logs instead of metrics, and delivering logs via push, instead of pull.

Getting started

⚠️ Helm Chart Migration

Effective March 16, 2026, the Grafana Loki Helm chart will be forked to a new repository grafana-community/helm-charts. The chart in the Loki repository will continue to be maintained for GEL users only. See #20705 for details.

Upgrading

Documentation

Commonly used sections:

Getting Help

If you have any questions or feedback regarding Loki:

Your feedback is always welcome.

Further Reading

Contributing

Refer to CONTRIBUTING.md

Building from source

Loki can be run in a single host, no-dependencies mode using the following commands.

You need an up-to-date version of Go, we recommend using the version found in our 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

Alternatively, on Unix systems you can use make to build the binary, which adds additional arguments to the go build command.

# Build binary
$ make loki

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

To run multiple Loki tenants locally, ensure that auth_enabled is set to true and provide a runtime config with any tenant specific overrides.

# 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

Adopters

Please see ADOPTERS.md for some of the organizations using Loki today. If you would like to add your organization to the list, please open a PR to add it to the list.

License

Grafana Loki is distributed under AGPL-3.0-only. For Apache-2.0 exceptions, see LICENSING.md.

loki (grafana/loki)

Searching Database…

29K ·GitHub
Loki
Что это такое?Loki — это система агрегации логов от Grafana, которая масштабируется горизонтально, обладает высокой доступностью и поддерживает несколько арендаторов (multi-tenant). Это как Prometheus, только для логов.
Чем она отличается от других систем агрегации логов?Loki не строит полнотекстовый индекс: она хранит сжатые неструктурированные логи и индексирует только метаданные (лейблы). Благодаря этому её проще эксплуатировать, и обходится она дешевле.
Как выглядит типичный стек для логирования с Loki?Три компонента: Alloy — агент, который собирает логи и отправляет их в Loki; сам сервис Loki, который хранит логи и обрабатывает запросы; и Grafana для выполнения запросов и отображения результатов.
Обязательно ли ставить Grafana, чтобы пользоваться Loki?Да — Grafana служит в этом стеке слоем запросов и отображения, нативная поддержка Loki есть в ней начиная с Grafana v6.0.
В старых руководствах упоминается Promtail — им всё ещё нужно отправлять логи?Нет. Alloy заменил Promtail в этом стеке — Promtail считается завершённым с точки зрения функциональности (feature complete), а дальнейшая разработка сбора логов идёт в Grafana Alloy.
Есть ли что-то важное в лицензии, о чём стоит знать?Loki распространяется под лицензией AGPL-3.0-only — это сильная copyleft-лицензия; исключения в духе Apache-2.0 перечислены в файле LICENSING.md.
Можно ли делать запросы к логам из терминала, без Grafana?Да — LogCLI даёт интерфейс командной строки для обращения к логам Loki напрямую.
Могут ли Docker-контейнеры отправлять свои логи прямо в Loki?Да — Docker Driver Client, это плагин для Docker, который передаёт логи контейнеров напрямую в Loki.
Есть ли подводные камни при установке через Helm?Да — с 16 марта 2026 года Helm-чарт Grafana Loki будет передан (форкнут) в репозиторий grafana-community/helm-charts, а чарт в репозитории Loki будут поддерживать только для пользователей GEL.
What are similar projects?pyroscope, skywalking, grafana, VictoriaMetrics, netdata, evenfire, faas, thanos
Which topics is it in?grafana, multi-tenant, logging, prometheus, observability, agpl, kubernetes, monitoring, hacktoberfest, devops, go, api
Creator
grafana
Size
552.1 MB
Stars
29K
Updated
CommitOct 20Releasev3.7.9Oct 20
Age
8y
Commits · 90 Days