NOUVEAU Migration gratuite en 24h sur tous les packs d'hébergement
Git, Laravel & Node.js

Diagnostiquer une application en production à partir de ses journaux

Où Plesk range les journaux de votre site, comment lire une ligne d’Apache, de nginx, de PHP, de Laravel ou de Node.js, et comment remonter d’une erreur 500, 502 ou 503 jusqu’à la ligne de code ou à la limite qui l’a provoquée.

Guide NovaHosterÀ jour au 30 octobre 2026 (Plesk Obsidian, Laravel 13)

Avant d’ouvrir un journal : trois relevés

Un journal répond vite à une question précise, et très mal à une plainte vague. « Le site plante » ne se cherche pas ; « envoi du formulaire de commande, réponse 500, jeudi à 10 h 14 » se retrouve en quelques secondes. Avant d’ouvrir quoi que ce soit, relevez trois choses.

  1. La minute exacte, et son fuseau. Reproduisez l’erreur vous-même et notez l’heure à la minute près. La Tunisie est à UTC+1 toute l’année : la dernière heure d’été de la zone Africa/Tunis date de 2008 [1]. Or tous les journaux ne sont pas à l’heure de Tunis, à commencer par celui de Laravel, en UTC dans sa configuration livrée : une erreur vue à 10 h 14 à Sfax s’y lit 09:14. Ceux du serveur web suivent le fuseau de la machine. Le journal d’accès note son écart à UTC juste après l’heure de chaque ligne, le journal d’erreurs ne l’écrit pas : lisez cet écart, quel qu’il soit, et appliquez-le aux deux avant de les rapprocher d’un autre journal.
  2. L’adresse et la méthode. L’URL complète, et la nature de la requête : affichage d’une page (GET) ou envoi d’un formulaire (POST). Une même adresse peut s’afficher sans souci et échouer à l’envoi.
  3. Le code HTTP. L’onglet Réseau des outils de développement du navigateur (touche F12) l’affiche pour chaque requête. C’est lui qui désigne le premier journal à ouvrir, comme le montre le tableau plus bas.

Si l’erreur ne touche qu’un client, demandez-lui l’heure et ce qu’il était en train de faire : ces deux informations valent mieux qu’une capture d’écran.

La méthode vaut pour une application hébergée sur un pack comme sur un serveur VPS ; la mise en ligne du code lui-même relève du guide pour déployer une application depuis Git.

Où sont les journaux, selon votre formule

Tous les packs NovaHoster s’administrent avec Plesk, qui rassemble les journaux d’un site dans un seul écran, l’explorateur de journaux [2]. Ce qui varie d’une formule à l’autre, ce sont les accès en plus.

FormuleCe que vous pouvez lirePar quel chemin
Pack STARTRequêtes et erreurs du serveur web, erreurs PHP, fichiers de journal écrits par votre applicationPlesk : explorateur de journaux et Gestionnaire de fichiers. Pas d’accès SSH à ce palier.
Packs BUSINESS et ULTIMATELes mêmes, plus les messages d’une application Node.jsPlesk, et la ligne de commande par SSH, ouvert sur demande
Serveur VPSTout, y compris le journal du système et celui de chaque serviceSSH, avec l’accès root

Le détail de Git, de SSH et de Node.js par palier figure dans la grille des packs d’hébergement. Les formules WordPress, e-commerce et revendeur ont leur propre répartition : celle des boutiques, par exemple, ouvre SSH dès START.

L’explorateur de journaux de Plesk

Ouvrez Sites Web & Domaines, puis, sur la fiche du domaine, le bouton Journaux (Logs, selon la version de l’interface). L’écran mêle par défaut les messages de six fichiers [2] :

  • access_log et access_ssl_log : chaque requête HTTP et HTTPS traitée par Apache ;
  • error_log : les erreurs d’Apache et ses informations de diagnostic, où arrivent aussi, le plus souvent, celles de PHP ;
  • proxy_access_log et proxy_access_ssl_log : les mêmes requêtes vues par nginx, le serveur mandataire placé devant Apache ;
  • proxy_error_log : les erreurs de nginx, celles qui expliquent les 502 et les 504.

Trois commandes y font gagner du temps. Le menu des fichiers, à droite, filtre la liste : pour une 502, ne gardez que les deux journaux d’erreurs. Lancer les mises à jour en temps réel fait défiler les nouvelles lignes : reproduisez l’erreur dans un autre onglet et regardez la sienne arriver. Gérer les fichiers de log, enfin, liste les fichiers suivis, avec de quoi ouvrir ou télécharger chacun en entier [2].

Les mêmes fichiers se trouvent dans le Gestionnaire de fichiers, sous l’entrée Logs du volet de navigation [3] ; un fichier texte de votre site s’y ouvre aussi dans l’explorateur, par l’option Ouvrir dans l’explorateur de log [2].

Faire entrer le journal de l’application

