Passer au contenu principal
Version : 1.x

Journaux

L'écran des journaux enregistre l'activité du système au sein du POS. C'est un outil essentiel pour déboguer des problèmes et comprendre ce qui se passe en coulisses.

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 - Paramètres d'affichage

Tableau des journaux​

Chaque entrée de journal affiche :

ColonneDescription
HeureQuand l'événement s'est produit
NiveauSévérité : info (gris), avertissement (orange), erreur (rouge)
MessageDescription lisible par l'homme de l'événement
ContexteJSON extensible avec des détails supplémentaires
CodeCode d'erreur (lien vers la documentation)

Niveaux de journal​

Info (Gris)​

Opérations normales et événements réussis :

  • "Tous les ID pour les produits récupérés"
  • "Nouveaux clients synchronisés"
  • "Tous les ID pour les 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"

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.

Utiliser les journaux pour le support​

Lors de la demande de support :

  1. Reproduire le problème - Effectuez l'action qui cause le problème
  2. Vérifiez les journaux - Recherchez des erreurs (rouge) ou des avertissements (orange)
  3. Développez le contexte - Développez le contexte
  4. Notez le code d'erreur - Incluez ceci dans votre demande de support
  5. 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
Codes d'erreurExplications détaillées des erreurs
DépannageDépannage
SupportObtenir de l'aide