...
← Curs Docker: toate lecțiile
Lecția 12 · Depanare

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.

Exercițiul tău

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.
docker logs db, apoi docker rm db și docker run -d --name db -e POSTGRES_PASSWORD=secret postgres:16.

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
Excelent! Continuă cu lecția următoare →
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.
Opțiunile utile

-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.html

Mesajul 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.

Regula de depanare

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
stdout și stderr

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

Aplicația a căzut noaptea

Dimineața, docker logs -t api arată ora exactă și eroarea care a oprit-o.

Cine a vizitat site-ul

Rândurile de acces din jurnalul nginx arată fiecare pagină cerută și răspunsul dat.

Configurare greșită

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.

terminalDocker
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași cu Docker Lecția 12 · Jurnalul containerului: docker logs
Progres 0% 0 din 17
Lecția curentă 12 / 15 Depanare