Par défaut, l’explorateur ne lit que le serveur web. Pour y voir aussi votre application :

  • si la fiche du domaine porte un bouton Laravel (extension Laravel Toolkit), son entrée Journaux ouvre l’explorateur sur les seules entrées du journal Laravel [4] ;
  • sinon, dans Gérer les fichiers de log, le bouton Ajouter un fichier de log personnalisé accepte n’importe quel fichier texte du site, storage/logs/laravel.log par exemple. Deux conditions : chaque entrée doit porter un horodatage, sans quoi Plesk l’analyse mal, et la rotation de Plesk ne s’applique pas à ces fichiers [2] ; c’est à l’application d’en limiter la taille ;
  • pour une application Node.js, rien à ajouter : ses entrées s’affichent d’office avec les autres. Pour les isoler, ouvrez le menu Tous les journaux et ne laissez coché que Node.js [5].

Combien de temps ils restent

Les fichiers du serveur web tournent : le réglage Rotation des logs, dans Gérer les fichiers de log, compresse ou supprime les anciens selon les critères choisis, et seuls les fichiers déjà tournés peuvent être effacés à la main [2]. Dès qu’un incident risque d’avoir des suites — intrusion soupçonnée, litige avec une passerelle de paiement, réclamation d’un client —, téléchargez les fichiers de la période sans attendre la rotation suivante.

Le code HTTP dit par où commencer

Sous Plesk, nginx reçoit la requête ; selon le réglage du domaine, il la passe à Apache ou directement à PHP [6], et une application Node.js tourne à part, démarrée par Phusion Passenger, que Plesk configure [7]. Chaque code d’erreur désigne la couche qui a renoncé, donc le premier journal à lire.

CodeCe qu’il veut direLe journal à ouvrir d’abord
500Le serveur a rencontré une condition inattendue [8] : le plus souvent une exception de l’application, une erreur fatale de PHP ou une directive invalide d’un .htaccess [9].error_log, où une erreur de .htaccess cite le chemin du fichier fautif [9] ; puis le journal de l’application (storage/logs pour Laravel).
502nginx a reçu une réponse invalide de ce qu’il interroge [8], ou n’a pas pu s’y connecter [10] : processus arrêté, planté ou saturé. Si PHP est servi par Apache, une panne de PHP-FPM donne une 503, pas une 502.proxy_error_log, où se lisent connect() … failed [11] ou upstream prematurely closed connection [10] ; puis le journal Node.js ou PHP à la même seconde.
503Service momentanément indisponible [8] : PHP-FPM injoignable ou saturé quand PHP est servi par Apache [12], site suspendu dans Plesk [13], application Laravel en maintenance [14], ou limites de ressources du compte atteintes.L’état du site sur sa fiche Plesk, puis error_log, où AH01079: failed to make connection to backend signale un PHP-FPM injoignable [12] ; access_log date le début. Laravel n’écrit rien dans son journal pendant une maintenance.
504Le serveur n’a pas obtenu de réponse à temps [8] : le script tourne encore, retenu par un traitement lent.proxy_error_log : upstream timed out [10] ; si PHP est servi par Apache, la 504 peut venir d’Apache, et error_log porte alors AH01075: Error dispatching request [12]. Cherchez ensuite ce que faisait la page : requête SQL lourde, export, appel à une API extérieure.
508Le compte a atteint sa limite de requêtes simultanées.Les limites du compte, présentées plus bas.
404 après une mise en ligneFichier ou route introuvable.access_log : avec son niveau de journalisation par défaut, Apache 2.4 n’inscrit plus les fichiers introuvables dans son journal d’erreurs [15]. Vérifiez ensuite la racine du document du domaine.
403Accès refusé : droits d’un fichier, règle d’un .htaccess ou pare-feu applicatif.error_log ; si la ligne reste muette, notez l’heure et l’adresse et transmettez-les au support plutôt que de désactiver une protection.

Lire une ligne du journal d’accès

Le journal d’accès répond à la question de départ : la requête est-elle arrivée, et qu’a-t-elle reçu ? Il suit un format dérivé de « combined », celui que la documentation d’Apache décrit champ par champ et que nginx emploie par défaut [15] [16] ; Plesk y a sa variante, nommée « plesklog » [17]. Une commande qui échoue y laisse une ligne de ce genre :

203.0.113.42 - - [29/Oct/2026:10:14:07 +0100] "POST /commande/valider HTTP/1.1" 500 1324 "https://www.votre-domaine.tn/panier" "Mozilla/5.0 (Linux; Android 14) …"
  • 203.0.113.42 : l’adresse du client, ou celle d’un intermédiaire placé entre lui et le serveur [15] ; celle de l’exemple appartient à une plage réservée à la documentation [18] ;
  • les deux tirets : l’identité et l’utilisateur authentifié, presque toujours vides ;
  • [29/Oct/2026:10:14:07 +0100] : l’heure de réception et son écart à UTC, qui dépend du fuseau réglé sur le serveur. Ramenez-le à l’heure de Tunis, UTC+1 : avec +0100, vous y êtes ; avec +0000, ajoutez une heure ; avec +0200, retirez-en une ;
  • "POST /commande/valider HTTP/1.1" : la méthode, le chemin avec ses éventuels paramètres, le protocole ;
  • 500 puis 1324 : le code renvoyé, puis la taille de la réponse en octets. Dans access_log, Plesk compte les en-têtes avec la réponse (%O) dès que le module mod_logio d’Apache est chargé [17] ; le format « combined » de nginx ne compte que le corps [16] [19] ;
  • les deux derniers champs : la page d’où venait le visiteur, et l’identification de son navigateur.

