Loki : comme Prometheus, mais pour les journaux.

Loki est un système d'agrégation de journaux scalable horizontalement, hautement disponible et multi-tenant, inspiré de Prometheus. Il est conçu pour être très rentable et facile à exploiter. Il n'indexe pas le contenu des journaux, mais plutôt un ensemble d'étiquettes pour chaque flux de journaux.

Comparé à d'autres systèmes d'agrégation de journaux, Loki :

• n'effectue pas d'indexation de texte intégral sur les journaux. En stockant des journaux compressés et non structurés et en indexant uniquement les métadonnées, Loki est plus simple à exploiter et moins coûteux à faire fonctionner.
• indexe et regroupe les flux de journaux en utilisant les mêmes étiquettes que celles que vous utilisez déjà avec Prometheus, ce qui vous permet de basculer en toute transparence entre métriques et journaux en utilisant les mêmes étiquettes que vous utilisez déjà avec Prometheus.
• est particulièrement adapté au stockage des journaux des pods Kubernetes. Les métadonnées telles que les étiquettes des pods sont automatiquement collectées et indexées.
• bénéficie d'une prise en charge native dans Grafana (nécessite Grafana v6.0).

Une pile de journalisation basée sur Loki se compose de 3 composants :

• Alloy est l'agent chargé de collecter les journaux et de les envoyer à Loki.
• Loki est le service principal, chargé de stocker les journaux et de traiter les requêtes.
• Grafana pour interroger et afficher les journaux.

Notez qu'Alloy a remplacé Promtail dans la pile, car Promtail est considéré comme complet sur le plan fonctionnel, et le développement futur de la collecte de journaux se fera dans Grafana Alloy.

Loki est comme Prometheus, mais pour les journaux : nous préférons une approche multidimensionnelle basée sur les étiquettes pour l'indexation, et nous voulons un système à binaire unique, facile à exploiter et sans dépendances. Loki se distingue de Prometheus en se concentrant sur les journaux plutôt que sur les métriques, et en fournissant les journaux par push, plutôt que par pull.

Premiers pas

• Installer Loki
• Installer Alloy
• Commencer

⚠️ Migration du Helm Chart

À compter du 16 mars 2026, le Helm Chart Grafana Loki sera forké vers un nouveau dépôt grafana-community/helm-charts. Le chart du dépôt Loki continuera à être maintenu uniquement pour les utilisateurs de GEL. Voir #20705 pour plus de détails.

Mise à niveau

• Mettre à niveau Loki

Documentation

• Dernière version
• Prochaine version, à la pointe de la branche principale

Sections couramment utilisées :

• Documentation de l'API pour envoyer des journaux à Loki.
• Étiquettes
• Opérations
• Docker Driver Client est un plugin Docker permettant d'envoyer les journaux directement à Loki depuis des conteneurs Docker.
• LogCLI fournit une interface en ligne de commande pour interroger les journaux.
• Loki Canary surveille votre installation Loki pour détecter les journaux manquants.
• Dépannage présente de l'aide pour traiter les messages d'erreur.
• Loki dans Grafana décrit comment configurer une source de données Loki dans Grafana.

Obtenir de l'aide

Si vous avez des questions ou des commentaires concernant Loki :

• Recherchez les fils de discussion existants dans le forum communautaire Grafana Labs pour Loki : https://community.grafana.com
• Posez une question sur le canal Slack Loki. Pour vous inviter sur le Slack Grafana, visitez https://slack.grafana.com/ et rejoignez le canal #loki.
• Ouvrez une issue pour les bogues, problèmes et suggestions de fonctionnalités.
• Envoyez un e-mail à [email protected], ou utilisez l'interface web.
• Les problèmes d'interface utilisateur doivent être signalés directement dans Grafana.

Vos commentaires sont toujours les bienvenus.

Pour aller plus loin

• Le document de conception original de Loki est une bonne source de discussion sur les motivations et les décisions de conception.
• La présentation de Callum Styan à DevOpsDays Vancouver en mars 2019 « Grafana Loki : Log Aggregation for Incident Investigations ».
• Article de blog de Grafana Labs « How We Designed Loki to Work Easily Both as Microservices and as Monoliths ».
• La présentation de Tom Wilkie au CNCF Paris/FOSDEM début 2019 « Grafana Loki : like Prometheus, but for logs » (diapositives, vidéo).
• La présentation de David Kaltschmidt au KubeCon 2018 « On the OSS Path to Full Observability with Grafana » (diapositives, vidéo) sur la manière dont Loki s'intègre dans un environnement cloud natif.
• Article de blog de Goutham Veeramachaneni « Loki: Prometheus-inspired, open source logging for cloud natives » sur les détails de l'architecture de Loki.
• Article de blog de David Kaltschmidt « Closer look at Grafana's user interface for Loki » sur les idées qui ont présidé à l'interface utilisateur de journalisation.

Contribuer

Référez-vous à CONTRIBUTING.md

Compiler à partir des sources

Loki peut être exécuté sur un hôte unique, en mode sans dépendances, à l'aide des commandes suivantes.

Vous avez besoin d'une version à jour de Go, nous recommandons d'utiliser la version trouvée dans notre 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

Alternativement, sur les systèmes Unix, vous pouvez utiliser make pour compiler le binaire, ce qui ajoute des arguments supplémentaires à la commande go build.

# Build binary
$ make loki

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

Pour exécuter plusieurs tenants Loki localement, assurez-vous que auth_enabled est défini sur true et fournissez une configuration d'exécution avec des remplacements spécifiques aux tenants.

# 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

Adoptants

Veuillez consulter ADOPTERS.md pour voir quelques-unes des organisations qui utilisent Loki aujourd'hui. Si vous souhaitez ajouter votre organisation à la liste, veuillez ouvrir une PR pour l'ajouter à la liste.

Licence

Grafana Loki est distribué sous AGPL-3.0-only. Pour les exceptions Apache-2.0, voir LICENSING.md.