# 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[​](#pos-application-logs "Lien direct vers Journaux de l'application POS")

### Accéder aux journaux[​](#accessing-logs "Lien direct vers 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[​](#interface-overview "Lien direct vers Vue d'ensemble de l'interface")

#### Recherche et Filtrage[​](#search--filter "Lien direct vers 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[​](#log-table "Lien direct vers 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[​](#log-levels "Lien direct vers Niveaux de journal")

#### Info (Gris)[​](#info-grey "Lien direct vers 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)[​](#warning-orange "Lien direct vers Avertissement (Orange)")

Problèmes non critiques qui peuvent nécessiter une attention :

* « Impossible de rafraîchir la session »
* « Nouvelle tentative de synchronisation »

#### Erreur (Rouge)[​](#error-red "Lien direct vers 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)[​](#audit-blue "Lien direct vers 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[​](#context-data "Lien direct vers 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[​](#error-codes "Lien direct vers 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](/fr/error-codes/.md), qui fournit :

* Explication détaillée de l'erreur
* Causes courantes
* Étapes de dépannage

### Entrées de journal communes[​](#common-log-entries "Lien direct vers Entrées de journal communes")

#### Opérations de synchronisation[​](#sync-operations "Lien direct vers 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[​](#permission-errors "Lien direct vers 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[​](#session-issues "Lien direct vers 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[​](#wp-admin-logs-page "Lien direct vers 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[​](#accessing-the-wp-admin-logs-page "Lien direct vers 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[​](#unread-badge "Lien direct vers 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[​](#filtering-entries "Lien direct vers 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[​](#expandable-entries "Lien direct vers 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[​](#pagination "Lien direct vers 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[​](#fatal-errors-banner "Lien direct vers 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[​](#using-logs-for-support "Lien direct vers 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** - Obtenez les détails JSON complets
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[​](#performance-monitoring "Lien direct vers 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

## Documentation connexe[​](#related-documentation "Lien direct vers Documentation connexe")

[Codes d'erreurExplications détaillées des erreurs](/fr/error-codes/.md)

[DépannageProblèmes courants et solutions](/fr/category/troubleshooting.md)

[SupportObtenir de l'aide](/fr/support/.md)