Trois lectures donnent l’essentiel. Des 500 sur un même chemin, à toute heure : une erreur de code ou de configuration, que vous reproduirez sans peine. Des 500 ou des 504 groupées sur quelques minutes, sur des pages variées : une ressource saturée ou un service extérieur lent. Une même adresse qui enchaîne les requêtes à la seconde vers des pages inexistantes : un robot qui cherche une faille, à signaler plutôt qu’à combattre à la main.

Un cas fréquent : le paiement accepté, la commande en attente

Le client a payé, la passerelle confirme, mais la commande reste « en attente » sur la boutique. La passerelle devait appeler votre adresse de notification, de serveur à serveur ; le journal d’accès dit si elle l’a fait. Cherchez cette adresse autour de l’heure du paiement :

  • une ligne POST suivie de 200 : la notification est arrivée et a été acceptée ; le blocage se situe dans le traitement de la commande, côté application ;
  • une ligne avec 403, 404 ou 500 : elle est arrivée et a été refusée ; le code dit par quelle couche ;
  • aucune ligne : elle n’a jamais atteint le serveur ; vérifiez l’adresse déclarée chez la passerelle, puis interrogez celle-ci, relevé à l’appui.

Ce relevé daté, c’est ce que demande le service technique d’une passerelle. L’article sur le paiement en ligne en Tunisie explique le rôle de cette notification et ce qui peut la bloquer.

Lire le journal d’erreurs du serveur web

Une ligne d’error_log se lit de gauche à droite : la date, le module et la gravité, le processus, le client, puis le message [15]. Voici une erreur PHP telle qu’Apache la consigne quand le domaine utilise un gestionnaire FPM servi par Apache :

[Thu Oct 29 10:14:07.512093 2026] [proxy_fcgi:error] [pid 41873] [client 203.0.113.42:51022] AH01071: Got error 'PHP message: PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in …/httpdocs/app/Services/Export.php on line 87'
  • proxy_fcgi:error : le module d’Apache qui passe les scripts à PHP-FPM, et la gravité « error » ;
  • AH01071: Got error : le message par lequel ce module recopie ce que PHP a écrit sur sa sortie d’erreur [12] ;
  • PHP message: : le préfixe que PHP-FPM place devant les messages de PHP [20] ;
  • enfin l’erreur elle-même, au format PHP type: message in fichier on line n, où le type vaut Fatal error, Warning, Parse error, Notice ou Deprecated [21] — ici, une erreur fatale dans Export.php, ligne 87.

Le début de la ligne dépend du gestionnaire PHP choisi sur la page PHP du domaine [6]. Avec un gestionnaire FPM servi par nginx, la même erreur s’inscrit dans proxy_error_log, derrière la mention FastCGI sent in stderr [22]. Avec le gestionnaire « FastCGI application », toujours servi par Apache [6], elle reste dans error_log mais commence par [fcgid:warn] et mod_fcgid: stderr: [23]. Dans les trois cas, cherchez PHP Fatal error (ou PHP Warning) : le fichier et la ligne suivent.

Deux erreurs PHP qui ne viennent pas d’un bogue

  • Allowed memory size of … bytes exhausted : le script a atteint la limite memory_limit, 128 Mo par défaut, soit les 134 217 728 octets de l’exemple [24] [25]. Un export complet, un redimensionnement d’image, une requête qui charge toute une table en mémoire en sont les causes habituelles.
  • Maximum execution time of 30 seconds exceeded : le script a dépassé max_execution_time, 30 secondes par défaut [26] [27]. Sous Linux, ce délai ne compte pas le temps passé à attendre une requête SQL ou une API extérieure [26] : un script bloqué sur un service lent finit le plus souvent en 504, et relever la limite n’y change rien.

Ces deux limites se règlent sur la page PHP du domaine, si votre abonnement vous en laisse l’accès [28] ; le guide pour se connecter à Plesk montre où la trouver. Mais relever une limite ne fait que repousser l’échéance quand un script charge trop de données : ouvrez d’abord le fichier et la ligne indiqués.

Ne passez pas display_errors à On pour lire l’erreur à l’écran : la documentation de PHP réserve cet affichage au développement et recommande, sur un site en ligne, de journaliser plutôt que d’afficher [29]. Ce que l’écran montrerait est déjà dans le journal.

Laravel : où il écrit, et comment lire une exception

Le fichier, et ce qui décide de son contenu

