Documentation · Référence de l'administrateur

Référence des journaux

Ce document est une référence pour l'écran Logs de l'extension ADP Car Market Hub (Car Market Hub → Logs). Il explique comment surveiller les erreurs et avertissements récents, afficher le fichier journal brut de l'extension et l'effacer si nécessaire.

Quand utiliser ce document

Lisez ceci si vous devez :

Vérifier si l'extension a enregistré des erreurs ou des avertissements récents.
Lire les dernières entrées du fichier journal brut.
Ajuster le nombre de lignes affichées.
Réinitialiser le fichier journal (par exemple pour démarrer une trace propre avant une reproduction par le support).

Aperçu

L'extension écrit un fichier journal unique, en mode ajout uniquement. L'écran Logs le présente en trois blocs :

Recent Errors — les entrées de journal les plus récentes contenant le niveau [ERROR].
Recent Warnings — les entrées de journal les plus récentes contenant le niveau [WARNING].
Log Viewer — la fin brute du fichier journal avec un nombre de lignes configurable.

Les panneaux d'erreurs récentes et d'avertissements récents affichent chacun jusqu'à 50 des entrées les plus récentes, analysées à partir des 2 000 dernières lignes de journal pour des raisons de performances.

Configuration requise ou prérequis

Un utilisateur disposant de la capacité de gestion de l'extension.
Un chemin de fichier journal accessible en écriture sur le serveur. Le chemin actuel est affiché au-dessus du Log Viewer.

Instructions étape par étape

Inspecter le journal

Ouvrez Car Market Hub → Logs.
Utilisez Recent Errors et Recent Warnings en haut pour repérer tout élément nécessitant une attention particulière.
Faites défiler jusqu'au Log Viewer pour voir la fin brute du fichier.

Ajuster le nombre de lignes affichées

Dans la barre d'outils au-dessus du Log Viewer, modifiez le champ Lines. La plage autorisée est de 100 à 2000 par paliers de 50.
Cliquez sur Reload pour relire le fichier avec le nouveau nombre de lignes.

Effacer le fichier journal

Cliquez sur Clear log file dans la barre d'outils du Log Viewer.
Confirmez la boîte de dialogue. Le fichier journal est tronqué à zéro octet.
L'extension enregistre que le journal a été effacé manuellement afin que les futures entrées soient corrélées à un point de réinitialisation connu.

L'effacement du journal est irréversible. Utilisez cette option uniquement lorsque vous souhaitez intentionnellement démarrer une trace propre.

Référence de configuration

L'écran Logs n'a pas de réglages persistants. Le sélecteur Lines est uniquement un paramètre de requête par demande.

Contrôle	Plage / valeurs	Notes
Lines	Entier entre 100 et 2000, palier 50	Contrôle le nombre de lignes de fin que le Log Viewer affiche.
Reload	Bouton	Relit le fichier journal avec le nombre de lignes choisi.
Clear log file	Bouton destructif	Tronque le fichier journal à zéro octet. Visible uniquement lorsque le fichier existe.

Notes opérationnelles

Le chemin du fichier journal est affiché au-dessus du Log Viewer. Traitez-le comme un emplacement interne et évitez de le partager à l'extérieur ; ne vous y référez que lors du débogage sur votre propre serveur.
Si le fichier journal n'existe pas encore, l'écran affiche une notification. Le fichier est créé automatiquement lors de la prochaine entrée de journal.
Les panneaux d'erreurs récentes et d'avertissements récents détectent les entrées par les sous-chaînes [ERROR] et [WARNING] respectivement. Les générateurs de journaux personnalisés utilisant un format différent ne seront pas mis en correspondance.
La rotation des journaux, l'archivage et les avertissements d'utilisation du disque sont présentés sur l'écran de la Référence du système et de l'aide.
Le visualiseur affiche le texte échappé à l'intérieur d'un bloc <pre>. Cliquez sur la zone pour sélectionner tout le contenu afin de le copier.

Dépannage

"Could not clear log file (file not found or not writable)." Le chemin du fichier journal n'est pas accessible en écriture par l'utilisateur du serveur web, ou le fichier n'existe pas. Vérifiez les autorisations du système de fichiers sur le chemin indiqué dans la barre d'outils.
Le sélecteur Lines se réinitialise après avoir quitté la page. Comportement attendu. Le nombre de lignes est un paramètre de requête par demande et n'est pas enregistré comme un réglage.
Le journal apparaît vide après une panne récente. Confirmez que le bon fichier journal est en cours de consultation (chemin dans la barre d'outils) et que l'opération en échec passe réellement par l'enregistreur de l'extension. Certaines erreurs fatales PHP sont écrites dans le WordPress debug.log à la place — voir la Référence du système et de l'aide.
"Recent Errors" est vide alors que quelque chose a échoué. Soit l'échec a été enregistré à un niveau différent (par exemple [INFO]), soit il s'est produit en dehors des 2 000 dernières lignes analysées par les panneaux de surveillance. Lisez le Log Viewer brut.