Skip to content
Like Prometheus, but for logs.
Go Jsonnet Ruby Makefile Shell Python Other
Branch: master
Clone or download
pstibrany and cyriltovena docs: Fix grpc_listen_host and http_listen_host. (#1353)
They should be grpc_listen_address and http_listen_address respectively.

Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
Latest commit 2da8d6f Dec 6, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Adding `zip` to the build image (#1364) Dec 4, 2019
.drone Adding `zip` to the build image (#1364) Dec 4, 2019
.github docs: fix Promtail / Loki capitalization (#1130) Oct 8, 2019
build dep => go mod (#1062) Sep 30, 2019
cmd Let Loki start when using the debug image. (#1372) Dec 5, 2019
debug docs: fix Promtail / Loki capitalization (#1130) Oct 8, 2019
docs docs: Fix grpc_listen_host and http_listen_host. (#1353) Dec 6, 2019
fluentd/fluent-plugin-grafana-loki Fluentd: guard against nil values when sanitizing labels (#1376) Dec 5, 2019
loki-build-image Adding `zip` to the build image (#1364) Dec 4, 2019
pkg pkg/ingester: check that ingester is in LEAVING state when transferri… Dec 6, 2019
production Updating version numbers for 1.1.0 release Dec 4, 2019
tools chore(/release): distribute binaries as .zip (#1160) Dec 3, 2019
vendor feat(loki): support IAM roles for EKS (#1340) Nov 30, 2019
.gitignore dep => go mod (#1062) Sep 30, 2019
.golangci.yml Makefile changes to allow easy builds with or without vendoring. Also… Nov 29, 2019
CHANGELOG.md Update changelog for 1.1.0 release (#1360) Dec 4, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#516) May 15, 2019
CONTRIBUTING.md Go 1.13 (#1089) Oct 1, 2019
LICENSE Add logo to readme. (#59) Dec 11, 2018
Makefile Adding `zip` to the build image (#1364) Dec 4, 2019
README.md Update README.md (#1132) Oct 9, 2019
go.mod feat(loki): support IAM roles for EKS (#1340) Nov 30, 2019
go.sum feat(loki): support IAM roles for EKS (#1340) Nov 30, 2019
mkdocs.yml docs: general documentation rework Sep 6, 2019

README.md

Loki Logo

Drone CI 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 Installation docs have instructions on how to install Loki via Docker images, Helm charts, Jsonnet, or from source.

You may also be interested in installing Promtail to send logs to Loki.

Once you have Promtail, Loki, and Grafana running, continue with our Getting Started Guide to get up and running with querying logs.

Documentation

The documentation with a Table of Contents can be found in docs/.

Some key documents to read:

  • 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.
  • Pipelines 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.
  • Loki in Grafana 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

Contributing

Refer to CONTRIBUTING.md

License

Apache License 2.0, see LICENSE.

You can’t perform that action at this time.