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.
- 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.
- 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.
- 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.
| Formule | Ce que vous pouvez lire | Par quel chemin |
|---|---|---|
| Pack START | Requêtes et erreurs du serveur web, erreurs PHP, fichiers de journal écrits par votre application | Plesk : explorateur de journaux et Gestionnaire de fichiers. Pas d’accès SSH à ce palier. |
| Packs BUSINESS et ULTIMATE | Les mêmes, plus les messages d’une application Node.js | Plesk, et la ligne de commande par SSH, ouvert sur demande |
| Serveur VPS | Tout, y compris le journal du système et celui de chaque service | SSH, 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_logetaccess_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_logetproxy_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.logpar 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.
| Code | Ce qu’il veut dire | Le journal à ouvrir d’abord |
|---|---|---|
| 500 | Le 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). |
| 502 | nginx 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. |
| 503 | Service 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. |
| 504 | Le 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. |
| 508 | Le 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 ligne | Fichier 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. |
| 403 | Accè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 ;500puis1324: le code renvoyé, puis la taille de la réponse en octets. Dansaccess_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
POSTsuivie de200: 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,404ou500: 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 dansExport.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 limitememory_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 exemplelaravel-2026-10-29.log[31], dont Laravel garde les 14 derniers, nombre réglable parLOG_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] ; avecLOG_LEVEL=error, unLog::warning()ou unLog::info()ne laisse aucune trace. C’est une cause fréquente d’un journal qui paraît vide.LOG_CHANNEL: avecerrorlog, les messages partent vers le journal d’erreurs de PHP, donc, sur un pack, vers les journaux du serveur web ; avecsyslog, vers le journal du système, qu’un pack ne vous montre pas [32]. Dans les deux cas,storage/logsreste 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(…)
…
"}[2026-10-29 09:14:07]: l’heure, dans le fuseau de l’application. Laravel appliqueapp.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.production.ERROR: le nom du canal, qui reprend celui de l’environnement (APP_ENV) [38], puis le niveau. Si vous lisezlocal.ERRORsur le site en ligne, l’application tourne avec un.envde développement, sans doute avec le mode debug actif : corrigez-le avant toute chose, en suivant le guide sur les variables d’environnement.- 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]. [stacktrace]: la pile d’appels, de l’appel le plus récent,#0, au plus ancien [40]. Les premières lignes passent souvent parvendor/, le code du framework : descendez jusqu’à la première qui pointe dansapp/. 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): boolMê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] :
| Code | Ce qu’il signifie | Où 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]. |
ECONNREFUSED | La 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é. |
ENOTFOUND | La résolution DNS a échoué. | Nom d’hôte mal saisi dans une variable, ou domaine d’une API qui n’existe plus. |
ETIMEDOUT | La 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. |
EADDRINUSE | L’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, ENOENT | Droits 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
- 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.
- 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.
- Un test qui répond par oui ou par non. Pour Laravel, la route
/uprenvoie 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 sibootstrap/app.phpla 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. - 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.
- Revenir au niveau habituel. Un
LOG_LEVEL=debugoublié 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 ?
Une erreur 404 ou 419 n’apparaît pas dans laravel.log : est-ce normal ?
Quelle différence entre une erreur 502 et une erreur 504 ?
Combien de temps les journaux restent-ils consultables ?
Peut-on afficher les erreurs à l’écran le temps de trouver la panne ?
Le support peut-il trouver le bug de mon 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 :
- IANA, base des fuseaux horaires — fichier « africa », règles de la zone Africa/Tunis
- Documentation Plesk Obsidian — Fichiers de log : explorateur, rotation, journaux personnalisés
- Documentation Plesk Obsidian — Afficher le log d’erreurs du site Web
- Documentation Plesk Obsidian — Laravel Toolkit : journaux, mode Maintenance
- Documentation Plesk Obsidian — Héberger des applications Node.js : NPM Install, journaux
- Documentation Plesk Obsidian — gestionnaires PHP servis par Apache ou par nginx (en anglais)
- Base de connaissances Plesk — applications Node.js exécutées par Phusion Passenger (en anglais)
- RFC 9110, HTTP Semantics — codes 5xx : 500, 502, 503, 504 (en anglais)
- Documentation Apache HTTP Server 2.4 — fichiers .htaccess : erreur 500 et message dans le journal d’erreurs
- Code source de nginx — module upstream : messages « connect() failed », « upstream timed out » et codes 502 / 504
- Code source de nginx — ngx_event_connect.c : message « connect() to … failed »
- Code source d’Apache 2.4 — mod_proxy_fcgi : messages AH01071, AH01075 et AH01079, codes 503 et 504
- Documentation Plesk Obsidian — Website Status : site suspendu et page 503 (en anglais)
- Documentation Laravel 13 — configuration : mode maintenance et code 503
- Documentation Apache HTTP Server 2.4 — Log Files : journal d’erreurs, format « combined »
- Documentation nginx — module de journalisation, format « combined » par défaut
- Base de connaissances Plesk — format « plesklog » du journal d’accès d’Apache (%O avec mod_logio, %b sinon ; en anglais)
- RFC 5737 — plages d’adresses IPv4 réservées à la documentation
- Documentation nginx — variable $body_bytes_sent : octets envoyés, en-tête de réponse non compris
- Code source de PHP 8.4 — PHP-FPM, préfixe « PHP message: »
- Code source de PHP 8.4 — forme des messages d’erreur journalisés
- Code source de nginx — module FastCGI, message « FastCGI sent in stderr »
- Code source de mod_fcgid — fcgid_bucket.c : préfixe « mod_fcgid: stderr: »
- Manuel PHP — directives du cœur : memory_limit, zend.exception_ignore_args
- Code source de PHP 8.4 — message « Allowed memory size … exhausted »
- Manuel PHP — max_execution_time (30 secondes par défaut)
- Code source de PHP 8.4 — message « Maximum execution time … exceeded »
- Documentation Plesk Obsidian — Paramètres PHP d’un domaine
- Manuel PHP — display_errors et log_errors
- Squelette Laravel 13 — config/logging.php : canaux stack, single, daily, LOG_DAILY_DAYS
- Code source de Monolog — RotatingFileHandler : un fichier par jour, nom daté
- Documentation Laravel 13 — journalisation : canaux, niveaux, contexte et identifiant de requête
- Code source de Monolog — StreamHandler, message « could not be opened in append mode »
- Documentation Laravel 13 — déploiement : droits de storage et bootstrap/cache, route /up
- Code source de Laravel 13 — fuseau de PHP réglé sur app.timezone au démarrage
- Code source de Monolog — Logger : dates dans le fuseau par défaut de PHP
- Squelette Laravel 13 — config/app.php : fuseau UTC
- Code source de Laravel 13 — LogManager : nom du canal et format de date
- Documentation Laravel 13 — gestion des erreurs : contexte userId, exceptions ignorées
- Code source de Monolog — LineFormatter : forme d’une exception et de sa pile d’appels
- Documentation MariaDB — codes d’erreur 1000 à 1099 (1040, 1045)
- Documentation MariaDB — codes d’erreur 1100 à 1199 (1146)
- Code source de Laravel 13 — exceptions non rapportées par défaut
- Manuel PHP — attribut SensitiveParameter (PHP 8.2 et suivants)
- Documentation Node.js — console : sortie standard et sortie d’erreur
- MDN — Date.prototype.toISOString(), toujours en UTC
- Documentation Node.js — process : uncaughtException, uncaughtExceptionMonitor, codes de sortie, signaux
- Documentation Node.js — option --unhandled-rejections, comportement par défaut depuis la version 15
- Documentation Node.js — erreurs système courantes et MODULE_NOT_FOUND
- Documentation Plesk Obsidian — Afficher les informations de connexion d’une base
- Phusion Passenger — port d’une application Node.js, erreur « http.Server.listen() was called more than once » (en anglais)
- Node.js — comprendre et régler la mémoire : process.memoryUsage(), --max-old-space-size
- systemd — page de manuel de journalctl
- Documentation PM2 — journaux : dossier $HOME/.pm2/logs, commande pm2 logs (en anglais)
- Squelette Laravel 13 — bootstrap/app.php : route de santé déclarée par health: '/up'
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