Lire les logs d'erreurs : diagnostiquer avant de paniquer
Les étapes en résumé
- 01 Localiser les journaux dans le panneau
- 02 Reproduire le problème en regardant le log
- 03 Lire le message de bas en haut et de droite à gauche
- 04 Traduire les erreurs récurrentes
- 05 Corriger, vérifier, puis nettoyer
Durée estimée : 30 min
Un site qui dysfonctionne écrit presque toujours pourquoi dans ses logs : type d’erreur, fichier, ligne, l’aveu complet. Savoir ouvrir ces journaux et les lire dans le bon ordre transforme la panique de l’écran blanc en diagnostic de cinq minutes, et la moitié des tickets support en corrections autonomes.
Scène fondatrice, vécue par tout le monde : page blanche un matin, rechargements frénétiques, recherche « site cassé que faire » dans un moteur. Pendant ce temps, la réponse patiente dans un fichier error_log, datée, localisée, explicite. Allons la chercher.
Deux familles de journaux, deux questions
Votre hébergement tient deux comptabilités distinctes, et les confondre fait perdre du temps.
Les logs d’erreurs applicatives d’abord (PHP en tête) répondent à « pourquoi la page a-t-elle échoué ? » : erreurs fatales, warnings, notices, avec fichier et ligne. On les trouve dans l’outil Erreurs du panneau et dans les fichiers error_log semés près des scripts fautifs ; chez O2switch, cPanel les expose proprement, test de la maison ici.
Viennent les logs d’accès HTTP, qui répondent à « qui a demandé quoi, avec quel résultat ? » : chaque requête, son code (200, 404, 500…), son origine. Précieux pour repérer un afflux anormal, une vague de 404 après refonte (les redirections se nourrissent de cette lecture) ou un robot agressif.
Le réflexe de tri : symptôme visible sur une page → erreurs applicatives ; question de trafic ou de codes → accès HTTP.
La méthode des cinq minutes
Un dysfonctionnement, cinq gestes, toujours les mêmes.
Ouvrez le journal d’erreurs, notez l’heure. Reproduisez le problème (la page qui casse, le formulaire qui échoue). Revenez au journal : la ou les lignes fraîches à l’horodatage correspondant SONT votre dossier.
Lisez alors la ligne d’erreur par ses trois informations, dans cet ordre : le type (Fatal error arrête tout ; Warning et Notice signalent sans bloquer), le message (souvent explicite : fonction inconnue, mémoire épuisée, fichier introuvable), et surtout le chemin du fichier en cause. Ce chemin parle : wp-content/plugins/quelque-chose désigne l’extension coupable, wp-content/themes votre thème, et la désactivation cible remplace avantageusement le tâtonnement général.
Corrigez, rejouez le scénario, constatez le silence du log. Diagnostic clos, et vous savez désormais POURQUOI, ce qui vaut tous les redémarrages superstitieux.
Petit lexique des messages fréquents
Quelques traductions qui couvrent l’essentiel du quotidien mutualisé. « Allowed memory size exhausted » : un processus a dépassé la mémoire PHP allouée ; augmentez la limite dans le panneau si l’offre le permet, ou traquez l’extension gourmande. « Call to undefined function » : incompatibilité classique après une montée de version PHP ou une extension manquante. « Maximum execution time exceeded » : un script trop long, souvent un import ; la limite se règle, la cause aussi.
Côté HTTP, le 500 muet renvoie au log PHP ou à un .htaccess fautif, le 503 évoque des limites de ressources atteintes, la vague de 404 une refonte sans redirections.
Reste l’hygiène de fin : purger les error_log gonflés par des mois de warnings ignorés, et jeter un œil mensuel au journal même sans symptôme. Les pannes de demain s’y annoncent volontiers en notices d’aujourd’hui, et cinq minutes de lecture préventive battent toutes les nuits curatives.
Questions fréquentes
- Où se trouvent les logs d'erreurs sur un hébergement mutualisé ?
- Deux emplacements habituels : l'outil Erreurs du panneau (cPanel les agrège) et des fichiers error_log déposés dans les dossiers du site, à côté des scripts fautifs. Les logs d'accès HTTP, eux, se consultent via la section dédiée du panneau. En SSH, tail -f sur le fichier donne la lecture en direct.
- Que signifie « erreur 500 » et où chercher sa cause ?
- Le serveur signale qu'il n'a pas pu produire la page, sans détail public par sécurité : la vraie explication attend dans les journaux. Réflexe en deux temps : le log d'erreurs PHP d'abord (fatal error fréquent), le .htaccess ensuite si le log reste muet, une directive invalide produisant exactement ce symptôme.
- Faut-il activer l'affichage des erreurs sur le site ?
- Jamais en production : les messages d'erreur exposent chemins, versions et structure aux visiteurs comme aux robots. Le réglage sain consigne tout dans les fichiers de log sans rien afficher publiquement ; l'affichage à l'écran se réserve aux environnements de développement ou de staging fermés.
- Les warnings et notices doivent-ils être corrigés ?
- Ils n'empêchent pas le site de tourner mais méritent une lecture périodique : un warning répété mille fois par jour gonfle les fichiers, ralentit marginalement et annonce parfois l'incompatibilité qui deviendra fatale à la prochaine version PHP. Traitez-les comme une liste d'entretien, sans urgence ni négligence.