Journaux
Le POS dispose de deux interfaces de journaux : l'écran des journaux dans l'application (à l'intérieur de l'application POS) et la page des journaux de WP Admin (à l'intérieur de WordPress). Ensemble, elles vous donnent une image complète de l'activité du POS pour le débogage et l'audit.
Journaux de l'application POS
Accéder aux journaux
Ouvrez l'écran des journaux à partir du tiroir de navigation à gauche (l'icône de battement de cœur).
Vue d'ensemble de l'interface
Recherche et Filtrage
- Rechercher des journaux - Trouvez des entrées de journal spécifiques par contenu du message
- Filtre par niveau de journal - Filtrer par niveau de journal (info, avertissement, erreur)
- Paramètres d'affichage - Configurez les colonnes visibles
Tableau des journaux
Chaque entrée de journal affiche :
| Colonne | Description |
|---|---|
| Heure | Quand l'événement s'est produit |
| Niveau | Sévérité : info (gris), avertissement (orange), erreur (rouge) |
| Message | Description lisible par l'homme de l'événement |
| Contexte | JSON extensible avec des détails supplémentaires |
| Code | Code d'erreur (lien vers la documentation) |
Niveaux de journal
Info (Gris)
Opérations normales et événements réussis :
- « Tous les ID des produits récupérés »
- « Nouveaux clients synchronisés »
- « Tous les ID des taxes récupérés »
Avertissement (Orange)
Problèmes non critiques qui peuvent nécessiter une attention :
- « Impossible de rafraîchir la session »
- « Nouvelle tentative de synchronisation »
Erreur (Rouge)
Problèmes qui doivent être résolus :
- « Désolé, vous ne pouvez pas lister les ressources » (problème de permission)
- « Échec de la requête API »
- « Erreur de synchronisation de la base de données »
Audit (Bleu)
Le niveau de journal d'audit enregistre les modifications de la base de données effectuées par le POS, capturant l'état complet avant et après de chaque modification. Cela est utile pour suivre exactement ce qui a changé et quand, par exemple lors de la création d'une commande, des ajustements de stock ou des mises à jour de clients.
Les entrées d'audit incluent :
- Type d'entité - La ressource qui a été modifiée (par ex., commande, produit, client)
- Action - Le type de modification (création, mise à jour, suppression)
- État avant - Les valeurs précédentes avant la modification
- État après - Les nouvelles valeurs après la modification
Données de contexte
Cliquez sur la flèche d'extension dans n'importe quelle entrée de journal pour voir le contexte JSON détaillé :
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
Ces données incluent :
- Comptes d'articles - Combien d'enregistrements ont été affectés
- Temps d'exécution - Combien de temps l'opération a pris
- Charge du serveur - Mesures de performance du serveur
- Détails de la requête/réponse - Pour déboguer des problèmes API
Codes d'erreur
De nombreuses entrées de journal incluent un code d'erreur (par ex., API02004, DB01001). Ces codes renvoient directement à la documentation des codes d'erreur, qui fournit :
- Explication détaillée de l'erreur
- Causes courantes
- Étapes de dépannage
Entrées de journal communes
Opérations de synchronisation
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
Ceci indique une activité de synchronisation normale. Le contexte montre combien d'éléments ont été synchronisés.
Erreurs de permission
[error] Sorry, you cannot list resources {...} API02004
Cela signifie généralement que l'utilisateur n'a pas la permission d'accéder à une ressource. Vérifiez les rôles d'utilisateur dans WP Admin > POS > Settings > Access.
Problèmes de session
[warn] Unable to refresh session {...} API02007
Le POS n'a pas pu rafraîchir la session d'authentification. Cela peut nécessiter de se déconnecter et de se reconnecter.
Page des journaux de WP Admin
Le plugin POS fournit également une page des journaux côté serveur dans la zone d'administration WordPress. Cette page affiche les avertissements et erreurs spécifiques au POS enregistrés sur le serveur, ce qui peut aider à diagnostiquer des problèmes qui n'apparaissent pas dans l'application POS elle-même.
Accéder à la page des journaux de WP Admin
Accédez à WP Admin > POS > Settings, puis sélectionnez l'onglet Tools et cliquez sur Logs.
Badge non lu
L'élément de menu Logs affiche un badge indiquant les entrées de journal non lues :
- Badge rouge - Il y a des entrées de niveau erreur non lues
- Badge ambre - Il y a des entrées de niveau avertissement non lues (mais aucune erreur)
Visiter la page des journaux réinitialise les compteurs de non-lus. Les compteurs sont suivis par utilisateur, de sorte que chaque administrateur voit son propre statut de non-lus.
Filtrer les entrées
Utilisez le filtre par niveau pour affiner les entrées de journal :
- All - Afficher toutes les entrées de journal
- Errors - Afficher uniquement les entrées de niveau erreur
- Warnings - Afficher uniquement les entrées de niveau avertissement
Entrées extensibles
Les longs messages de journal sont tronqués à environ 100 caractères. Cliquez sur une entrée pour la développer et voir le message complet ainsi que toutes les données de contexte supplémentaires.
Pagination
Les entrées de journal sont paginées côté serveur. Utilisez les contrôles de pagination pour naviguer dans les entrées plus anciennes.
Bannière des erreurs fatales
Si le serveur dispose de fichiers fatal-errors-*.log, la page des journaux affiche une bannière d'avertissement en haut. Cette bannière renvoie vers WooCommerce > Status > Logs où vous pouvez consulter les journaux complets des erreurs fatales. Les erreurs fatales sont généralement des plantages au niveau PHP qui empêchent l'API du POS de répondre.
Utiliser les journaux pour le support
Lors de la demande de support :
- Reproduire le problème - Effectuez l'action qui cause le problème
- Vérifiez les journaux - Recherchez des erreurs (rouge) ou des avertissements (orange)
- Développez le contexte - Obtenez les détails JSON complets
- Notez le code d'erreur - Incluez ceci dans votre demande de support
- Copiez les entrées pertinentes - Partagez les messages de journal avec le contexte
Surveillance des performances
Les journaux incluent le temps d'exécution et les métriques de charge serveur. Si vous remarquez :
- Temps d'exécution élevés - Le serveur peut être surchargé ou lent
- Valeurs de charge serveur élevées - Envisagez une optimisation du serveur
- Délai d'expiration fréquent - Vérifiez la connectivité réseau