Journal
Le module «Journal» dans Platform OneEntry permet aux administrateurs de suivre à la fois les actions des autres admins dans le système et l'activité de l'API de contenu public. Le module se compose de quatre onglets :
| Onglet | Ce qu'il montre |
|---|---|
| Journal des actions admin | Toutes les actions des administrateurs dans le système : création, modification, suppression d'entités. |
| Trafic des admins | Sessions de connexion des administrateurs : quand ils se sont connectés, quand ils se sont déconnectés, depuis quel appareil. |
| Statistiques de l'API de contenu | Compteurs d'appels de tous les points de terminaison publics du site sur différentes périodes. |
| Erreurs de l'API de contenu | Tous les réponses 4xx/5xx de l'API publique avec les détails de la requête et la trace de la pile. |
Dans l'interface du module, les onglets sont étiquetés comme suit : Journal Admin, Journal d'accès à l'application Admin, Statistiques de l'API de contenu, Erreurs de l'API de contenu.
Les onglets de statistiques et d'erreurs de l'API de contenu sont accessibles sous des autorisations distinctes — voir Autorisations pour le journal.
Journal des actions admin
L'onglet principal, montrant toutes les actions des administrateurs dans le système.
Éléments de l'interface
L'onglet se compose de deux blocs :
- Filtres
- Liste des actions
Filtres
Pour filtrer les actions, les champs suivants sont disponibles :
- De — champ de texte pour la date à partir de laquelle il faut filtrer les actions.
- À — champ de texte pour la date jusqu'à laquelle il faut filtrer les actions.
Les dates peuvent être saisies sous forme de chaîne dans le format de date de votre région, ou vous pouvez sélectionner la date souhaitée à l'aide du calendrier qui apparaît lorsque vous cliquez sur le champ de saisie de date.
- ID Administrateur — champ numérique pour l'identifiant unique de l'administrateur.
- Actions utilisateur — liste déroulante des actions de l'utilisateur :
- Création
- Modification
- Suppression
- Statut — liste déroulante des statuts des actions :
- Réussi
- Erreur
- Nom du module — liste déroulante des noms de modules :
- Administrateurs
- Ensembles d'attributs
- Sauvegarde
- Gestion des blocs
- Gestion des événements
- Paramètres généraux
- Téléchargement de fichiers
- Éditeur de fichiers
- Gestion des formulaires
- Localisation
- Marqueurs
- Menu
- Modules
- Gestion de contenu
- Produits
- Gestion des commandes
- Paramètres de base
- Gestion des paiements
- Gestion des statuts de produits
- UTILISATEUR
- Gestion des fournisseurs d'authentification et des utilisateurs
- Gestion des modèles
- Gestion des modèles d'aperçu
- ID d'enregistrement — champ numérique pour l'identifiant unique de l'enregistrement.
Sous le bloc de filtres, deux boutons sont situés :
- Supprimer les données — supprime les enregistrements du journal des actions admin pour la période spécifiée par les champs De / À (voir Nettoyage des journaux manuellement).
- Réinitialiser — réinitialise les filtres appliqués.
Liste des actions
La liste des actions est présentée sous forme de tableau de six colonnes :
- Actions utilisateur
- Statut
- Connexion utilisateur
- Nom du module
- ID d'enregistrement
- Date et heure
Pour chaque colonne, il est possible de trier les données en cliquant sur l'en-tête de la colonne. La première pression triera par ordre décroissant, la deuxième par ordre croissant, la troisième réinitialisera le tri.
Audit de la visibilité du bloc
Chaque changement de visibilité du bloc (toggle « afficher/ne pas afficher » dans l'admin des blocs) est automatiquement enregistré dans le Journal des actions admin. Il est possible de voir quel admin et quand a changé l'état d'un bloc spécifique.
Dans la liste des actions, cet enregistrement se rapporte au module Gestion des blocs.
Trafic des admins (Journal d'accès admin)
L'onglet «Trafic des admins» montre chaque connexion et déconnexion d'un administrateur dans le système comme un enregistrement distinct. Il est possible de voir qui et quand s'est connecté à l'admin, ce qui est pratique pour l'audit.
Champs du tableau
Le tableau se compose de six colonnes :
| Colonne | Ce que cela signifie |
|---|---|
| Connexion | identifiant de l'administrateur |
| IP | adresse IP depuis laquelle l'admin s'est connecté |
| Heure de connexion | date et heure de la connexion |
| Heure de déconnexion | date et heure de la déconnexion (pour une session encore ouverte — Active) |
| Durée | durée de la session (pour une session active — de la connexion jusqu'à maintenant) |
| Raison | raison de la fermeture de la session : Déconnexion (l'admin a cliqué sur « Déconnexion ») ou Admin Révoqué (un autre admin a forcé la fermeture de la session) ; pour une session ouverte — Active |
Comme dans le Journal des actions admin, n'importe quelle colonne peut être triée en cliquant sur son en-tête.
L'expiration de l'autorisation et son renouvellement automatique ne sont pas enregistrés comme un enregistrement distinct. Une session expirée est marquée comme fermée non pas immédiatement, mais lorsque son utilisation cesse.
Filtres
- De / à — période (champs de saisie de date avec calendrier).
- ID Administrateur — champ numérique pour filtrer par administrateur spécifique.
- Statut de la session — liste déroulante du statut de la session : Tous / Actif / Fermé.
Bouton « Supprimer les données »
Supprime les enregistrements des sessions pour la période spécifiée par les champs De / À. Lors de la pression, une boîte de dialogue de confirmation s'ouvre :
Confirmer l'action — Supprimer toutes les sessions fermées pour la période spécifiée ? Cette action est irréversible. Les sessions actives resteront.
Seules les sessions fermées sont supprimées. Les sessions actives (avec une autorisation ouverte) ne sont pas supprimées.
Statistiques de l'API de contenu
L'onglet «Statistiques de l'API de contenu» montre les compteurs d'appels de tous les points de terminaison publics du site sur différentes périodes — 1 heure, 24 heures, 7 jours.
Ce qu'il montre
- Liste de tous les points de terminaison publics (
GET /api/content/...) — se forme automatiquement, il n'est pas nécessaire de le remplir manuellement. - Compteur à côté de chaque point de terminaison — combien de fois il a été appelé pendant la période choisie.
Éléments de l'interface
- Période — liste déroulante de la période : Dernière heure / Dernières 24 heures / Derniers 7 jours (par défaut — Dernières 24 heures).
- Rafraîchir — bouton de mise à jour forcée des données.
Les données sont présentées dans un tableau de quatre colonnes :
| Colonne | Ce que cela signifie |
|---|---|
| Chemin | chemin du point de terminaison (/api/content/...) |
| Méthode | méthode HTTP (GET, POST, …) |
| Description | brève description du point de terminaison |
| Requêtes | nombre d'appels pendant la période choisie |
En haut de la page, une bannière d'information Nettoyage automatique non applicable s'affiche : les statistiques sont lues en temps réel et ne sont pas stockées dans le projet, donc il n'est pas nécessaire de les nettoyer, et la durée de conservation des données dans l'admin n'est pas configurable.
Si les données statistiques sont temporairement indisponibles, un avertissement « Metric temporarily unavailable. All endpoints are displayed with a zero count. » apparaît au-dessus du tableau. Malgré le texte de l'avertissement, le tableau peut être vide dans ce cas — avec le message « No data available ».
Les statistiques sont conservées pendant une durée limitée, et la durée de conservation dans l'admin n'est pas configurable. Pour une analyse sur une période plus longue, conservez les données vous-même. La bannière d'information en haut de la page avertit à ce sujet.
Pourquoi c'est nécessaire
Les statistiques montrent quels points de terminaison de l'API de contenu sont utilisés et lesquels ne sont pas appelés. Une chute soudaine du nombre d'appels d'un point de terminaison indique généralement un problème dans l'application cliente.
Les données ne sont mises à jour pas plus d'une fois par minute : une nouvelle pression sur Rafraîchir dans les 60 secondes affichera les mêmes valeurs.
Erreurs de l'API de contenu
L'onglet «Erreurs de l'API de contenu» montre toutes les réponses 4xx/5xx que l'API publique a renvoyées pendant la période. Les développeurs qui intègrent l'application cliente avec l'API de contenu voient les erreurs de leurs requêtes directement dans l'admin.
Ce qu'il montre
Chaque enregistrement est une erreur HTTP distincte. Le tableau se compose de cinq colonnes :
| Colonne | Ce que cela signifie |
|---|---|
| Temps | horodatage de l'erreur |
| Statut | statut HTTP (4xx / 5xx) |
| Méthode | méthode de la requête (GET, POST, …) |
| Chemin | chemin (/api/content/...) |
| Message | texte de l'erreur |
S'il n'y a pas eu d'erreurs pendant la période choisie, un message « No errors recorded for the selected period » s'affiche à la place du tableau.
Un clic sur une ligne du tableau ouvre une fenêtre avec les détails de l'erreur :
- temps, statut HTTP, méthode et chemin de la requête ;
- code et texte de l'erreur ;
- trace de la pile — développée (jusqu'à 8 Ko) ;
- identifiant de la requête et numéro de série de l'app-token avec lequel la requête est arrivée ;
- adresse IP et User-Agent du client ;
- Query — paramètres de la chaîne de requête ;
- aperçu du corps de la requête (sans secrets — mots de passe, tokens, en-têtes d'autorisation masqués).
Filtres
- De / à — période (champs de saisie de date avec calendrier).
- Statut HTTP — liste déroulante des statuts. Vous pouvez choisir un groupe (4xx - Côté client, 5xx - Côté serveur) ou un code spécifique : 400, 401, 403, 404, 422, 500, 502, 503.
- Chemin — champ de texte pour filtrer par chemin (par exemple,
/api/content/blocks/*).
Bouton « Supprimer les données »
Supprime les enregistrements d'erreurs pour la période spécifiée par les champs De / À. Si la période n'est pas spécifiée, toutes les erreurs sont supprimées.
Sécurité — masquage des données sensibles
Les données sensibles dans les enregistrements d'erreurs sont automatiquement masquées. Les champs password, token, authorization, api_key, x-app-token, cookie, set-cookie (insensible à la casse) sont remplacés par ***. Les grands corps de requêtes sont tronqués à 2 Ko.
Nettoyage des journaux manuellement
Les enregistrements du journal sont nettoyés manuellement — sur chaque onglet qui conserve des enregistrements, il y a un bouton «Supprimer les données» :
| Onglet | Ce qu'il supprime |
|---|---|
| Journal des actions admin | enregistrements des actions admin pour la période choisie |
| Trafic des admins | seulement les fermées sessions pour la période choisie |
| Erreurs de l'API de contenu | enregistrements d'erreurs pour la période choisie |
La période de suppression est définie par les champs De / À dans les filtres de l'onglet. Si la période n'est pas spécifiée, tous les enregistrements du type correspondant sont supprimés. Avant la suppression, une boîte de dialogue de confirmation «Confirmer l'action» est toujours affichée, l'opération est irréversible.
Le bouton «Supprimer les données» sur l'onglet «Trafic des admins» ne supprime pas les sessions actives des admins — même si une période est spécifiée qui chevauche le moment actuel, la session ouverte d'un collègue actif ne sera pas supprimée. Seules les sessions fermées sont supprimées.
Les données statistiques sont lues en temps réel et ne sont pas stockées dans le projet, donc il n'y a pas de bouton «Supprimer les données» sur cet onglet — cela est signalé par la bannière «Nettoyage automatique non applicable».
Autorisations pour le journal
Les onglets Statistiques de l'API de contenu et Erreurs de l'API de contenu sont accessibles sous des autorisations distinctes dans l'arbre des droits (s'ouvre dans un nouvel onglet). Sans autorisation, l'onglet ne s'affiche pas.
| Onglet | Permission |
|---|---|
| Statistiques de l'API de contenu | journal.viewContentApiStats |
| Erreurs de l'API de contenu | journal.viewContentApiErrors |
Les onglets «Journal des actions admin» et «Trafic des admins» sont visibles pour tous les administrateurs ayant accès au module de journal.