Skip to content
Like Prometheus, but for logs.
Go Jsonnet Shell Ruby Makefile Python Other
Branch: master
Clone or download
oddlittlebird and rfratto Update (#1024)
Minor grammar and consistency edits.

Note: There is inconsistent capitalization of Promtail/promtail. If you let me know which is correct, then I will update this topic as well as the Grafana Style Guide (in progress).
Latest commit 717e49e Sep 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci chore(packaging): deploy from drone (#991) Sep 9, 2019
.drone full cirlce Sep 9, 2019
.github Change label used to keep issues from being marked as stale to keepal… Sep 3, 2019
build Rollback changes to Makefile and build/Dockerfile from #730 (#758) Jul 15, 2019
cmd Fix a link to correct doc and fix a typo (#1014) Sep 16, 2019
debug Adding `make debug` support to build debug binaries and debug contain… May 3, 2019
docs Revert "Updated stream json objects to be more parse friendly (#1010)" Sep 13, 2019
fluentd/fluent-plugin-grafana-loki Escape double-quotes in labels, and suppress labels with value nil (#928 Sep 17, 2019
loki-build-image chore(packaging): Release pipeline (#840) Aug 2, 2019
pkg Improved Ingester out-of-order error for faster troubleshooting (#1008) Sep 17, 2019
production Update (#1024) Sep 18, 2019
tools updating the image version for loki-canary and adding the version inc… Sep 16, 2019
vendor vendoring: update cortex to latest master (#938) Aug 28, 2019
.gitignore chore(packaging): Release pipeline (#840) Aug 2, 2019
.golangci.yml improves memory usage of golangci-linter May 7, 2019 Updating changelog for v0.3.0 (#906) Aug 18, 2019 Create (#516) May 15, 2019 Update (#1025) Sep 18, 2019
Gopkg.lock vendoring: update cortex to latest master (#938) Aug 28, 2019
Gopkg.toml vendoring: update cortex to latest master (#938) Aug 28, 2019
LICENSE Add logo to readme. (#59) Dec 11, 2018
Makefile Revert "Updated stream json objects to be more parse friendly (#1010)" Sep 13, 2019 Fix links to correct doc (#1005) Sep 11, 2019
mkdocs.yml docs: general documentation rework Sep 6, 2019

Loki Logo

CircleCI Go Report Card Slack

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:

  • does not do full text indexing on logs. By storing compressed, unstructured logs and only indexing metadata, Loki is simpler to operate and cheaper to run.
  • indexes and groups log streams using the same labels you’re already using with Prometheus, enabling you to seamlessly switch between metrics and logs using the same labels that you’re already using with Prometheus.
  • is an especially good fit for storing Kubernetes Pod logs. Metadata such as Pod labels is automatically scraped and indexed.
  • has native support in Grafana (needs Grafana v6.0).

A Loki-based logging stack consists of 3 components:

  • promtail is the agent, responsible for gathering logs and sending them to Loki.
  • loki is the main server, responsible for storing logs and processing queries.
  • Grafana for querying and displaying the logs.

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 focussing on logs instead of metrics, and delivering logs via push, instead of pull.

Getting started

The getting started docs have instructions on how to install Loki via Docker images, Helm charts, Jsonnet, or from source.

Once you have promtail, Loki, and Grafana running, continue with our usage docs on how to query your logs.


  • API documentation for alternative ways of getting logs into Loki.
  • Operations for important aspects of running Loki.
  • Promtail is an agent which can tail your log files and push them to Loki.
  • Processing Log Lines for detailed log processing pipeline documentation
  • Docker Logging Driver is a docker plugin to send logs directly to Loki from Docker containers.
  • Logcli on how to query your logs without Grafana.
  • Loki Canary for monitoring your Loki installation for missing logs.
  • Troubleshooting for help around frequent error messages.
  • Usage for how to set up a Loki datasource in Grafana and query your logs.

Getting Help

If you have any questions or feedback regarding Loki:

Your feedback is always welcome.

Further Reading


Refer to


Apache License 2.0, see LICENSE.

You can’t perform that action at this time.