Avec la configuration livrée par Laravel 13, tout part dans storage/logs/laravel.log : le canal par défaut, stack, ne contient que le canal single [30]. Trois variables du .env changent ce comportement.

  • LOG_STACK=daily : un fichier par jour, nommé par exemple laravel-2026-10-29.log [31], dont Laravel garde les 14 derniers, nombre réglable par LOG_DAILY_DAYS [30]. C’est le bon choix sur un pack : le fichier cesse de grossir sans fin.
  • LOG_LEVEL : le niveau minimal enregistré. Laravel reprend les huit niveaux de la RFC 5424, d’emergency à debug [32] ; avec LOG_LEVEL=error, un Log::warning() ou un Log::info() ne laisse aucune trace. C’est une cause fréquente d’un journal qui paraît vide.
  • LOG_CHANNEL : avec errorlog, les messages partent vers le journal d’erreurs de PHP, donc, sur un pack, vers les journaux du serveur web ; avec syslog, vers le journal du système, qu’un pack ne vous montre pas [32]. Dans les deux cas, storage/logs reste vide.

Si Laravel ne peut pas écrire son fichier, il ne peut pas non plus s’en plaindre dans ce fichier : la page répond en général 500, et la cause se lit dans error_log, sous la forme d’un message de Monolog, la bibliothèque qui écrit les journaux de Laravel : The stream or file "…/storage/logs/laravel.log" could not be opened in append mode [33]. Laravel doit pouvoir écrire dans storage et bootstrap/cache [34] : après un envoi par FTP ou l’extraction d’une archive, vérifiez les droits de ces deux dossiers.

Anatomie d’une entrée

Une exception enregistrée par Laravel ressemble à ceci, chemins raccourcis :

