Le serveur d'applications enregistre les événements, les erreurs et d'autres informations utiles dans plusieurs fichiers journaux. Ces outils sont utiles pour trouver des informations sur l'utilisation du serveur d'applications et résoudre les problèmes.
Notez que les fichiers journaux spécifiques au serveur d'applications n'enregistrent que des informations sur le serveur d'applications ; ils n'enregistrent pas d'informations sur l'utilisation de votre site intranet en général. En revanche, le journal de votre serveur Web enregistre normalement des informations sur l'ensemble du site géré par le serveur.
Le serveur d'applications envoie également des messages d'alerte par email pour certaines erreurs. Pour plus de détails sur les alertes par email, voir Configuration des paramètres email pour le serveur d'applications.
Cette section couvre les sujets suivants :
- Fichiers journaux disponibles
- Niveau de journalisation
- Journalisation par rotation de fichiers
- Informations enregistrées dans les fichiers journaux du serveur d'applications
Fichiers journaux disponibles
Le serveur d'applications fournit les fichiers journaux suivants :
- Fichier journal InterAction
- Fichiers journaux du moteur de servlets Java
- Fichier journal W3C du serveur d'applications
- Observateur d'événements Windows
- Fichier journal du serveur Web
Fichier journal InterAction
Le fichier journal InterAction enregistre toutes les erreurs rencontrées par le serveur d'applications lors du démarrage et du traitement. Il enregistre également des messages d'information lors du démarrage du serveur d'applications, du chargement des fichiers de configuration, de la mise en cache des données et de la réponse aux requêtes des navigateurs.
Ce fichier se trouve à l'emplacement suivant :
[Lecteur]:\Program Files\LexisNexis\InterAction\AppServer\logs
Le fichier journal InterAction prend en charge sept niveaux de journalisation. Voir Niveau de journalisation pour plus de détails.
Le fichier journal InterAction prend également en charge une fonctionnalité de journalisation "par rotation". Voir Journalisation par rotation de fichiers.
Fichiers journaux du moteur de servlets Java
Ces fichiers enregistrent les erreurs, les événements et la sortie texte standard pour le composant moteur de servlets Java du serveur d'applications.
Il y a trois fichiers journaux du moteur de servlets Java :
- InterAction-err.log - enregistre les erreurs du moteur de servlets Java lors du démarrage et du traitement.
- InterAction-event.log - enregistre les actions effectuées par le moteur de servlets Java.
- InterAction-out.log - c'est la sortie standard pour le moteur de servlets Java.
Ces fichiers se trouvent à l'emplacement suivant :
[Lecteur]:\Program Files\LexisNexis\InterAction\AppServer\logs
Fichier journal W3C du serveur d'applications
Ce fichier suit les statistiques des requêtes de méthode en utilisant un format de journal Web standard. Vous pouvez utiliser ce fichier journal avec un logiciel de suivi/analyse Web pour recueillir des informations sur l'utilisation du serveur d'applications.
Le nom et l'emplacement de ce fichier journal sont définis dans la variable w3cLogFile du fichier InterAction.cfg. Par défaut, c'est le suivant :
w3cLogFile = $(IRIS_LOG_DIR)/w3c.log
Dans une nouvelle installation du serveur d'applications, ce fichier journal est désactivé.
Par défaut, le fichier InterAction.cfg se trouve ici :
[Lecteur]:\Program Files\LexisNexis\InterAction\AppServer\iahome\
Observateur d'événements Windows
Dans un environnement Windows Server, le serveur d'applications peut également enregistrer des événements dans l'Observateur d'événements Windows.
Normalement, vous n'avez pas besoin d'activer cette option, car les autres fichiers fournissent une journalisation suffisante. Si vous souhaitez enregistrer des événements, définissez l'option suivante dans le fichier InterAction.cfg :
enableNTEventLog = true
Cela est utile si vous souhaitez centraliser la journalisation pour toutes les applications de votre site ou surveiller l'Observateur d'événements Windows à distance.
Fichier journal du serveur Web
Le serveur Web enregistre normalement des fichiers journaux. Ces fichiers contiennent des informations sur les requêtes et réponses du serveur d'applications, ainsi que sur le reste du site géré par le serveur. Utilisez votre logiciel de serveur Web pour configurer cette journalisation.
Niveau de journalisation
Le niveau de journalisation contrôle les événements enregistrés dans le fichier journal InterAction. Pour définir le niveau de journalisation, définissez la variable logLevel dans le fichier InterAction.cfg à la valeur souhaitée.
Le fichier InterAction.cfg se trouve ici : \Program Files\LexisNexis\InterAction\AppServer\iahome\
Le niveau de journalisation est défini soit par un entier, soit par un nom de niveau. Par exemple, vous pouvez le définir comme suit :
logLevel = 1
Ce paramètre vous donne les niveaux de journalisation Config, Info, Warning et Severe. Si vous définissez le niveau comme suit :
logLevel = Info
vous n'obtiendrez que les niveaux de journalisation Info, Warning et Severe.
Le tableau suivant résume les niveaux de journalisation disponibles.
Niveaux de journalisation du serveur d'applications
| Niveau de journalisation | Description | |
|---|---|---|
| Numéro | Nom | |
| Severe | Erreurs graves | |
| 0 | Warning | Avertissements |
| Info | Informations générales | |
| 1 | Config | Informations de configuration |
| 2 | Fine | Informations plus détaillées |
| 3 | Finer | Informations de débogage de haut niveau |
| 4 | Finest | Informations de débogage très détaillées |
En général, n'utilisez les niveaux de journalisation 2, 3 et 4 que lorsque le support technique de LexisNexis InterAction vous le demande pour résoudre un problème. Sinon, les fichiers journaux deviennent très volumineux.
Changer le niveau de journalisation dans le Web Client
Sur la page Admin du Web Client, vous pouvez rapidement changer le niveau de journalisation à 1 ou 2. Ce changement n'actualise pas la valeur logLevel dans le fichier InterAction.cfg, cependant. Il s'agit uniquement d'un paramètre temporaire qui revient à la configuration du fichier InterAction.cfg une fois que le serveur d'applications InterAction redémarre.
Vous devez être un utilisateur administratif du serveur d'applications pour accéder à la page Admin sur le Web Client. Voir Utilisateurs administratifs du serveur d'applications.
Journalisation par rotation de fichiers
Chaque nuit à minuit, le fichier journal d'InterAction "tourne" le journal en fermant le journal actuel et en en ouvrant un nouveau. La date actuelle est incluse dans le nom du fichier, par exemple, InterAction-20040811.log.
Le paramètre maxLogHistory dans le fichier InterAction.cfg contrôle combien de jours de journaux sont conservés. Lorsque le journal tourne, le serveur d'applications supprime tous les fichiers journaux plus anciens que le nombre de jours spécifié. Le paramètre par défaut est 30.
Informations enregistrées dans les fichiers journaux du serveur d'applications
Le fichier journal d'InterAction enregistre toutes les erreurs et avertissements qui se produisent lorsque le serveur d'applications démarre et lorsque les utilisateurs accèdent aux pages via le Web Client.
Notez que la même erreur ou avertissement peut apparaître plusieurs fois dans le fichier journal. Cela est dû au fait que la même erreur peut se produire chaque fois qu'une action particulière a lieu, comme chaque fois que le serveur d'applications actualise le cache.
Chaque élément du journal des erreurs commence toujours par la date et l'heure de l'erreur. L'heure est en notation 24 heures :
Jeu 28 déc 10:59:23 CST 2000 - AVERTISSEMENT : identifiants clients en double pour le client 1234
Noter la date et l'heure peut vous aider à interpréter le journal, car vous pouvez identifier les messages qui ont été enregistrés à peu près au même moment en réponse à la même action.
Il existe trois types d'erreurs et d'avertissements qui peuvent se produire :
- Erreurs d'intégrité des données
- Avertissements
- Erreurs d'exception Java
Erreurs d'intégrité des données
Les erreurs d'intégrité des données se produisent s'il y a un problème avec les données dans la base de données InterAction. Elles commencent toujours par le texte "Erreur d'intégrité des données" dans le fichier journal, par exemple :
Erreur d'intégrité des données plusieurs apes d'affaires globales du même type : identifiant de liste : 2/43598 classe ape : com.interaction.ia.ElectronicAddress
Pour trouver ces erreurs, utilisez un éditeur de texte pour rechercher "Erreur d'intégrité des données" dans le fichier journal.
Le serveur d'applications envoie un message électronique concernant les erreurs d'intégrité des données lors du chargement initial des données InterAction dans le cache. Après le chargement initial, les erreurs sont enregistrées dans le journal comme des avertissements, donc des messages électroniques supplémentaires ne sont pas envoyés. Toutes les erreurs d'intégrité des données sont regroupées dans un seul message électronique.
L'erreur enregistrée dans le journal du serveur d'applications inclut le problème spécifique, l'ID du contact qui a causé le problème, et un indicateur pour le type de téléphone ou d'adresse. L'ID du contact est donné dans le format suivant :
ID source du contact/ID du contact
Dans l'exemple ci-dessus, le contact causant le problème a un ID source de contact de 2 et un ID de contact de 43598. Le contact a plusieurs adresses électroniques d'affaires globales du même type.
Les problèmes d'intégrité des données peuvent se produire dans de rares cas s'il y a des problèmes avec votre base de données ou si deux utilisateurs modifient les mêmes informations en même temps. Exemples de ces erreurs :
- Contacts avec plusieurs téléphones ou adresses d'affaires globales. Normalement, cette situation n'est pas autorisée, mais elle peut se produire dans de rares cas.
- Contacts avec plusieurs adresses postales globales. Encore une fois, cette situation devrait être rare.
Pour résoudre ces problèmes, trouvez les contacts et corrigez les données dans InterAction. Vous pouvez rechercher par ID de contact. Voir Rechercher un ID de contact spécifique dans InterAction.
Avertissements
Un avertissement d'intégrité des données se produit si les données stockées dans InterAction ne sont pas conformes aux règles métier du serveur d'applications. Par exemple, si deux contacts ont le même ID client, le message suivant est écrit dans le journal :
contact : 2/47 et contact : 2/50 ont des identifiants clients en double : 1234
Pour résoudre ces problèmes, trouvez les contacts et corrigez les données dans InterAction. Vous pouvez utiliser une recherche pour trouver les contacts. Par exemple, si deux contacts ont le même numéro de client, recherchez le champ supplémentaire pour le numéro de client dans InterAction.
Erreurs d'exception Java
Une erreur Java se produit si le serveur d'applications rencontre un problème qui empêche le traitement. Les utilisateurs peuvent rencontrer des problèmes dans le Web Client si des erreurs Java se produisent. Voici un exemple d'erreur Java :
Jeu 28 déc 10:59:23 CST 2000 - (à java.lang.Exception.<init>(Source inconnue)) CustomDef non trouvé dans le profil : company-general pour l'ID CustomDef : 0/32
Pour certaines erreurs, le fichier journal inclut des informations supplémentaires sur l'erreur. Ces informations peuvent être utiles si vous devez travailler avec le support technique de LexisNexis InterAction pour résoudre un problème.
Le serveur d'applications envoie également une alerte par e-mail avec les mêmes informations du fichier journal. Pour plus de détails sur le destinataire de ces messages, voir Configurer les paramètres de messagerie pour le serveur d'applications.
La partie principale du message dont vous avez besoin est le texte du message d'erreur après la parenthèse. Dans l'exemple ci-dessus, voici le texte du message :
CustomDef non trouvé dans le profil : company-general pour l'ID CustomDef : 0/32)
Ces erreurs sont normalement le résultat de fichiers de configuration incorrects. Par exemple, dans l'exemple précédent, la configuration du profil pour le profil company-general fait référence à un champ supplémentaire qui n'a pas été défini dans votre environnement InterAction. Des erreurs similaires incluent des déclarations de profil qui font référence à des dossiers ou des classifications qui n'existent pas dans votre environnement.
Ces types d'erreurs de configuration causent des problèmes pour les utilisateurs. Si un utilisateur du Web Client essaie d'accéder à un profil qui a l'une de ces erreurs, il ou elle rencontrera probablement des erreurs ou des résultats inattendus sur les pages Web.
Ces types de problèmes peuvent se produire si vous configurez le serveur d'applications avec un environnement de test, puis passez à un environnement de production. Pour corriger ces types de problèmes, mettez à jour les fichiers de configuration du serveur d'applications pour votre environnement InterAction.
Si vous ne parvenez pas à résoudre une erreur, contactez le support technique de LexisNexis InterAction et fournissez le fichier journal ou l'alerte par e-mail avec le texte du message d'erreur.
Générer des fichiers journaux pour des utilisateurs spécifiques
Le fichier journal d'InterAction enregistre toutes les erreurs que le serveur d'applications rencontre lors du démarrage et du traitement. Vous pouvez trouver utile de créer un fichier journal séparé pour un utilisateur particulier ou un ensemble d'utilisateurs. Par exemple, un fichier journal pour un seul utilisateur peut vous aider à vous concentrer sur la résolution d'un problème pour cet utilisateur particulier.
Pour créer un fichier journal pour des utilisateurs spécifiques, définissez le paramètre suivant dans le fichier InterAction.cfg, en utilisant des points-virgules pour séparer les noms de comptes utilisateurs :
logusers = userA;userB
Par exemple, pour les utilisateurs jtarnoff et eroberts :
logusers = jtarnoff;eroberts
Lorsque le fichier journal InterAction tourne pour créer un nouveau fichier journal pour la journée, le fichier journal standard est créé ainsi que tous les fichiers journaux utilisateurs supplémentaires que vous avez spécifiés.
Dans l'exemple ci-dessus, les trois fichiers journaux suivants sont créés
pour le 26/09/2011 :
- InterAction-20110926.log
- InterAction-20110926_jtarnoff.log
- InterAction-20110926_eroberts.log
Rechercher un ID de contact spécifique dans InterAction
- Connectez-vous au Windows Client en tant qu'administrateur système. Cela vous donne accès à tous les contacts de la base de données.
- Dans InterAction, choisissez Dossier > Nouveau > Rechercher.
- Dans l'onglet Dossiers, sélectionnez Rechercher TOUS les dossiers auxquels l'utilisateur actuel a accès en LECTURE.
- Choisissez l'onglet Critères.
- Choisissez Ajouter. Développez l'élément Conditions de contact, puis développez l'option Identifiant d'objet.
-
Sélectionnez ID de contact et choisissez OK.
- Entrez l'ID de contact que vous souhaitez trouver dans la zone de saisie Valeur et choisissez OK.
- Répétez les étapes 5-6, mais sélectionnez la condition ID source du contact à la place.
- Entrez l'ID source du contact que vous souhaitez trouver dans la zone de saisie Valeur, et choisissez OK.
- Assurez-vous que les deux conditions apparaissent dans la boîte de dialogue avec Et entre elles, puis choisissez Rechercher maintenant pour trouver le contact.