Loki Logo

Loki: wie Prometheus, aber für Logs.

Loki ist ein horizontal skalierbares, hochverfügbares, mandantenfähiges Log-Aggregationssystem, das von Prometheus inspiriert ist. Es ist darauf ausgelegt, sehr kosteneffizient und einfach zu betreiben zu sein. Es indexiert nicht den Inhalt der Logs, sondern eine Reihe von Labels für jeden Log-Stream.

Im Vergleich zu anderen Log-Aggregationssystemen zeichnet sich Loki dadurch aus, dass es:

keine Volltextindizierung der Logs durchführt. Durch die Speicherung komprimierter, unstrukturierter Logs und die ausschließliche Indizierung von Metadaten ist Loki einfacher zu betreiben und günstiger im Betrieb.
Log-Streams anhand derselben Labels indexiert und gruppiert, die Sie bereits mit Prometheus verwenden, sodass Sie nahtlos zwischen Metriken und Logs wechseln können – mit denselben Labels, die Sie bereits mit Prometheus verwenden.
sich besonders gut für die Speicherung von Kubernetes-Pod-Logs eignet. Metadaten wie Pod-Labels werden automatisch gesammelt und indexiert.
native Unterstützung in Grafana bietet (erfordert Grafana v6.0).

Ein auf Loki basierender Logging-Stack besteht aus 3 Komponenten:

Alloy ist der Agent, der für das Sammeln der Logs und deren Übertragung an Loki verantwortlich ist.
Loki ist der Hauptdienst, der für die Speicherung der Logs und die Verarbeitung von Abfragen verantwortlich ist.
Grafana für das Abfragen und Anzeigen der Logs.

Beachten Sie, dass Alloy Promtail im Stack ersetzt hat, da Promtail als funktionsvollständig gilt und die zukünftige Entwicklung der Log-Erfassung in Grafana Alloy stattfinden wird.

Loki ist wie Prometheus, aber für Logs: Wir bevorzugen einen mehrdimensionalen, labelbasierten Ansatz für die Indizierung und möchten ein System mit einer einzigen Binärdatei, das einfach zu betreiben ist und keine Abhängigkeiten aufweist. Loki unterscheidet sich von Prometheus dadurch, dass es sich auf Logs statt auf Metriken konzentriert und Logs per Push statt per Pull bereitstellt.

Erste Schritte

⚠️ Helm-Chart-Migration

Ab dem 16. März 2026 wird das Grafana-Loki-Helm-Chart in ein neues Repository grafana-community/helm-charts geforkt. Das Chart im Loki-Repository wird weiterhin ausschließlich für GEL-Benutzer gepflegt. Details finden Sie unter #20705.

Aktualisieren

Aktualisieren von Loki

Dokumentation

Neueste Version
Nächste Version, am Stand des main-Branches

Häufig verwendete Abschnitte:

API-Dokumentation für das Übertragen von Logs in Loki.
Labels
Betrieb
Docker-Driver-Client ist ein Docker-Plugin, um Logs direkt aus Docker-Containern an Loki zu senden.
LogCLI bietet eine Befehlszeilenschnittstelle zum Abfragen von Logs.
Loki Canary überwacht Ihre Loki-Installation auf fehlende Logs.
Fehlerbehebung bietet Hilfe im Umgang mit Fehlermeldungen.
Loki in Grafana beschreibt, wie Sie in Grafana eine Loki-Datenquelle einrichten.

Hilfe erhalten

Wenn Sie Fragen oder Feedback zu Loki haben:

Durchsuchen Sie vorhandene Threads im Grafana-Labs-Community-Forum für Loki: https://community.grafana.com
Stellen Sie eine Frage im Loki-Slack-Kanal. Um dem Grafana-Slack beizutreten, besuchen Sie https://slack.grafana.com/ und treten Sie dem Kanal #loki bei.
Erstellen Sie ein Issue für Fehler, Probleme und Funktionsvorschläge.
Senden Sie eine E-Mail an [email protected] oder nutzen Sie die Weboberfläche.
UI-Probleme sollten direkt in Grafana gemeldet werden.

Ihr Feedback ist immer willkommen.

Weiterführende Literatur

Das ursprüngliche Designdokument von Loki ist eine gute Quelle für die Diskussion von Motivation und Designentscheidungen.
Der Vortrag von Callum Styan bei DevOpsDays Vancouver im März 2019 "Grafana Loki: Log-Aggregation für Incident Investigations".
Der Blogbeitrag von Grafana Labs "Wie wir Loki so entwickelt haben, dass es sowohl als Microservices als auch als Monolithen einfach funktioniert".
Der Vortrag von Tom Wilkie Anfang 2019 bei CNCF Paris/FOSDEM "Grafana Loki: wie Prometheus, aber für Logs" (Folien, Video).
Der Vortrag von David Kaltschmidt bei der KubeCon 2018 "Auf dem OSS-Weg zu vollständiger Observability mit Grafana" (Folien, Video) darüber, wie Loki in eine Cloud-native Umgebung passt.
Der Blogbeitrag von Goutham Veeramachaneni "Loki: Von Prometheus inspiriertes Open-Source-Logging für Cloud Natives" über Details der Loki-Architektur.
Der Blogbeitrag von David Kaltschmidt "Ein genauerer Blick auf Grafanas Benutzeroberfläche für Loki" über die Ideen, die in die Logging-Benutzeroberfläche eingeflossen sind.

Mitwirken

Siehe CONTRIBUTING.md

Build aus dem Quellcode

Loki kann mit den folgenden Befehlen im Einzelhost-Modus ohne Abhängigkeiten ausgeführt werden.

Sie benötigen eine aktuelle Version von Go; wir empfehlen die Version aus unserem 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

Alternativ können Sie auf Unix-Systemen make verwenden, um die Binärdatei zu erstellen; dabei werden dem go build-Befehl zusätzliche Argumente hinzugefügt.

# Build binary
$ make loki

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

Um mehrere Loki-Tenants lokal auszuführen, stellen Sie sicher, dass auth_enabled auf true gesetzt ist, und stellen Sie eine Runtime-Konfiguration mit mandantenspezifischen Overrides bereit.

# 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

Anwender

Eine Liste einiger Organisationen, die Loki derzeit verwenden, finden Sie in ADOPTERS.md. Wenn Sie Ihre Organisation zur Liste hinzufügen möchten, eröffnen Sie bitte einen PR, um sie in die Liste aufzunehmen.

Lizenz

Grafana Loki wird unter AGPL-3.0-only vertrieben. Informationen zu Apache-2.0-Ausnahmen finden Sie in LICENSING.md.

loki

Beliebteste