Journaux - Maintenance
Depuis la vue Maintenance , vous pouvez accéder à l’arborescence des journaux, afficher les connexions aux journaux et télécharger les journaux.
L'outil de gestion des services d'Efecte crée une large sélection de journaux à des fins diverses. La destination, la taille maximale et la rotation des journaux peuvent être définies selon les besoins du client.
Les journaux suivants sont créés par défaut :
- Journal de sécurité : enregistre toutes les activités liées à la sécurité, telles que les événements de connexion et de déconnexion des utilisateurs, les approbations des problèmes de flux de travail, etc.
- Journal de configuration : enregistre les modifications apportées à la configuration de la solution sur l'interface d'administration
- Journal d'intégration : enregistre les événements liés à API Web pour l'importation et l'exportation de données
- Journal des erreurs d'application : enregistre les erreurs et les avertissements liés au serveur d'applications
- Journal d'accès à la carte de données (capacité facultative, sous licence séparée) : enregistre toutes les vues du problème à la fois dans la liste et dans la vue détaillée pour les modèles pour lesquels il est configuré.
- Journal d'Effie AI : enregistre les fonctionnalités d'Effie AI utilisées. Cela inclut les fonctions d'e-mail et les déclencheurs d'action. Le niveau de journalisation par défaut est INFO. Les informations suivantes sont disponibles :
- Informations sur les fonctionnalités (Générer, corriger, compléter, action).
- Identifiant unique permettant à l'utilisateur de suivre les utilisateurs uniques/récurrents.
- Horodatage.
- Nom du modèle.
- Nombre de jetons dans la demande.
Télécharger les journaux
Pour accéder aux fichiers journaux depuis l'interface utilisateur ESM avec les journaux de téléchargement, vous devez d'abord définir un paramètre de plateforme « log.files » indiquant à ESM les fichiers journaux à télécharger. Les paramètres de plateforme peuvent être modifiés via Maintenance > Modifier les paramètres. Ajoutez l'emplacement des fichiers journaux ou des dossiers souhaités comme valeurs du paramètre. Si la valeur correspond à un dossier, tous les fichiers qu'il contient sont téléchargés.
Arbre à bûches
L'arborescence des journaux vous permet de surveiller les journaux en temps réel. Ils sont affichés sous forme d'arbre hiérarchique. Cliquer sur le journal à la racine de l'arborescence permet de surveiller tous les journaux, avec leur niveau de journalisation actuel. Vous pouvez également rechercher un composant spécifique et augmenter son niveau de journalisation. Cette fonction est généralement nécessaire pour identifier la cause d'un problème.
Connexions de journal
Avec les connexions de journal, vous pouvez afficher une liste des connexions ouvertes dans l'arborescence du journal.
Modification des propriétés Pro journal dans l'interface utilisateur
Vous pouvez modifier les propriétés du journal dans la vue qui s'ouvre lorsque vous cliquez sur un journal dans l'arborescence du journal.
Le nom du journal sélectionné s'affiche dans la vue. Les flèches haut et bas du champ « Niveau » permettent de modifier le niveau de journalisation des journaux enregistrés dans le fichier journal sous \Efecte\log . Le niveau est affiché après les flèches.
Si vous souhaitez envoyer un message pour vérifier que la journalisation fonctionne au niveau sélectionné, cliquez sur le bouton Envoyer un message de test.
Pour modifier le niveau de journalisation en temps réel affiché dans la vue, sélectionnez le niveau approprié dans le menu déroulant. Les niveaux disponibles (du plus détaillé au plus détaillé) sont :
- Fatal
- Erreur
- Avertir
- Informations
- Déboguer
- Tracer
Pour supprimer les journaux de la vue uniquement, cliquez sur le bouton « Effacer » . Le fichier journal lui-même n'est pas effacé.
Pour arrêter la mise à jour des journaux en temps réel dans la vue, cliquez sur le bouton Déconnecter .
Pour fermer la vue, cliquez sur le bouton Fermer .
Modification de la propriété Pro
Les administrateurs peuvent définir leur propre politique de journalisation dans un fichier nommé custom-log.properties, situé dans le déploiement local ( installationDIR/Webapp/WEB-INF/) . La politique de déploiement qui y est définie remplacera la politique par défaut. Par exemple, si ESM est installé localement dans le répertoire /opt/efecte_le et que l'ID de l'application Web est efecte, la politique doit se trouver dans le fichier /opt/efecte_le/efecte/WEB-INF/custom-log.properties .
Alternativement, dans les déploiements cloud : /var/lib/efecteone/tenant_files/xxx/itsm/files/itsm/WEB-INF/custom-log.properties
Le redémarrage de Tomcat est nécessaire pour mettre à jour les modifications dans custom-log.properties .
Si le client ne définit pas son propre fichier custom-log.properties comme décrit ci-dessus, ESM utilisera son propre fichier de ressources par défaut. Deux politiques de roulement différentes peuvent être définies dans le fichier custom-log.properties, selon un intervalle de temps ou une limite de taille mémoire : TimeBaseRollingPolicy et SizedBasedTriggeredTriggeringPolicy.
Modification des paramètres du journal dans les paramètres de la plateforme
Les paramètres de journalisation disposent de leur propre section dans les paramètres de la plateforme. ESM est installé par défaut avec le mode ConsoleAppender. D'autres mécanismes de journalisation peuvent être appliqués en modifiant les valeurs des paramètres (par exemple, l'emplacement du fichier journal). Pour des instructions complètes sur la configuration des paramètres de log4j, veuillez consulter la documentation en ligne de log4j à l'adresse http://logging.apache.org/log4j/1.2/manual.html.
Exemple de journal de session
Si vous souhaitez surveiller, par exemple, les sessions des utilisateurs ESM, vous pouvez utiliser SessionLogger et le configurer avec les instructions suivantes :
- Accédez à Maintenance > Paramètres système > Modifier les paramètres de la plateforme.
- Recherchez et activez ces 5 paramètres (avec les valeurs par défaut) en cliquant sur la case à cocher devant le paramètre :
- log4j.logger.com.bitmount.boas.log.SessionLogger
- session de l'appender log4j
- log4j.appender.session.layout
- log4j.appender.session.layout.ConversionPattern (cette valeur par défaut doit également être modifiée dans les paramètres de la plateforme pour ne pas créer un fichier volumineux mais un fichier annuel ou trimestriel).
- log4j.appender.session.Fichier
- Redémarrez le service ESM/Efecte Tomcat.
- Vérifiez que session.log peut être téléchargé depuis Maintenance > Journaux > Télécharger les journaux
- Téléchargez et ouvrez le fichier session.log dans le Bloc-notes pour afficher les noms d'utilisateur, les heures de connexion et de déconnexion, la durée totale des sessions et l'emplacement des cartes utilisateur dans l'arborescence des autorisations d'ESM :
- CONNEXION aB6UArhznRMgTtXrxV TestUser
- DÉCONNEXION aB6UArhznRMgTtXrxV TestUser 15.06.2006 13:51 15.06.2006 13:51 0 min Utilisateurs principaux
- CONNEXION aB6UArhznRMgTtXrxV racine
- DÉCONNEXION aB6UArhznRMgTtXrxV racine 15.06.2006 14:01 15.06.2006 14:05 3 min
- CONNEXION aB6UArhznRMgTtXrxV aradams
- CONNEXION ak8-km3bhTZhgYSxxV gesmith
- DÉCONNEXION aB6UArhznRMgTtXrxV aradams 15.06.2006 14:05 15.06.2006 14:06 1 min Utilisateurs de base
- DÉCONNEXION ak8-km3bhTZhgYSxxV gesmith 15.06.2006 14:06 15.06.2006 14:10 4 min Utilisateurs de base
- Si vous souhaitez également consulter le type de licence des utilisateurs et limiter les licences flottantes à un groupe d'utilisateurs, vous pouvez déplacer toutes les licences flottantes en écriture et leurs utilisateurs vers un nouveau sous-dossier appelé « Utilisateurs flottants » dans l'arborescence Licences et autorisations. Vous pouvez également renommer le dossier « Utilisateurs » par défaut en « Utilisateurs dédiés » et y déplacer toutes les licences dédiées.