[2026-10-29 09:14:07] production.ERROR: Undefined array key "gouvernorat" {"userId":42,"exception":"[object] (ErrorException(code: 0): Undefined array key \"gouvernorat\" at …/app/Http/Controllers/LivraisonController.php:31)
[stacktrace]
#0 …/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/HandleExceptions.php(…): …
#1 …/app/Http/Controllers/LivraisonController.php(31): …
#2 …/vendor/laravel/framework/src/Illuminate/Routing/ControllerDispatcher.php(…): App\\Http\\Controllers\\LivraisonController->store(…)
…
"}
  1. [2026-10-29 09:14:07] : l’heure, dans le fuseau de l’application. Laravel applique app.timezone à PHP dès le démarrage [35], Monolog date ses lignes dans ce fuseau [36], et le squelette de Laravel 13 le fixe à UTC [37]. 09:14 ici, c’est 10:14 à Tunis.
  2. production.ERROR : le nom du canal, qui reprend celui de l’environnement (APP_ENV) [38], puis le niveau. Si vous lisez local.ERROR sur le site en ligne, l’application tourne avec un .env de développement, sans doute avec le mode debug actif : corrigez-le avant toute chose, en suivant le guide sur les variables d’environnement.
  3. Le message, puis, entre accolades, le contexte : userId, que Laravel ajoute de lui-même quand un utilisateur est connecté [39], et l’exception, avec sa classe, son code, son message, le fichier et la ligne où elle est née [40].
  4. [stacktrace] : la pile d’appels, de l’appel le plus récent, #0, au plus ancien [40]. Les premières lignes passent souvent par vendor/, le code du framework : descendez jusqu’à la première qui pointe dans app/. C’est votre code. Ici, la ligne 31 du contrôleur des livraisons lit un champ « gouvernorat » que le formulaire n’a pas envoyé.

Une exception de base de données emporte le code d’erreur de MySQL ou de MariaDB, qui oriente aussitôt : 1045, accès refusé, donc identifiants du .env à revoir [41] ; 1146, table inexistante, souvent une migration qui n’a pas été jouée [42] ; 1040, trop de connexions simultanées [41].

Ce que Laravel n’écrit pas

Laravel écarte d’office certaines exceptions : les 404, les 403 dues à une origine refusée, les 419 d’un jeton CSRF invalide [39], et plus largement les exceptions HTTP, d’authentification, d’autorisation et de validation [43]. Une application en maintenance (php artisan down) répond 503 au moyen d’une exception HTTP [14] : rien non plus dans laravel.log. Pour tous ces codes, c’est le journal d’accès qui fait foi.

Donner un numéro à chaque requête

Quand plusieurs visiteurs rencontrent la même erreur à la même seconde, l’heure ne suffit plus à isoler un cas. La documentation de Laravel propose un intergiciel qui attribue un identifiant à chaque requête, l’ajoute à toutes les lignes du journal avec Log::withContext() et le renvoie dans l’en-tête Request-Id de la réponse [32] :

// app/Http/Middleware/AssignRequestId.php, dans la méthode handle()
$requestId = (string) Str::uuid();

Log::withContext([
    'request-id' => $requestId,
]);

$response = $next($request);
$response->headers->set('Request-Id', $requestId);

return $response;

Le client retrouve cet identifiant dans l’onglet Réseau de son navigateur ; vous le cherchez dans le journal, et vous tombez sur sa requête, pas sur celle d’un autre.

Garder les secrets hors du journal

Une pile d’appels peut recopier les arguments des fonctions : PHP ne les retire que si la directive zend.exception_ignore_args est activée [24]. Un mot de passe passé à une fonction de connexion peut donc finir en clair dans le fichier. Depuis PHP 8.2, l’attribut #[\SensitiveParameter] remplace la valeur du paramètre marqué par un objet SensitiveParameterValue dans les piles d’appels [44] :

public function connecter(string $identifiant, #[\SensitiveParameter] string $motDePasse): bool

Même règle pour vos propres messages : un Log::info() peut citer le numéro d’une commande ou d’un client, jamais un jeton, un mot de passe ou un numéro de carte.

Node.js : ce que l’application écrit, et ce qui l’arrête

Une application Node.js ne tient pas de journal d’elle-même : ce qu’elle écrit avec console.log() part sur la sortie standard, ce qu’elle écrit avec console.error() sur la sortie d’erreur [45]. Sur nos packs, Plesk affiche les journaux de l’application dans l’explorateur du domaine, sous l’étiquette Node.js [5] : c’est là que vous les lirez, et c’est donc là que vos messages doivent être utiles.

Écrire des lignes qu’on retrouve

Une bonne ligne porte l’heure, un niveau, un message court et ce qu’il faut pour rejouer le cas : l’identifiant de la commande, la route, la durée d’un appel. Une ligne JSON par événement se filtre ensuite en un clin d’œil :

// journal.js : une ligne JSON par événement
function journal(niveau, message, details = {}) {
  const ligne = JSON.stringify({ heure: new Date().toISOString(), niveau, message, ...details });
  if (niveau === 'error') console.error(ligne);
  else console.log(ligne);
}

// Consigne une exception fatale sans empêcher l’arrêt du processus
process.on('uncaughtExceptionMonitor', (err, origine) => {
  journal('error', err.message, { origine, pile: err.stack });
});

module.exports = journal;

toISOString() donne l’heure en UTC, avec le suffixe Z [46] : ajoutez une heure pour Tunis. L’écouteur uncaughtExceptionMonitor observe une exception fatale sans rien changer à la suite [47] : le processus s’arrête quand même, mais vous savez pourquoi. N’employez pas uncaughtException pour continuer coûte que coûte : la documentation de Node.js le réserve au nettoyage avant l’arrêt, l’application se trouvant alors dans un état indéterminé [47].

Lire un arrêt

Sans écouteur, une exception non rattrapée imprime sa pile sur la sortie d’erreur et arrête le processus avec le code de sortie 1 [47]. Depuis Node.js 15, une promesse rejetée sans gestionnaire, c’est-à-dire un appel asynchrone dont l’échec n’est rattrapé nulle part, prend le même chemin par défaut [48]. Un code de sortie supérieur à 128 signale un arrêt par un signal : 128 plus le numéro du signal [47]. Sur un VPS, 137 correspond ainsi à SIGKILL (9), un arrêt que l’application ne peut pas intercepter [47].

Les codes d’erreur système de Node.js orientent vite la recherche [49] :

CodeCe qu’il signifieOù chercher
MODULE_NOT_FOUND (ERR_MODULE_NOT_FOUND pour un module ES)Un module demandé est introuvable.Dépendances absentes sur le serveur : bouton NPM Install de la page Node.js de Plesk [5].
ECONNREFUSEDLa machine visée a refusé la connexion : rien n’écoute à cette adresse.Hôte ou port de la base erroné, à relever dans Plesk, page Bases de données, Infos de connexion [50] ; ou service extérieur arrêté.
ENOTFOUNDLa résolution DNS a échoué.Nom d’hôte mal saisi dans une variable, ou domaine d’une API qui n’existe plus.
ETIMEDOUTLa partie distante n’a pas répondu à temps.API extérieure lente ou injoignable : donnez un délai à vos appels et journalisez leur durée.
EADDRINUSEL’adresse est déjà occupée par un autre serveur.Sur un VPS, une ancienne instance tourne encore. Sur un pack, Passenger attribue le port : un second serveur HTTP y échoue plutôt sur http.Server.listen() was called more than once [51], comme l’explique le guide sur les variables d’environnement.
EACCES, ENOENTDroits insuffisants ; fichier ou dossier inexistant.Chemin relatif résolu depuis un autre dossier que prévu, dossier d’envoi jamais créé au déploiement.

La mémoire

Pour savoir si l’application enfle, journalisez de temps à autre process.memoryUsage() : un heapUsed qui monte sans jamais redescendre peut signaler une fuite de mémoire [52]. Sur un VPS, l’option --max-old-space-size agrandit la partie du tas où vivent les objets durables [52] ; elle ne fait que reculer l’échéance si quelque chose fuit.

Quand le code n’y est pour rien : les limites du compte

Sur un pack, CloudLinux encadre les ressources de chaque compte : processeur, mémoire, processus, requêtes simultanées. Une application sans défaut peut donc échouer parce qu’elle a buté sur l’une de ces limites. Les indices : des erreurs groupées aux heures chargées, des 503 ou des 508 sans la moindre exception dans le journal de l’application, un processus Node.js qui redémarre sans un mot. Comparez l’heure des erreurs avec le suivi des ressources, s’il figure dans votre Plesk, puis lisez le guide sur CloudLinux, LVE et CageFS, qui explique chaque limite et l’erreur 508.

Deux autres plafonds se lisent directement dans les messages : ceux de PHP, vus plus haut, et l’espace disque. Un journal qu’on ne fait jamais tourner finit par remplir l’espace du pack, et plus rien ne s’écrit, ni les fichiers envoyés par vos visiteurs, ni le journal lui-même. Le canal daily de Laravel et la rotation de Plesk servent précisément à l’éviter.

Sur un serveur VPS : le journal du système

Avec l’accès root d’un serveur VPS, tout se lit, y compris ce qu’un pack ne montre pas. Sur une distribution qui utilise systemd, comme Ubuntu, chaque service écrit dans le journal du système, que l’on interroge avec journalctl [53] :

# Erreurs du service de l’application, sur la plage de l’incident
journalctl -u mon-app.service --since "2026-10-29 10:00" --until "2026-10-29 10:30" -p err

# Suivre en direct pendant que vous reproduisez l’erreur
journalctl -u mon-app.service -f

# Messages du noyau depuis minuit, dans le démarrage en cours
journalctl -k --since today

# Messages du noyau du démarrage précédent (après un redémarrage)
journalctl -k -b -1

-u filtre une unité, --since et --until bornent la période, -p err ne garde que les erreurs et ce qui est plus grave, -f affiche les nouvelles entrées au fil de l’eau, -k se limite aux messages du noyau, à consulter quand un processus disparaît sans rien écrire [53]. Attention : -k ne lit que le démarrage en cours, sauf mention contraire [53]. Si la machine a redémarré après l’incident, ce qui arrive souvent après un manque de mémoire, ajoutez -b -1 pour lire le démarrage précédent. Les heures s’entendent dans le fuseau du serveur ; --utc les affiche en UTC, pratique pour les rapprocher d’un journal Laravel [53]. nginx, Apache et la base de données tiennent en général leurs propres fichiers sous /var/log, à l’emplacement que fixe leur configuration.

Si votre application Node.js tourne sous PM2 plutôt que comme service systemd, ses journaux sont dans $HOME/.pm2/logs, un fichier pour la sortie standard et un pour la sortie d’erreur ; pm2 logs mon-app --lines 200 affiche les dernières lignes, puis la suite en direct [54].

Le support d’un VPS couvre la machine, le réseau et une aide sur les accès ; le débogage de votre application n’en fait pas partie, même avec l’infogérance, qui vous indique si la panne vient du serveur ou du code.

Corriger sans effacer la trace

  1. Copier avant de toucher. Une rotation, un redémarrage ou un nettoyage peuvent emporter les lignes utiles : copiez-les d’abord. Si une intrusion est possible, copiez journaux et fichiers tels quels avant tout nettoyage, comme le rappelle notre article sur la faille PHP2Shell.
  2. Un changement à la fois. Modifiez une seule chose, puis rejouez exactement le même test, à la même adresse. Sinon, vous ne saurez jamais laquelle a réglé le problème, ni laquelle en a créé un autre.
  3. Un test qui répond par oui ou par non. Pour Laravel, la route /up renvoie 200 si l’application a démarré sans exception, 500 sinon [34] : testez-la avant la page qui posait problème. Elle n’existe que si bootstrap/app.php la déclare (health: '/up'), comme le fait le squelette actuel de Laravel [55] ; une application mise à niveau depuis une version plus ancienne peut ne pas l’avoir.
  4. Redémarrer n’est pas réparer. Relancer l’application efface un temps les symptômes d’une fuite de mémoire, pas la fuite. Notez l’heure de chaque redémarrage : si l’erreur revient au même rythme, vous tenez une piste.
  5. Revenir au niveau habituel. Un LOG_LEVEL=debug oublié en production remplit le disque et noie les erreurs dans le bruit : rétablissez le niveau normal dès le diagnostic terminé.

Questions fréquentes

Pourquoi le journal de Laravel a-t-il une heure de retard sur Tunis ?
Parce que Laravel date ses lignes dans le fuseau de l’application, UTC dans la configuration livrée, alors que la Tunisie vit à UTC+1 toute l’année. Une erreur survenue à 15 h 20 à Tunis s’y écrit donc 14:20. Le journal d’accès du serveur, lui, note son écart à UTC juste après l’heure, et cet écart dépend du fuseau réglé sur la machine. Ramenez-le à UTC+1 avant de rapprocher deux journaux : avec +0000, ajoutez une heure ; avec +0100, c’est l’heure de Tunis ; avec +0200, retirez une heure.
Une erreur 404 ou 419 n’apparaît pas dans laravel.log : est-ce normal ?
Oui. Laravel n’enregistre pas, par défaut, les exceptions HTTP, dont les 404 et les 419 nées d’un jeton CSRF expiré, ni celles d’authentification ou de validation. Ces requêtes se lisent dans le journal d’accès. Pour les voir aussi dans laravel.log, la méthode stopIgnoring, appelée dans bootstrap/app.php, lève cette exclusion.
Quelle différence entre une erreur 502 et une erreur 504 ?
Le plus souvent, elles viennent de nginx, qui attend la réponse de PHP ou de l’application. Une 502 veut dire qu’il a reçu une réponse invalide ou n’a pas pu se connecter : le processus est arrêté, a planté ou refuse la connexion. Une 504 veut dire qu’il a attendu trop longtemps : le processus tourne, mais un traitement lent le retient. Dans proxy_error_log, une 502 s’accompagne d’un message « connect() … failed » ou de « upstream prematurely closed connection », une 504 de « upstream timed out ». Si PHP est servi par Apache, Apache peut répondre lui-même : 503 quand il ne joint pas PHP-FPM (AH01079), 504 quand son propre délai est dépassé (AH01075), et les deux se lisent dans error_log.
Combien de temps les journaux restent-ils consultables ?
Ceux du serveur web suivent la rotation réglée dans Plesk, sous Gérer les fichiers de log, puis Rotation des logs : les anciens fichiers y sont compressés ou supprimés. Ceux de Laravel dépendent du canal : single grossit sans fin, daily garde 14 fichiers dans la configuration livrée. Téléchargez sans attendre tout ce qui concerne un incident.
Peut-on afficher les erreurs à l’écran le temps de trouver la panne ?
Pas sur un site en ligne. La documentation de PHP réserve display_errors au développement, et celle de Laravel prévient qu’APP_DEBUG=true peut montrer des valeurs de configuration sensibles aux visiteurs. Ce que l’écran afficherait figure déjà dans error_log et dans storage/logs ; pour expérimenter, travaillez sur une copie de préproduction.
Le support peut-il trouver le bug de mon application ?
Il examine tout ce qui relève de l’hébergement — serveur, version et limites de PHP, ressources du compte, journaux du serveur — et vous aide à établir si la panne en vient. La correction du code reste à votre charge : les conditions générales de vente vous confient la maintenance applicative. Avec l’infogérance d’un VPS ou d’un dédié, l’équipe administre le système et les services et vous dit si la panne vient du serveur ou du code, mais elle ne modifie pas votre application.

Écrire au support avec un extrait exploitable

Le livechat et les tickets répondent 7j/7, en français comme en tunisien. Pour une panne, préférez le ticket, ouvert depuis l’espace client dans le département technique : il garde l’historique de l’échange. Joignez-y :

  • le domaine, l’adresse exacte, la méthode (GET ou POST) et le code HTTP obtenu ;
  • l’heure de l’erreur, en précisant « heure de Tunis » ou « UTC » ;
  • une vingtaine de lignes de journal autour de l’erreur, copiées en texte plutôt qu’en capture : un texte se recherche, une image non ;
  • ce qui a changé juste avant : mise en ligne, mise à jour d’une extension, autre version de PHP, variable modifiée.

Masquez avant d’envoyer : mots de passe, jetons, clés d’API, cookies de session, en-têtes d’autorisation, et les données personnelles de vos clients. Le support examine ce qui relève de l’hébergement — serveur, PHP, ressources du compte, journaux du serveur ; la maintenance applicative reste à votre charge, comme le prévoit l’article 7.3 des conditions générales de vente. L’infogérance d’un VPS ou d’un dédié administre le système et les services et vous dit si la panne vient du serveur ou du code, mais elle ne modifie pas votre application. Le guide pour ouvrir une demande de support fournit un modèle complet.

Guides liés

Pour aller plus loin

Les documentations officielles et le code source sur lesquels ce guide s’appuie, dans l’ordre où il les cite : Plesk, Apache et mod_fcgid, nginx, PHP, Laravel et Monolog, Node.js, Phusion Passenger et PM2, systemd, ainsi que les RFC de l’IETF :

  1. IANA, base des fuseaux horaires — fichier « africa », règles de la zone Africa/Tunis
  2. Documentation Plesk Obsidian — Fichiers de log : explorateur, rotation, journaux personnalisés
  3. Documentation Plesk Obsidian — Afficher le log d’erreurs du site Web
  4. Documentation Plesk Obsidian — Laravel Toolkit : journaux, mode Maintenance
  5. Documentation Plesk Obsidian — Héberger des applications Node.js : NPM Install, journaux
  6. Documentation Plesk Obsidian — gestionnaires PHP servis par Apache ou par nginx (en anglais)
  7. Base de connaissances Plesk — applications Node.js exécutées par Phusion Passenger (en anglais)
  8. RFC 9110, HTTP Semantics — codes 5xx : 500, 502, 503, 504 (en anglais)
  9. Documentation Apache HTTP Server 2.4 — fichiers .htaccess : erreur 500 et message dans le journal d’erreurs
  10. Code source de nginx — module upstream : messages « connect() failed », « upstream timed out » et codes 502 / 504
  11. Code source de nginx — ngx_event_connect.c : message « connect() to … failed »
  12. Code source d’Apache 2.4 — mod_proxy_fcgi : messages AH01071, AH01075 et AH01079, codes 503 et 504
  13. Documentation Plesk Obsidian — Website Status : site suspendu et page 503 (en anglais)
  14. Documentation Laravel 13 — configuration : mode maintenance et code 503
  15. Documentation Apache HTTP Server 2.4 — Log Files : journal d’erreurs, format « combined »
  16. Documentation nginx — module de journalisation, format « combined » par défaut
  17. Base de connaissances Plesk — format « plesklog » du journal d’accès d’Apache (%O avec mod_logio, %b sinon ; en anglais)
  18. RFC 5737 — plages d’adresses IPv4 réservées à la documentation
  19. Documentation nginx — variable $body_bytes_sent : octets envoyés, en-tête de réponse non compris
  20. Code source de PHP 8.4 — PHP-FPM, préfixe « PHP message: »
  21. Code source de PHP 8.4 — forme des messages d’erreur journalisés
  22. Code source de nginx — module FastCGI, message « FastCGI sent in stderr »
  23. Code source de mod_fcgid — fcgid_bucket.c : préfixe « mod_fcgid: stderr: »
  24. Manuel PHP — directives du cœur : memory_limit, zend.exception_ignore_args
  25. Code source de PHP 8.4 — message « Allowed memory size … exhausted »
  26. Manuel PHP — max_execution_time (30 secondes par défaut)
  27. Code source de PHP 8.4 — message « Maximum execution time … exceeded »
  28. Documentation Plesk Obsidian — Paramètres PHP d’un domaine
  29. Manuel PHP — display_errors et log_errors
  30. Squelette Laravel 13 — config/logging.php : canaux stack, single, daily, LOG_DAILY_DAYS
  31. Code source de Monolog — RotatingFileHandler : un fichier par jour, nom daté
  32. Documentation Laravel 13 — journalisation : canaux, niveaux, contexte et identifiant de requête
  33. Code source de Monolog — StreamHandler, message « could not be opened in append mode »
  34. Documentation Laravel 13 — déploiement : droits de storage et bootstrap/cache, route /up
  35. Code source de Laravel 13 — fuseau de PHP réglé sur app.timezone au démarrage
  36. Code source de Monolog — Logger : dates dans le fuseau par défaut de PHP
  37. Squelette Laravel 13 — config/app.php : fuseau UTC
  38. Code source de Laravel 13 — LogManager : nom du canal et format de date
  39. Documentation Laravel 13 — gestion des erreurs : contexte userId, exceptions ignorées
  40. Code source de Monolog — LineFormatter : forme d’une exception et de sa pile d’appels
  41. Documentation MariaDB — codes d’erreur 1000 à 1099 (1040, 1045)
  42. Documentation MariaDB — codes d’erreur 1100 à 1199 (1146)
  43. Code source de Laravel 13 — exceptions non rapportées par défaut
  44. Manuel PHP — attribut SensitiveParameter (PHP 8.2 et suivants)
  45. Documentation Node.js — console : sortie standard et sortie d’erreur
  46. MDN — Date.prototype.toISOString(), toujours en UTC
  47. Documentation Node.js — process : uncaughtException, uncaughtExceptionMonitor, codes de sortie, signaux
  48. Documentation Node.js — option --unhandled-rejections, comportement par défaut depuis la version 15
  49. Documentation Node.js — erreurs système courantes et MODULE_NOT_FOUND
  50. Documentation Plesk Obsidian — Afficher les informations de connexion d’une base
  51. Phusion Passenger — port d’une application Node.js, erreur « http.Server.listen() was called more than once » (en anglais)
  52. Node.js — comprendre et régler la mémoire : process.memoryUsage(), --max-old-space-size
  53. systemd — page de manuel de journalctl
  54. Documentation PM2 — journaux : dossier $HOME/.pm2/logs, commande pm2 logs (en anglais)
  55. Squelette Laravel 13 — bootstrap/app.php : route de santé déclarée par health: '/up'
Votre Plesk n’affiche pas ces journaux ?

Les boutons Journaux, Laravel et Node.js dépendent de votre formule et des extensions installées. Dites-nous ce que vous voyez : nous vous indiquons où lire.

Demander le bon chemin au support
Une erreur que vous n’arrivez pas à lire ?

Envoyez-nous la ligne : nous vérifions ce qui relève de l’hébergement.

Domaine, heure, code HTTP et une vingtaine de lignes de journal, secrets masqués : un technicien vérifie le serveur, PHP et les ressources du compte, puis vous dit où chercher la suite. Livechat et tickets 7j/7, en français ou en tunisien.