History

blasebast 9b069a15c4 docs: improve all README files, add uptime-kuma		2026-04-12 20:11:50 +02:00
..
README.md	docs: improve all README files, add uptime-kuma	2026-04-12 20:11:50 +02:00
loki-config.yaml	.gitignore, documentation, other improvements	2026-04-04 21:45:48 +02:00

README.md

Loki - Log Aggregation

Grafana Loki log aggregation system. Receives logs from Promtail and exposes them to Grafana via LogQL.

Access

Endpoint	Details
Internal	http://loki:3100 (no public Traefik access)
Local	http://localhost:3100
Auth	None (`auth_enabled: false`)

Configuration

Config file: ./loki/loki-config.yaml

Key Parameters

Parameter	Value
HTTP Port	`3100`
Storage backend	`tsdb` (schema v13, from 2024-01-01)
Data location	`./loki/data/` (Docker volume)
Index	`/loki/index`
Chunks	`/loki/chunks`
Cache	`/loki/cache`
WAL	`./loki/wal/`
Log retention	744h (31 days)
Ingestion rate	max 10 MB/s (burst 20 MB/s)
Compaction + retention	enabled (`retention_enabled: true`), 2h delay

Data Sources

Loki stores logs - not metrics. All Docker containers push logs via Promtail (Docker socket discovery).

Access in Grafana: datasource Loki (uid: loki), max 1000 lines per query.

Dependencies

Service	Role
Promtail	Only push client (POST `/loki/api/v1/push`)
Grafana	Queries logs via LogQL

Useful Commands

# Restart
docker compose restart loki

# Follow logs
docker compose logs -f loki

# Check Loki status
curl http://localhost:3100/ready
curl http://localhost:3100/metrics | grep loki_ingester

# Upgrade
./upgrade-container-by-name.sh loki