Jurnalul containerului: docker logs
Un container pornit în fundal nu-ți arată nimic în terminal. Și totuși programul din el scrie mesaje: că a pornit, cine l-a vizitat, ce eroare a apărut. Docker le păstrează pe toate în jurnalul containerului. În această lecție înveți să-l citești cu docker logs și rezolvi primul tău caz real de depanare: o bază de date care se oprește imediat după pornire.
Ce ajunge în jurnal
Din cursul de Linux știi că un program scrie mesaje pe două canale: stdout (ieșirea normală) și stderr (erorile). Docker capturează tot ce scrie procesul principal al containerului pe aceste canale și le păstrează, chiar și după ce containerul s-a oprit.
Pornește un nginx în fundal și citește-i jurnalul:
docker run -d --name web -p 8080:80 nginx docker logs web
a12826c4b51e08b8ee000321ac770ef1b9f132f5f50a3dc804c5f779eaeb2a0e /docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration /docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/ /docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh 10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf 10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf /docker-entrypoint.sh: Sourcing /docker-entrypoint.d/15-local-resolvers.envsh /docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh /docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh /docker-entrypoint.sh: Configuration complete; ready for start up 2026/01/15 08:00:09 [notice] 1#1: using the "epoll" event method 2026/01/15 08:00:09 [notice] 1#1: nginx/1.27.3 2026/01/15 08:00:09 [notice] 1#1: built by gcc 12.2.0 (Debian 12.2.0-14) 2026/01/15 08:00:09 [notice] 1#1: OS: Linux 6.8.0-49-generic 2026/01/15 08:00:09 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576 2026/01/15 08:00:09 [notice] 1#1: start worker processes 2026/01/15 08:00:09 [notice] 1#1: start worker process 29 2026/01/15 08:00:09 [notice] 1#1: start worker process 30
Sunt mesajele de pornire ale lui nginx: scripturile de configurare și rândurile [notice] care spun că serverul a pornit procesele de lucru. Fără docker logs nu le-ai fi văzut niciodată, pentru că ai pornit containerul cu -d.
Cineva a pornit o bază de date PostgreSQL numită db, dar containerul s-a oprit imediat. Citește jurnalul ca să afli de ce, apoi șterge containerul și pornește-l din nou, corect, cu parola secret.
- Citește jurnalul containerului db cu docker logs.
- Șterge containerul oprit db.
- Pornește din nou, în fundal, un container postgres:16 numit db, cu -e POSTGRES_PASSWORD=secret.
Soluția exercițiului
docker logs db docker rm db docker run -d --name db -e POSTGRES_PASSWORD=secret postgres:16 docker logs -n 3 db
Vrei să afli mai mult?Jurnalul crește: o vizită pe site · Cu ora exactă: -t · Caz de depanare: baza de date care se oprește · Repară: o parolă cu -e · Exemple reale
Jurnalul crește: o vizită pe site
nginx scrie în jurnal un rând pentru fiecare cerere primită (*access log*). Cere pagina o dată (fără să afișezi răspunsul, cu -s și > /dev/null din cursul de Linux), apoi uită-te doar la ultimul rând al jurnalului, cu -n 1:
curl -s localhost:8080 > /dev/null docker logs -n 1 web
172.17.0.1 - - [15/Jan/2026:08:00:10 +0000] "GET / HTTP/1.1" 200 615 "-" "curl/8.5.0" "-"
- 172.17.0.1: adresa de la care a venit cererea (calculatorul tău, văzut din rețeaua containerului);
- "GET / HTTP/1.1" 200 615: s-a cerut pagina principală, răspunsul a fost 200 (OK) și a avut 615 octeți;
- "curl/8.5.0": programul care a făcut cererea. Dacă deschizi pagina din Previzualizare, apare alt rând.
-n 5 (sau --tail 5) = doar ultimele 5 rânduri; -t = adaugă ora exactă la fiecare rând; -f (*follow*) = rămâne deschis și afișează rândurile noi pe măsură ce apar, până apeși Ctrl+C, ca tail -f din cursul de Linux.
Cu ora exactă: -t
Când cauți ce s-a întâmplat la o anumită oră, -t pune în fața fiecărui rând momentul în care a fost scris (ora e în UTC):
docker logs -t -n 2 web
2026-01-15T08:00:09.123456798Z 2026/01/15 08:00:09 [notice] 1#1: start worker process 30 2026-01-15T08:00:10.123456799Z 172.17.0.1 - - [15/Jan/2026:08:00:10 +0000] "GET / HTTP/1.1" 200 615 "-" "curl/8.5.0" "-"
Opțiunile se combină: -t -n 2 = ultimele două rânduri, cu ora lor. Orele de pe calculatorul tău vor fi, evident, altele.
Caz de depanare: baza de date care se oprește
Pornește o bază de date PostgreSQL, versiunea 16, în fundal:
docker run -d --name baza postgres:16 docker ps -a
8778566d028dc257d2b3174f2ea82b6c4ce510421c7d25bcb38f0b9adffa81cf CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 8778566d028d postgres:16 "docker-entrypoint.s…" 1 second ago Exited (1) 1 second ago baza a12826c4b51e nginx "/docker-entrypoint.…" 5 seconds ago Up 5 seconds 0.0.0.0:8080->80/tcp, [::]:8080->80/tcp web
Docker a afișat ID-ul, deci containerul a pornit. Dar în docker ps -a, STATUS spune Exited (1): s-a oprit aproape imediat, cu un cod de eroare. De ce? Răspunsul e în jurnal:
docker logs baza
Error: Database is uninitialized and superuser password is not specified.
You must specify POSTGRES_PASSWORD to a non-empty value for the
superuser. For example, "-e POSTGRES_PASSWORD=password" on "docker run".
You may also use "POSTGRES_HOST_AUTH_METHOD=trust" to allow all
connections without a password. This is *not* recommended.
See PostgreSQL documentation about "trust":
https://www.postgresql.org/docs/current/auth-trust.htmlMesajul e foarte clar, chiar dacă e în engleză: baza de date nu are încă o parolă pentru administrator (*superuser*), iar imaginea refuză să pornească fără ea. Îți spune și soluția: -e POSTGRES_PASSWORD=password la docker run.
Un container care se oprește imediat (Exited (1), Exited (127)…) aproape întotdeauna și-a scris motivul în jurnal. **Primul pas: docker logs nume.**
Repară: o parolă cu -e
Opțiunea -e dă containerului o variabilă de mediu (le studiezi în detaliu în lecția 23; deocamdată reține doar forma -e NUME=valoare). Containerul vechi trebuie șters, pentru că numele baza e ocupat și setările unui container nu se pot schimba după creare:
docker rm baza docker run -d --name baza -e POSTGRES_PASSWORD=secret postgres:16 docker ps
baza 4cca441255da226685044bd0e01f122f1b3604fb98db272510276d3f0526b401 CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 4cca441255da postgres:16 "docker-entrypoint.s…" 1 second ago Up 1 second 5432/tcp baza a12826c4b51e nginx "/docker-entrypoint.…" 9 seconds ago Up 9 seconds 0.0.0.0:8080->80/tcp, [::]:8080->80/tcp web
Acum containerul e Up. Ultimele rânduri ale jurnalului confirmă că baza de date a pornit și așteaptă conexiuni:
docker logs -n 3 baza
2026-01-15 08:00:17.123 UTC [1] LOG: starting PostgreSQL 16.6 (Debian 16.6-1.pgdg120+1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit 2026-01-15 08:00:17.123 UTC [1] LOG: listening on IPv4 address "0.0.0.0", port 5432 2026-01-15 08:00:17.130 UTC [1] LOG: database system is ready to accept connections
PostgreSQL scrie mesajele LOG: pe stderr. docker logs le afișează pe ambele canale, dar dacă trimiți ieșirea mai departe cu | (de exemplu la grep), din cursul de Linux știi că doar stdout trece prin pipe. Folosește 2>&1 dacă vrei să filtrezi tot jurnalul.
Exemple reale
Dimineața, docker logs -t api arată ora exactă și eroarea care a oprit-o.
Rândurile de acces din jurnalul nginx arată fiecare pagină cerută și răspunsul dat.
Un container Exited (1) după o modificare: docker logs spune ce setare lipsește, ca la PostgreSQL.
Pe scurt: docker logs nume afișează tot ce a scris programul din container; -n limitează rândurile, -t adaugă ora, -f urmărește în timp real.
