Loki: come Prometheus, ma per i log.

Loki è un sistema di aggregazione dei log multi-tenant, altamente disponibile e scalabile orizzontalmente, ispirato a Prometheus. È progettato per essere molto conveniente in termini di costi e facile da gestire. Non indicizza il contenuto dei log, ma piuttosto un insieme di etichette per ogni flusso di log.

Rispetto ad altri sistemi di aggregazione dei log, Loki:

• non esegue l'indicizzazione full-text sui log. Archiviando log non strutturati e compressi e indicizzando solo i metadati, Loki è più semplice da gestire e più economico da eseguire.
• indicizza e raggruppa i flussi di log usando le stesse etichette che già usi con Prometheus, consentendoti di passare senza soluzione di continuità tra metriche e log usando le stesse etichette che già usi con Prometheus.
• è particolarmente adatto per archiviare i log dei Pod di Kubernetes. Metadati come le etichette dei Pod vengono automaticamente raccolti e indicizzati.
• ha supporto nativo in Grafana (richiede Grafana v6.0).

Uno stack di logging basato su Loki è composto da 3 componenti:

• Alloy è l'agente, responsabile della raccolta dei log e dell'invio a Loki.
• Loki è il servizio principale, responsabile dell'archiviazione dei log e dell'elaborazione delle query.
• Grafana per interrogare e visualizzare i log.

Nota che Alloy ha sostituito Promtail nello stack, poiché Promtail è considerato funzionalmente completo e lo sviluppo futuro per la raccolta dei log sarà in Grafana Alloy.

Loki è come Prometheus, ma per i log: preferiamo un approccio multidimensionale basato su etichette per l'indicizzazione e vogliamo un sistema a binario singolo, facile da gestire e senza dipendenze. Loki si differenzia da Prometheus concentrandosi sui log invece che sulle metriche e consegnando i log tramite push, invece che tramite pull.

Per iniziare

• Installazione di Loki
• Installazione di Alloy
• Guida introduttiva

⚠️ Migrazione della Helm Chart

A partire dal 16 marzo 2026, la Helm Chart di Grafana Loki verrà spostata tramite fork in un nuovo repository grafana-community/helm-charts. La chart nel repository di Loki continuerà a essere mantenuta solo per gli utenti GEL. Vedi #20705 per i dettagli.

Aggiornamento

• Aggiornare Loki

Documentazione

• Ultima release
• Prossima release, all'ultimo commit del ramo main

Sezioni di uso comune:

• Documentazione API per inserire i log in Loki.
• Etichette
• Operazioni
• Docker Driver Client è un plugin Docker per inviare i log direttamente a Loki dai container Docker.
• LogCLI fornisce un'interfaccia a riga di comando per interrogare i log.
• Loki Canary monitora la tua installazione di Loki per individuare log mancanti.
• Risoluzione dei problemi fornisce aiuto per la gestione dei messaggi di errore.
• Loki in Grafana descrive come configurare una sorgente dati Loki in Grafana.

Come ottenere aiuto

Se hai domande o feedback su Loki:

• Cerca nei thread esistenti del forum della community di Grafana Labs per Loki: https://community.grafana.com
• Fai una domanda sul canale Slack di Loki. Per invitarti alla Slack di Grafana, visita https://slack.grafana.com/ e unisciti al canale #loki.
• Apri una segnalazione per bug, problemi e suggerimenti di funzionalità.
• Invia un'email a [email protected], oppure usa l'interfaccia web.
• I problemi relativi all'interfaccia utente vanno segnalati direttamente in Grafana.

Il tuo feedback è sempre benvenuto.

Ulteriori letture

• Il documento di progettazione originale di Loki è una buona fonte per discutere motivazioni e decisioni di progettazione.
• Il talk di Callum Styan al DevOpsDays Vancouver di marzo 2019 "Grafana Loki: Log Aggregation for Incident Investigations".
• Il post del blog di Grafana Labs "Come abbiamo progettato Loki per funzionare facilmente sia come microservizi che come monoliti".
• Il talk di Tom Wilkie al CNCF Paris/FOSDEM di inizio 2019 "Grafana Loki: come Prometheus, ma per i log" (slide, video).
• Il talk di David Kaltschmidt al KubeCon 2018 "Sul percorso OSS verso l'osservabilità completa con Grafana" (slide, video) su come Loki si inserisce in un ambiente cloud-native.
• Il post del blog di Goutham Veeramachaneni "Loki: logging open source ispirato a Prometheus per i cloud native" sui dettagli dell'architettura di Loki.
• Il post del blog di David Kaltschmidt "Uno sguardo più da vicino all'interfaccia utente di Grafana per Loki" sulle idee alla base dell'interfaccia utente per i log.

Come contribuire

Fai riferimento a CONTRIBUTING.md

Compilazione dal codice sorgente

Loki può essere eseguito su un singolo host, in modalità senza dipendenze, usando i seguenti comandi.

Ti serve una versione aggiornata di Go; consigliamo di usare la versione presente nel nostro 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

In alternativa, sui sistemi Unix puoi usare make per compilare il binario, che aggiunge argomenti aggiuntivi al comando go build.

# Build binary
$ make loki

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

Per eseguire più tenant Loki in locale, assicurati che auth_enabled sia impostato su true e fornisci una configurazione runtime con eventuali override specifici per tenant.

# 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

Utilizzatori

Consulta ADOPTERS.md per alcune delle organizzazioni che oggi utilizzano Loki. Se desideri aggiungere la tua organizzazione all'elenco, apri una PR per aggiungerla.

Licenza

Grafana Loki è distribuito sotto AGPL-3.0-only. Per le eccezioni Apache-2.0, vedi LICENSING.md.