Utilitaire Journaux d’administration

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture
  • 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

    Tableau 1. Principaux avantages des journaux d’administration
    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

    L’interface Logs prend en charge les options de filtrage et d’actualisation en temps réel. Choisissez la plage horaire qui correspond le mieux à vos besoins d’analyse :
    • Dernières 15 minutes
    • Heure précédente
    • Dernières 24 heures
    • Tous les journaux
    Remarque :
    Utilisez le bouton d’actualisation pour mettre à jour la vue avec les derniers événements sans quitter la page Journaux.

    Format des détails du journal

    Chaque entrée de journal est affichée dans un format structuré, ce qui facilite l’analyse et la compréhension des problèmes. Cette structure permet aux administrateurs de filtrer, corréler et résoudre efficacement les erreurs entre différentes sessions et composants. Les données du journal comprennent les colonnes suivantes :
    • 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.

    Exemple de commande cURL :
    
        curl --location '<logikURL>/api/logs/v1/logs' \
        --header 'Content-Type: application/json' \
        --header 'Origin: localhost' \
        --header 'Authorization: <Admin API Key>'
       
    Vous pouvez affiner les résultats en spécifiant before les paramètres au after format date/heure ISO 8601 :
    
        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

    Les journaux d’administration évoluent continuellement pour fournir des informations plus approfondies et améliorer la convivialité. Les améliorations introduites en février 2025 comprennent :
    • 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 .