Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 3.71 KB

README.md

File metadata and controls

50 lines (33 loc) · 3.71 KB
Raw

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, as 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 (already in the nightly builds, will be included in Grafana 6.0).

A Loki-based logging stack consists of 3 components:

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

Getting started

For instructions on getting started with Loki, see our getting started docs.

For the beginnings of documentation on how to use Loki, see our usage docs. API documentation is also available.

Getting Help

If you have any questions or feedback regarding Loki:

Your feedback is always welcome.

Further Reading