Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Στείλτε logs κεντρικά: Loki σε Compose, Alloy shippers για journal και Docker, και αναζήτηση με LogQL στο Grafana.
Το pino γράφει δομημένα logs και το journald τα μαζεύει — ανά host. Μόλις έχετε 2+ υπηρεσίες (ή 2+ μηχανές), το «μπείτε με SSH και ψάξτε» δεν κλιμακώνεται. Η λύση είναι κεντρικό log store με αναζήτηση: στέλνετε (ship) όλα τα logs σε ένα σημείο και τα ρωτάτε με ετικέτες αντί για grep.
Τρία προβλήματα λύνει το κεντρικό shipping: διασπορά (τα logs της web είναι στο container, του proxy στον host, της βάσης αλλού), αναζήτηση (θέλετε «όλα τα errors των τελευταίων 2 ωρών σε όλες τις υπηρεσίες» με ένα ερώτημα) και διατήρηση (το journald κάνει rotate τοπικά· το κεντρικό store κρατά ιστορικό με δική του πολιτική). Ο συνδυασμός του μαθήματος: Loki (store, από τη Grafana) + Alloy (shipper/collector) + Grafana (UI — το έχετε από το μάθημα dashboards).
# Το επίσημο local config για την έκδοση που θα τρέξετε
wget https://raw.githubusercontent.com/grafana/loki/v3.7.0/cmd/loki/loki-local-config.yaml -O loki-config.yamlservices:
loki:
image: grafana/loki:3.7.0
command: -config.file=/mnt/config/loki-config.yaml
volumes:
- ./loki-config.yaml:/mnt/config/loki-config.yaml:ro
- ./loki-data:/tmp/loki # το local config γράφει chunks/index στο /tmp/loki
ports:
- 127.0.0.1:3100:3100
restart: unless-stopped# Μόνιμα δεδομένα: κατάλογος εγγράψιμος από τον χρήστη loki (UID 10001)
mkdir -p loki-data && sudo chown 10001:10001 loki-data
docker compose up -d loki
curl -fsS http://127.0.0.1:3100/readyΤο Loki ακούει HTTP στη 3100 και το /ready επιβεβαιώνει εκκίνηση. Προσοχή στα δικαιώματα: το image τρέχει ως χρήστης loki (UID 10001) — γι' αυτό ο κατάλογος loki-data παίρνει owner το 10001 — αλλιώς το container αποτυγχάνει με permission denied. Χωρίς αυτό το mount, ένα recreate του container θα έσβηνε όλο το ιστορικό logs. Δείτε το Install with Docker.
Το Alloy διαβάζει πηγές (collectors) και τις προωθεί σε writers. Το config.alloy για journal του host + logs όλων των containers:
loki.source.journal "system" {
forward_to = [loki.write.local.receiver]
}
discovery.docker "linux" {
host = "unix:///var/run/docker.sock"
}
// Το όνομα του Compose service γίνεται label "service" (π.χ. service="web")
discovery.relabel "containers" {
targets = []
rule {
source_labels = ["__meta_docker_container_label_com_docker_compose_service"]
target_label = "service"
}
}
loki.source.docker "containers" {
host = "unix:///var/run/docker.sock"
targets = discovery.docker.linux.targets
labels = { "job" = "docker" }
relabel_rules = discovery.relabel.containers.rules
forward_to = [loki.write.local.receiver]
}
loki.write "local" {
endpoint {
url = "http://loki:3100/loki/api/v1/push"
}
}services:
alloy:
image: grafana/alloy:v1.21.3
command: run --server.http.listen-addr=0.0.0.0:12345 --storage.path=/var/lib/alloy/data /etc/alloy/config.alloy
volumes:
- ./config.alloy:/etc/alloy/config.alloy:ro
- /var/run/docker.sock:/var/run/docker.sock
- /var/log/journal:/var/log/journal:ro
- /run/log/journal:/run/log/journal:ro
ports:
- 127.0.0.1:12345:12345
restart: unless-stoppedΣημειώσεις: το discovery.docker δίνει στο loki.source.docker τη λίστα containers (χωρίς αυτό δεν έχει τι να διαβάσει)· το loki.source.journal διαβάζει από τα default paths που κάνετε mount· η θύρα 12345 είναι το debug UI του Alloy. (Σε host install αντί για container, ο χρήστης alloy θέλει συμμετοχή στις ομάδες adm και systemd-journal, αλλιώς δεν συλλέγει τίποτα.) Δείτε τα Alloy→Loki, loki.write και Alloy in Docker.
Το παλιό Promtail είναι EOL από το 2026-03-02 — νέες εγκαταστάσεις ξεκινούν με Alloy, που είναι ο επίσημα προτεινόμενος shipper. (Εναλλακτική vendor-neutral: το Vector — βαρύτερο, εκτός ύλης αυτού του course.)
Προσθέστε datasource Loki με URL http://loki:3100 (όνομα service μέσα στο compose δίκτυο) και ρωτήστε:
{service="web"} |= "error"Χρυσός κανόνας LogQL: labels για ταυτότητα, φίλτρα για περιεχόμενο. Το {service="web"} (label) διαλέγει το stream· το |= "error" (line filter) ψάχνει μέσα στις γραμμές. Ποτέ υψηλής καρδιναλιότητας τιμές (user ids, request ids) σε labels — κάθε συνδυασμός φτιάχνει νέο stream και πνίγει το index. Δείτε το LogQL.
Συνέχεια στη διαδρομή: τα structured logs με pino είναι η είσοδος, το journald η τοπική πηγή, τα Grafana dashboards το UI, και το observability quick reference συνοψίζει journalctl/PromQL/LogQL one-liners.
curl -fsS http://127.0.0.1:3100/readyΣε ποια θύρα ακούει το HTTP API του Loki;
grafana/loki:3.7.0 με το επίσημο local config, HTTP στη 3100, /ready για έλεγχο, προσοχή στο UID 10001.loki.source.journal + discovery.docker/loki.source.docker → loki.write στο http://loki:3100/loki/api/v1/push.|= για περιεχόμενο.