Utilitaire Journaux d’administration
Découvrez comment l’utilitaire Journaux d’administration vous aide à diagnostiquer, surveiller et résoudre efficacement les problèmes de configuration dans votre CPQ environnement.
L’utilitaire Journaux d’administration fournit aux administrateurs une visibilité centralisée sur les activités système, les erreurs de configuration et les problèmes d’intégration. Il permet un diagnostic et une résolution rapides des problèmes en capturant les détails clés de l’exécution, les messages d’erreur et les données contextuelles sur l’environnement. Conçus dans un souci de convivialité et de précision, les journaux d’administration aident les administrateurs à identifier les problèmes, à comprendre leur cause et à agir rapidement pour maintenir la stabilité du système.
Qu’ils soient accessibles via l’interface utilisateur d’administration ou via l’API, les journaux d’administration permettent aux administrateurs d’optimiser les configurations et de maintenir la productivité des utilisateurs.
Avantages clés
| Avantage | Description |
|---|---|
| Visibilité centralisée | Surveillez les erreurs de configuration, d’exécution et d’intégration en un seul emplacement. |
| Surveillance en temps réel | Actualisez et filtrez rapidement les journaux pour vous concentrer sur les périodes les plus récentes ou les plus pertinentes. |
| Dépannage plus rapide | Examinez les codes d’erreur, les messages contextuels et les ID utilisateur détaillés pour effectuer des diagnostics précis. |
| Accessibilité de l’API | Récupérez les données de journal par programmation pour l’automatisation ou les tableaux de bord personnalisés. |
| Amélioration continue | Accédez à des rapports d’erreurs améliorés et à des détails contextuels pour rationaliser la maintenance en cours et l’assistance aux utilisateurs. |
Accès aux journaux d’administration
Les administrateurs peuvent accéder aux journaux d’administration à partir de l’interface d’administration ou via l’API CPQ , en fonction de leur workflow et de leur cas d’utilisation préférés.
Dans la nouvelle expérience administrateur, accédez aux journaux dans le menu Utilitaires. Dans l’expérience administrateur héritée, cliquez sur Journaux dans la barre de navigation. Les deux expériences offrent les mêmes fonctionnalités de journalisation en temps réel et permettent de filtrer, d’actualiser et d’afficher des informations détaillées sur les erreurs.
Actualisation et filtrage
- Dernières 15 minutes
- Heure précédente
- Dernières 24 heures
- Tous les journaux
Format des détails du journal
- Date et heure : affichage convivial de la date et de l’heure exacte en millisecondes (ajouté en février 2025).
- Message d’erreur : Un résumé descriptif du problème rencontré.
- Code d’erreur : CPQ identificateur unique pour les demandes de recoupement et d’assistance rapides.
- ID d’utilisateur : l’utilisateur qui a rencontré l’erreur (ajouté en février 2025).
Accès aux journaux via l’API
Les administrateurs qui préfèrent interroger les journaux par programmation peuvent accéder à l’API Admin Logs à l’aide d’une requête GET. Ceci est particulièrement utile pour les environnements avec de grands ensembles de données ou pour intégrer des journaux dans des systèmes de surveillance externes. Cette flexibilité permet aux administrateurs de récupérer des intervalles de journal spécifiques à des fins d’audit ou de revue des performances sans charger tous les enregistrements historiques.
curl --location '<logikURL>/api/logs/v1/logs' \
--header 'Content-Type: application/json' \
--header 'Origin: localhost' \
--header 'Authorization: <Admin API Key>'
curl --location '<logikURL>/api/logs/v1/logs?after=YYYY-MM-DDThh%3Amm%3AssZ&before=YYYY-MM-DDThh%3Amm%3AssZ' \
--header 'Content-Type: application/json' \
--header 'Origin: localhost' \
--header 'Authorization: <Admin API Key>'
Améliorations continues
- Messages d’erreur améliorés : l’enregistrement des erreurs inclut désormais les erreurs de configuration associées pour une identification plus rapide des problèmes.
- Informations contextuelles : pour les erreurs de script d’enrichissement, les journaux capturent désormais la zone d’enrichissement spécifique, le plan affecté et l’ID de révision pour un débogage précis.
- Erreurs de connexion externe détaillées : Les erreurs HTTP « Method not supported » incluent désormais le chemin et la méthode utilisés dans l’appel externe.
- Mesures de performances : les mesures des intégrations externes sont désormais suivies et disponibles sur demande auprès de l’assistance CPQ .
Directives générales
- Utilisez des filtres de temps courts pour résoudre les problèmes de configuration en temps réel.
- Exportez régulièrement les données de journal pertinentes pour un suivi à long terme ou un examen de conformité.
- Exploitez l’API pour automatiser la récupération de journal ou intégrez-la aux outils de surveillance de votre organisation.
- Signaler les codes d’erreur peu clairs ou le contexte manquant pour aider à l’analyse et à l’amélioration CPQ .