Calitatea hostingului dă valoare site-ului tău.

Administrare Linux · Ghid practic

Jurnalele systemd: găsește cauza unui serviciu Linux eșuat

Când un serviciu nu pornește, jurnalul systemd poate lega mesajele de unitatea și pornirea care au eșuat. Află cum filtrezi ieșirea, păstrezi intervalul relevant și compari cu logurile aplicației.

Începe cu starea unității

Comanda `systemctl status` oferă rezumatul stării unității, codul de ieșire și câteva linii de jurnal. Folosește numele exact al serviciului și verifică timestampul, utilizatorul, fișierul executabil și dependențele afișate. Mesajul de status este punctul de pornire; cauza poate fi într-o linie anterioară sau într-un jurnal separat al aplicației.

Un serviciu marcat `failed` poate să fi ieșit cu eroare, să nu fi putut porni ori să fi eșuat la o condiție declarată. Înainte de restart repetat, colectează logurile și notează modificarea recentă. Un restart poate face serviciul să pornească temporar, dar poate ascunde o configurare incorectă sau un crash repetitiv.

Compară sistemul de fișiere, utilizatorul unității și mediul de execuție cu sesiunea ta interactivă. Serviciul poate să nu aibă același PATH, director de lucru sau variabile. Căile relative care funcționează într-un shell pot eșua când unitatea pornește la boot.

Filtrează journalctl după unitate și timp

`journalctl -u nume.service` limitează mesajele la o unitate, iar filtrele de timp și boot te ajută să restrângi rezultatele. Verifică și pornirea curentă versus o pornire anterioară dacă problema a apărut după reboot. Păstrează timestampurile pentru a le corela cu logul web, PHP-FPM, baza de date și deploy-ul.

Jurnalul poate conține date sensibile sau detalii interne ale aplicației. Redactează parole, tokenuri și date ale utilizatorilor înainte să copiezi outputul către un canal de suport. Include suficiente linii dinainte și de după eroare, nu doar ultimul mesaj, fiindcă acesta poate fi o consecință.

Dacă nu găsești mesajul așteptat în journal, serviciul poate scrie într-un fișier separat sau poate avea o altă unitate. Consultă `ExecStart`, `StandardOutput` și configurația aplicației, apoi urmează sursa reală a logurilor.

Verifică unitatea și mediul de execuție

Inspectează unitatea și eventualele drop-in-uri pentru `User`, `Group`, `WorkingDirectory`, `EnvironmentFile`, `ExecStart` și dependențe. Folosește un utilizator cu privilegii minime și asigură-te că poate citi configurarea și scrie numai în directoarele necesare. Fișierele cu secrete trebuie să aibă permisiuni restrictive.

Dacă schimbi unitatea, verifică sintaxa și cere systemd să reîncarce fișierele de unități înainte să repornești serviciul. Păstrează copia anterioară și verifică logurile după aplicare. Nu modifica unitatea de sistem direct dacă distribuția oferă o cale de override mai sigură.

Pentru un serviciu web, testează endpointul local și apoi traficul prin proxy. Un proces activ nu garantează că portul este accesibil sau că TLS și hostname-ul sunt configurate corect. Corelează 502/503 cu starea upstream-ului și logul serverului web.

Folosește restarturile și timer-ele cu grijă

Politica `Restart=` poate porni din nou un serviciu după o terminare, însă nu repară eroarea din cod sau configurație. Urmărește numărul de restarturi și alertează când apar cicluri repetate. Dacă aplicația are stare locală ori sarcini care nu pot rula simultan, verifică comportamentul la terminare și pornire.

Timerele systemd pot lega sarcinile programate de unități și jurnalizare, iar unele pot recupera o execuție ratată dacă sunt configurate corespunzător. Decide dacă o rulare întârziată este sigură și idempotentă; un import sau un e-mail trimis de două ori poate produce efecte nedorite. Testează restartul VPS-ului înainte să te bazezi pe recuperarea automată.

Întrebări frecvente

Cum văd logurile numai pentru serviciul meu?

Folosește filtrul de unitate `journalctl -u nume.service`, apoi restrânge la timpul ori bootul relevant.

De ce aplicația merge în shell dar nu ca serviciu?

Mediul, directorul de lucru, PATH-ul și permisiunile diferă. Declară căile și utilizatorul necesare explicit în unitate.

Restart=on-failure repară serviciul?

Nu, doar poate relansa procesul după un eșec. Identifică și remediază cauza și urmărește restarturile repetate.

Surse și documentare

Explicație editorială generală, bazată pe documentația de mai jos. Configurația concretă și condițiile furnizorului pot diferi. Documentare: 22 noiembrie 2026.