La présente section décrit l'utilisation des fichiers journaux et des fichiers de trace pour l'identification et la résolution des incidents. Les rubriques suivantes sont traitées :
Présentation des fichiers journaux et des fichiers de trace
Configuration de la notification par courrier électronique des messages de journal
Configuration de la journalisation et du traçage
Utilisation du traçage dans Log Viewer
La journalisation permet de communiquer des messages système, des modifications d'état de composant, des échecs et des informations de trace. Les messages générés par InterChange Server Express, les objets de collaboration et les connecteurs sont envoyés vers la cible que vous avez indiquée lors de l'installation d'InterChange Server Express, par défaut, STDOUT (sortie standard). Les messages générés par les agents de connecteur sont envoyés vers STDOUT, mais peuvent être configurés pour être envoyés vers un fichier journal distinct, dans le répertoire de l'agent.
La messagerie est toujours active et fournit un outil de surveillance précis du système.
Vous pouvez configurer la messagerie pour qu'elle envoie les messages vers un fichier journal ou un destinataire de courrier électronique, en plus de la sortie standard. Vous pouvez configurer des fichiers de sauvegarde (archives) pour le fichier journal et déterminer leur taille. Le traçage, qui est désactivé par défaut en raison de son impact sur les ressources système, peut être configuré lorsque des incidents se produisent et que des informations détaillées sont nécessaires à l'identification et la résolution des incidents.
Deux outils fournissent une interface utilisateur graphique pour la configuration et la visualisation de la journalisation et du traçage des messages :
Outre l'utilisation de LogViewer pour afficher les journaux, vous pouvez ouvrir un journal dans un éditeur de texte ou créer vos propres outils pour filtrer le fichier journal.
Pour plus d'informations sur la visualisation des messages de journalisation et de traçage à l'aide de LogViewer, voir Présentation de Log Viewer et du traçage.
Cette section traite des points suivants :
Messages d'objet de collaboration
Gestion des fichiers journaux et des fichiers de trace
Un objet de collaboration peut générer des messages pour communiquer des informations d'exécution, des avertissements et des erreurs. Par exemple, une collaboration peut consigner ses points de décision et le résultat des opérations.
Lorsqu'InterChange Server Express exécute les objets de collaboration, il écrit ses messages dans son journal. Pour plus d'informations sur la configuration de la journalisation du système, voir Configuration de la journalisation et du traçage.
En outre, vous pouvez envoyer les messages d'un objet de collaboration par courrier électronique à un ou plusieurs destinataires. Vous pouvez spécifier une liste de destinataires de courrier électronique distincte pour chaque objet de collaboration. Pour plus d'informations sur les règles d'utilisation de la notification par courrier électronique, voir Configuration de la notification par courrier électronique des messages de journal.
Les messages de connecteur sont envoyés vers le fichier de destination des messages InterChange Server Express. En fonction de votre système d'exploitation, des messages apparaissent de l'une des façons suivantes :
Pour plus d'informations sur la journalisation des connecteurs, voir Journaux d'agent de connecteur.
Pour aider à l'identification et la résolution des incidents, un fichier journal temporaire est créé pendant l'amorçage de l'agent de connecteur contenant les métadonnées provenant du contrôleur du connecteur. Les métadonnées sont constituées de spécifications et de propriétés d'objet métier ainsi que de propriétés prises en charge par delta. Le fichier est nommé nom_connecteurtmp.log et se trouve dans le répertoire Rép_Produit\Connectors.
Tous les messages sont formatés de manière à être filtrés facilement. Les messages journalisés pour InterChange Server Express et les connecteurs utilisent le même format, décrit dans le tableau 17. Lorsque les objets métier sont configurés pour générer des messages de trace de flux, ils utilisent ces zones et les zones supplémentaires, identifiées par un astérisque dans le tableau 17. Un message fourni à InterChange Server Express est au format suivant et utilise tout ou partie des paramètres suivants :
Horodatage: Nom système: Unité d'exécution: TypeMsg IDMsg: Sous-système: FIID: BO: TexteMsg: BOD:
Variable | Description |
---|---|
Horodatage | Horodatage : date de journalisation au format année/mois/jour et heure. |
Système | Type de composant (identificateur du système). Peut être Server, Collaboration, Business Object ou ConnectorAgent. |
Unité d'exécution | Nom et ID de l'unité d'exécution |
Nom | Nom du composant, par exemple : ClarifyConnector. |
TypeMsg | Gravité du message. Voir le tableau 18. |
IDMsg | Numéro du message. |
Sous-système* | Sous-système du système en cours. Peut être Event Management, Messaging, Repository ou Database Connectivity. |
FIID* | ID de déclencheur de flux de l'objet métier. |
BO* | Nom de l'objet métier. |
TexteMsg | Texte associé au numéro de message. |
BOD* | Vidage de l'objet métier. Données contenues dans l'objet métier. |
Ci-après un exemple de message pour le serveur : [Horodatage: 2001/06/07 11:01:29.487] [Système: Server] [SS: REPOSITORY] [Unité d'exécution: VBJ ThreadPool Worker (#-1767149274)] [Type: Trace ] [Mesg: Released session REPOSITORY0]
Le tableau 18 décrit les types de messages d'InterChange Server Express.
Type | Description |
---|---|
Information | Uniquement pour information. Aucune action n'est nécessaire. |
Avertissement | Condition par défaut choisie par InterChange Server Express. |
Erreur | Incident grave que vous devez examiner. |
Erreur bloquante | Erreur qui interrompt le fonctionnement et doit faire l'objet d'un rapport. |
Trace | Informations de traçage pour le niveau de trace spécifié. |
Trace des flux | Informations sur le traçage des flux pour les objets métier. |
Erreur interne | Incident interne grave que vous devez examiner. |
Erreur bloquante interne | Erreur interne qui interrompt le fonctionnement. Cette erreur doit faire l'objet d'un rapport. |
InterChange Server Express peut consigner les messages vers les destinations suivantes :
Outre la gestion de la journalisation courante, InterChange Server Express peut envoyer un message électronique à un utilisateur spécifié lorsqu'il génère des messages d'erreur ou d'erreur bloquante.
Par défaut, les messages de trace sont envoyés vers le fichier journal du système. Dans certains cas, ce fichier peut devenir trop volumineux, il est alors recommandé de créer un fichier de trace distinct. Voir Fichiers de trace pour connaître les instructions de définition d'un fichier distinct pour les messages de trace.
La rubrique Configuration de la journalisation et du traçage décrit comment définir la destination de la journalisation.
Pour indiquer le destinataire d'une notification par courrier électronique, voir Configuration de la notification par courrier électronique des messages de journal.
La rubrique Gestion des fichiers journaux et des fichiers de trace décrit comment éviter que les fichiers journaux ne deviennent trop volumineux.
L'agent de connecteur et le contrôleur de connecteur disposent de mécanismes de journalisation distincts. La présente section décrit la journalisation d'un agent de connecteur. Les messages de contrôleur de connecteur sont envoyés vers le journal contenant les messages InterChange Server Express.
Un agent de connecteur consigne ses messages vers une destination locale et peut également envoyer ses messages vers InterChange Server Express pour journalisation. Pour spécifier un nom de fichier journal, éditez la propriété LogFileName du connecteur (à l'aide de Connector Configurator Express) et insérez le nom du fichier journal que vous souhaitez utiliser.
Pour indiquer un fichier de journalisation et de traçage pour l'agent de connecteur, vous devez spécifier un fichier de configuration local lors du démarrage de l'agent.
Le fichier journal par défaut (situé dans STDOUT), contient du texte correspondant aux messages d'erreur et d'information générés par le connecteur. Nom est le nom de l'application.
Le tableau 19 décrit les propriétés que vous pouvez éditer pour déterminer où un agent de connecteur consigne ses messages.
Nom de propriété | Description | Type de valeur |
---|---|---|
LogAtInterchangeEnd | Indique si l'agent de connecteur envoie les messages à InterChange Server Express, outre leur journalisation locale.
Sur InterChange Server Express, les messages d'agent de connecteur apparaissent où apparaissent les messages de serveur, en fonction du fichier InterchangeSystem.cfg. |
true (envoie les messages vers InterChange Server Express et active la messagerie électronique) ou false (consigne les messages localement uniquement). La valeur par défaut est false. |
LogFileName | Indique à quel emplacement les messages d'agent de connecteur doivent être écrits sur le système local. | Chemin de fichier ou sortie standard (STDOUT). La valeur par défaut est STDOUT. |
Pour plus d'instructions sur la configuration de ces propriétés, voir Procédure de configuration de la destination de la journalisation d'agent de connecteur.
Lorsque vous démarrez le système InterChange, un fichier journal est créé s'il n'existe aucun fichier ou le fichier journal est ajouté à la fin du fichier existant. Si la taille du fichier est illimitée, elle augmente en fonction du temps écoulé depuis la dernière gestion et du volume de transactions transitant par le système. Si le fichier journal devient trop volumineux, vous risquez de ne plus pouvoir l'ouvrir ou des ressources système supplémentaires peuvent être nécessaires à une application pour écrire dans ces fichiers.
Vous pouvez définir une taille pour les fichiers journaux du système InterChange Server Express et configurer leur archivage automatique lorsqu'ils atteignent cette taille. Pour plus de sûreté, vous pouvez spécifier un nombre de fichiers archive à utiliser comme sauvegarde système. Chaque fois que le fichier journal atteint sa taille maximale, le fichier est renommé sous forme de nouveau fichier archive. Le nom du fichier archive est dérivé du nom du fichier journal ou de trace d'origine et contient les lettres suivantes :
_Arc_ nombre
Par exemple, si vous utilisez cinq fichiers archive pour le fichier journal InterchangeSystem.log, la première archive créée est nommée InterchangeSystem_Arc_01.log. Lorsque le nouveau fichier journal est saturé, InterchangeSystem_Arc_01.log est renommé en InterchangeSystem_Arc_02.log et le fichier journal est à nouveau sauvegardé sous InterchangeSystem_Arc_01.log. Ce mécanisme circulaire se poursuit jusqu'à la création de cinq fichiers archive. Si cinq fichiers archive ont été créés, lorsqu'un fichier journal est créé, les fichiers archive existants sont renommés et leurs numéros incrémentés de sorte que le nombre d'archives corresponde au nombre que vous avez configuré ; le fichier le plus ancien, dont le numéro d'archive est 05, est alors supprimé. La figure 51 montre la progression des fichiers utilisant cette configuration.
Pour plus de détails, voir les tâches de configuration Configuration de la journalisation et du traçage.
Si le fichier journal du système est configuré avec une taille illimitée, InterChange Server Express écrit dans le journal jusqu'à ce que le disque sur lequel se trouve le fichier journal se remplisse ; si le disque n'est pas géré, le système renvoie un message d'erreur indiquant que le disque est saturé.
Les données des fichiers suivants doivent être supprimées régulièrement :
Outre les fichiers journaux ci-avant, d'autres fichiers journaux, spécifiques de chaque application, sont disponibles. La plupart des fichiers sont créés en phase d'exécution s'ils n'ont pas déjà été créés. Les nouvelles informations sont ajoutées aux fichiers existants. Vous devez arrêter tout composant fournissant des informations de journalisation aux fichiers avant de procéder à une sauvegarde.
Vous pouvez utiliser la procédure de gestion de fichiers de votre choix, mais la gestion régulière de fichiers journaux suivante est recommandée :
Pour identifier un incident, vous pouvez activer le traçage. Les messages de trace vous aident à surveiller les actions exécutées dans les composants du système InterChange Server Express. Les niveaux de trace définissent la quantité de détails écrits dans le fichier de trace. Plus le niveau de trace est élevé, plus la trace est détaillée. Le traçage se distingue de la journalisation par les points suivants :
Par défaut, le traçage est désactivé car il produit des messages plus détaillés que nécessaire. Vous pouvez activer et désactiver le traçage selon vos besoins lorsqu'InterChange Server Express s'exécute.
Les services de traçage d'InterChange Server Express sont initialement définis dans des paramètres du fichier de configuration pour InterChange Server Express (par défaut, il s'agit du fichier InterchangeSystem.cfg qui se trouve dans le premier répertoire du produit). Pour plus de détails sur ces paramètres, consultez le guide d'installation de WebSphere Business Integration Server Express pour Windows, pour Linux ou pour OS/400 et i5/OS. Vous pouvez mettre à jour la définition de ces paramètres dans l'outil Modifier la configuration de System Manager, comme décrit dans Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations.
Vous pouvez tracer l'exécution d'un objet de collaboration. Le traçage écrit des messages détaillés sur l'exécution de l'objet de collaboration vers le journal cible précisé dans le fichier InterchangeSystem.cfg. Le traçage des collaborations est une fonction persistante. Vous pouvez définir deux niveaux de trace pour les collaborations, le niveau système et le niveau collaboration.
Le traçage de niveau système renvoie des informations d'exécution pour la collaboration. Par exemple, pour tracer les modifications d'état de la collaboration, définissez le niveau de trace du système par 3.
Vous pouvez définir le traçage d'un objet de collaboration par l'un des niveaux suivants :
Niveau de trace | Description |
---|---|
1 | Trace la réception d'objets métier provenant des connecteurs et le démarrage des scénarios appropriés. |
2 | Imprime les messages du niveau 1. En outre, trace le début et la fin de chaque scénario et fait état de l'exécution en aval et de l'annulation. |
3 | Imprime les messages des niveaux 1 et 2. En outre, trace l'exécution de chaque bloc de décisions ou action du scénario. |
4 | Imprime les messages des niveaux 1 à 3. En outre, trace l'envoi et la réception de chaque objet métier pour chaque scénario. |
5 | Imprime les messages des niveaux 1 à 4. En outre, trace l'envoi et la réception de chaque objet métier pour chaque scénario et imprime la valeur de chaque attribut de l'objet métier. |
Pour plus d'instructions de configuration, voir Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations.
Un connecteur contient deux composants, le contrôleur de connecteur et l'agent de connecteur. Les deux composants peuvent se trouver à différents emplacements sur le réseau et sont tracés différemment.
Vous pouvez définir le traçage d'un agent et d'un contrôleur de connecteur par l'un des niveaux suivants :
Niveau de trace | Description |
---|---|
1 | Trace l'initialisation ainsi que l'envoi et la réception d'objets métier. |
2 | Imprime les messages du niveau 1. En outre, fournit plus de détails que le niveau 1 pour les mêmes types d'événements. |
3 | Imprime les messages des niveaux 1 et 2. En outre, trace l'échange de messages entre l'agent de connecteur et le pilote de messagerie. |
4 | Imprime les messages des niveaux 1 à 3. En outre, trace l'envoi d'objets métier entre les niveaux internes du connecteur. |
5 | Imprime les messages pour les niveaux 1 à 4. En outre, trace l'envoi de messages d'administration entre les niveaux internes du connecteur. |
Un niveau de traçage nouveau ou modifié entre en vigueur immédiatement.
Pour indiquer un fichier de journalisation et de traçage pour l'agent de connecteur, vous devez spécifier un fichier de configuration local lors du démarrage de l'agent.
Pour plus d'instructions de configuration, voir Procédure de configuration du traçage de connecteur.
Vous pouvez utiliser System Manager pour définir le traçage des mappes. Le traçage des mappes permet le débogage et le suivi des messages d'information et d'erreur créés par la mappe. Par défaut, le traçage des mappes est désactivé.
Pour plus d'informations sur le traçage des mappes, voir Map Development Guide. Pour des instructions de configuration, voir Procédure de configuration du traçage de mappe.
La journalisation des traces d'objets métier permet de suivre la progression d'objets métier, d'un point de traitement à un autre, en fonction de messages de notification générés à chaque point. Par exemple, dans un traçage de niveau 2, lorsqu'un objet métier arrive à une collaboration pour traitement, un message de trace est consigné.
Le tableau 22 décrit les niveaux configurables associés au traçage d'objets métier :
Niveau de trace | Description |
---|---|
0 | Aucun traçage. |
1 | Etat de l'événement (Réussi ou Echec) et informations d'identité de l'événement. |
2 | Traçage d'événements minimal. Informations sur le moment où un objet métier entre dans un système ou le quitte ; les systèmes peuvent être des connecteurs, des mappes, des relations et des collaborations. Inclut les informations de niveau 1. |
3 | Fournit un traçage d'événements de niveau 2 et un vidage d'objet métier à l'entrée et à la sortie des systèmes. Impact sur les performances système. |
4 | Traçage détaillé. Fournit le traçage des composants système comme les connecteurs, les mappes, les relations et les collaborations, et mappe ces traces sur le traçage d'événements de niveau 3. Ce niveau de traçage affecte les performances du système. |
Pour plus d'instructions de configuration, voir Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations.
Le traçage des passerelles Web est disponible à deux niveaux, minimal et maximal. Ce type de traçage vous permet de visualiser les informations indiquant si le traitement des communications est correctement effectué sur la passerelle. Le niveau de trace de la passerelle est défini dans l'outil Gateway Configuration Tool. Pour plus d'instructions, voir le Guide d'implémentation du système.
Le tableau 23 décrit les niveaux configurables associés au traçage des passerelles :
Niveau de trace | Description |
---|---|
0 | Aucun traçage. |
1 | Traçage minimal (demandes de liaisons, ouvertures de sockets, etc.). |
5 | Traçage maximal (requêtes HTTP/HTTPS, y compris tous les en-têtes). |
Les messages d'erreur et d'erreur bloquante, consignés dans le journal d'InterChange Server Express, peuvent également être envoyés à l'administrateur système d'InterChange Server Express ou à tout autre destinataire, par courrier électronique. Par défaut, InterChange Server Express est configuré pour envoyer des notifications par courrier électronique à l'aide de JavaMail, mais vous pouvez configurer le serveur pour envoyer des notifications par courrier électronique à l'aide d'e-Mail Connector. Pour connaître les instructions de configuration de la notification par courrier électronique à l'aide d'e-Mail Connector, voir Procédure de configuration de la notification par courrier électronique au niveau du système.
Vous pouvez configurer les composants suivants pour l'envoi de messages d'erreur et d'erreur bloquante à un destinataire de courrier électronique :
Vous pouvez configurer la notification par courrier électronique au niveau du système (défini dans le fichier InterchangeSystem.cfg), au niveau de l'objet de collaboration (défini en tant que propriété d'objet de collaboration) ou au niveau du connecteur (défini en tant que propriété de connecteur). Si vous configurez la notification par courrier électronique au niveau du système, cette configuration s'applique à tous les objets de collaboration ou connecteurs du système. Si vous configurez la notification par courrier électronique au niveau de l'objet de collaboration ou du connecteur, la configuration s'applique uniquement au composant spécifique et prévaut sur la configuration au niveau du système.
La notification par courrier électronique dans le système InterChange Server Express prend en charge les messages électroniques du protocole SMTP (Simple Mail Transport Protocol), la valeur du destinataire du courrier électronique dans le fichier InterchangeSystem.cfg et les adresses électroniques de collaboration doivent donc être des adresses Internet standard.
Une entrée d'adresse électronique valide peut être une ou plusieurs adresses Internet complètes, séparées par des virgules. Par exemple, une entrée correcte pour deux destinataires est :
JohnDoe@entreprise.com,FredSmith@entreprise.com
Vous ne pouvez pas utiliser d'alias d'adresses personnels, tels qu'un alias défini dans un carnet d'adresses personnel. Toutefois, une adresse valide peut être un alias défini dans un serveur de messagerie, comme Eng@entreprise.com. Dans ce cas, le serveur de messagerie décode l'alias et envoie le courrier électronique à tous les membres de l'alias. Par exemple, un alias décodé peut être personne1@une_entreprise.com, personne2@une_autre_entreprise.com, etc.
Pour configurer la notification par courrier électronique au niveau du système, appliquez la procédure suivante :
L'outil d'édition s'ouvre, dans lequel vous pouvez éditer le fichier InterchangeSystem.cfg.
Une boîte de dialogue apparaît vous permettant de saisir les paramètres nécessaires à la configuration de la notification par courrier électronique au niveau du système (voir figure 52).
Procédez comme suit :
Procédez comme suit :
Pour définir une adresse électronique de réception de messages pour une collaboration, appliquez la procédure suivante :
La boîte de dialogue Propriétés apparaît.
Vous pouvez configurer la notification par courrier électronique pour un connecteur spécifique, toutefois les paramètres de configuration définis au niveau de l'objet de collaboration prévalent sur ceux définis au niveau du système.
Pour configurer la notification par courrier électronique pour un connecteur spécifique, appliquez la procédure suivante :
La fenêtre Connector Configurator Express apparaît.
Cette section décrit le mode de définition de la journalisation et du traçage des messages. Vous pouvez définir ces paramètres à l'aide de l'option Modifier la configuration dans System Manager et les éditer manuellement dans le fichier InterchangeSystem.cfg. Les tâches suivantes sont décrites :
Procédure d'ouverture de l'outil Modifier la configuration
Procédure de configuration de la destination de la journalisation d'agent de connecteur
Procédure de configuration du niveau de trace des objets de collaboration
Procédure de configuration du traçage de connecteur
Procédure de configuration du traçage de mappe
Pour que vous puissiez utiliser l'outil Modifier la configuration, InterChange Server Express doit être en cours d'exécution et à l'état Connecté. L'outil Modifier la configuration peut gérer un seul système InterChange Server Express par session.
Pour ouvrir l'outil Modifier la configuration, appliquez la procédure suivante :
Lorsque vous configurez ces paramètres, tenez compte des informations suivantes, relatives à STDOUT :
Si vous définissez la journalisation et le traçage vers STDOUT, les messages sont automatiquement réacheminés vers $REP_PRODUIT/logs/ics_manager.log.
Si vous définissez la journalisation et le traçage vers STDOUT, les messages sont écrits dans un fichier spoulé associé au travail InterChange Server.
Si vous envisagez d'exécuter InterChange Server en tant que service, vous devez diriger le résultat de la journalisation et du traçage vers des fichiers. L'envoi de la sortie de la journalisation et du traçage vers STDOUT évite qu'InterChange Server ne soit configuré en tant que service Windows.
Pour configurer la destination de la journalisation et du traçage des messages d'InterChange Server Express, appliquez la procédure suivante :
La fenêtre de configuration de la journalisation et du traçage apparaît (voir figure 53).
Si vous choisissez de consigner les messages vers STDOUT, ces derniers apparaissent de l'une des deux façons suivantes :
Si vous définissez la journalisation et le traçage vers STDOUT, les messages sont automatiquement réacheminés vers $REP_PRODUIT/logs/ics_manager.log.
STDOUT apparaît dans la fenêtre d'invite de commande, dans laquelle démarre InterChange Server Express.
Vos modifications prennent effet immédiatement et si un fichier journal est déjà configuré, ce dernier est sauvegardé et horodaté et le fichier créé adopte la configuration que vous venez de définir.
Lorsque le traçage de pile InterChange Server Express est activé, les informations de trace de pile sont imprimées dans le fichier journal d'InterChange Server Express. Cette fonction est utile pour l'identification et la résolution des incidents sur une nouvelle installation du système.
Pour configurer la fonction de traçage de pile, appliquez la procédure suivante :
Pour définir la taille et le nombre de fichiers archive des fichiers journaux et des fichiers de trace, appliquez la procédure suivante :
Les deux composants de connecteur disposent de mécanismes de journalisation distincts. La journalisation du contrôleur de connecteur est envoyée vers le fichier InterchangeServer.log. Cette section décrit la configuration du nom et de l'emplacement d'un fichier journal d'agent de connecteur.
Pour des informations de fond sur la journalisation d'agent de connecteur, voir Journaux d'agent de connecteur.
Vous pouvez définir la destination de la journalisation d'agent de connecteur à l'aide de l'une des méthodes suivantes :
Pour configurer la destination de la journalisation d'agent de connecteur à l'aide de Connector Configurator Express, appliquez la procédure suivante :
Par exemple, modifiez la valeur LogAtInterchangeEnd en true pour envoyer des messages au journal InterChange Server Express. Si InterChange Server Express est configuré pour envoyer un courrier électronique lorsque des messages d'erreur et d'erreur bloquante sont consignés, le courrier électronique est également envoyé pour les messages d'agent de connecteur.
Par exemple, pour envoyer des messages d'agent de connecteur vers un fichier de messages et non vers la sortie par défaut STDOUT, entrez le nom de chemin complet du fichier dans la zone Valeur.
Pour configurer le traçage, appliquez la procédure suivante :
La définition de ces niveaux de trace met à jour les paramètres dans le fichier InterchangeSystem.cfg. Pour plus de détails sur les informations générées aux différents niveaux de trace, consultez le guide d'installation de WebSphere Business Integration Server Express installation guide pour Windows, pour Linux, pour OS/400 ou pour OS/400 et i5/OS.
Pour une description des niveaux de trace de collaborations, voir Traçage d'objets de collaboration.
Les niveaux de trace pour les sous-systèmes, les objets métier et les collaborations prennent effet immédiatement.
La présente section décrit l'une des deux méthodes permettant de configurer les niveaux de trace d'objets de collaboration. La seconde méthode est décrite dans Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations.
Pour configurer le niveau de trace d'un objet de collaboration, appliquez la procédure suivante :
Un objet de collaboration démarre le traçage dès que son niveau de traçage est modifié.
Pour configurer le traçage de connecteur, appliquez la procédure suivante :
Les modifications de ces propriétés prennent effet immédiatement. Les messages de trace des contrôleurs de connecteur apparaissent à l'emplacement où InterChange Server Express envoie ses messages de trace et les messages de trace des agents de connecteur apparaissent à l'emplacement où l'agent de connecteur consigne des messages.
Pour définir le niveau de trace pour une mappe, appliquez la procédure suivante:
Pour identifier un incident, vous pouvez activer le traçage. Les messages de trace vous aident à surveiller les actions exécutées dans les composants du système WebSphere InterChange Server Express. Les niveaux de trace définissent la quantité de détails écrits dans le fichier de trace. Plus le niveau de trace est élevé, plus la trace est détaillée.
Par défaut, le traçage est désactivé car il produit des messages plus détaillés que nécessaire. Vous pouvez activer et désactiver le traçage selon vos besoins lorsqu'InterChange Server Express s'exécute.
Pour des informations de fond sur le traçage, voir Fichiers de trace. Pour des informations de configuration sur le traçage, voir Configuration de la journalisation et du traçage.
LogViewer vous permet d'afficher des informations de trace pour InterChange Server Express. Outre l'affichage des informations de trace de débogage pour les collaborations, il vous permet de visualiser la progression d'un objet métier lorsqu'il passe d'un point du traitement à un autre, par exemple lorsque l'objet métier quitte le point de processus collaboration et est envoyé vers d'autres collaborations ou connecteurs pour traitement ou transféré en phase de mappage pour la transformation des données. Pour plus d'informations sur le traçage des flux, voir Traçage d'objets métier (traçage des flux).
Lorsque vous utilisez Log Viewer pour visualiser les journaux, vous devez copier le fichier journal d'OS/400 vers un système Windows ou mapper une unité de réseau sur le système OS/400, puis naviguer vers le fichier journal.
La journalisation des messages système d'InterChange Server Express permet de communiquer des messages, des modifications de l'état des composants et des échecs.
Vous pouvez afficher des fichiers journaux contenant des messages et des explications de messages système de l'une des façons suivantes :
Log Viewer vous permet de visualiser tous les messages contenus dans un fichier journal. Vous pouvez trier et filtrer l'affichage de la sortie ainsi qu'imprimer, sauvegarder et envoyer par courrier électronique des messages du fichier.
Un exemple de fichier journal affiché dans Log Viewer est présenté figure 56.
Effectuez l'une des opérations suivantes pour démarrer Log Viewer :
Pour définir les préférences de Log Viewer, appliquez la procédure suivante :
La boîte de dialogue Options de configuration utilisateur apparaît, avec l'onglet Général sélectionné (voir figure 57).
L'onglet Format apparaît (voir figure 58).
L'onglet Colonnes apparaît (voir figure 59).
Cette fenêtre vous permet de choisir les colonnes affichées dans Log Viewer :
Le menu Afficher contient des options supplémentaires permettant de modifier la présentation de Log Viewer :
Cliquez sur la flèche vers le bas dans chaque zone de tri pour sélectionner la Date/Heure, un ID événement ou un objet métier. Vous pouvez également trier par ordre croissant ou décroissant.
Vous disposez de plusieurs options pour configurer la sortie dans Log Viewer. Le menu Fichier contient des options d'aperçu d'impression, d'impression, de sauvegarde, de régénération de l'affichage, d'envoi de courrier électronique et de définition du style de page, d'en-têtes de page et de bas de page. Les variables d'en-têtes et de bas de page sont les suivantes :
Pour filtrer les messages dans Log Viewer, appliquez la procédure suivante :
Vous pouvez utiliser les boutons situés sous la boîte à liste pour sélectionner ou désélectionner tous les éléments affichés ou pour inverser la sélection en cours.
Notez qu'outre le filtrage dépendant des catégories, vous pouvez également n'afficher que les messages qui contiennent une chaîne de texte spécifique. Pour ce faire, cliquez sur Message sous Définir des filtres, entrez le texte spécifique pour lequel vous souhaitez afficher des messages et cochez la case Message sous Activer les filtres.
Le traçage de flux d'un objet métier ou l'accès au flux vous permet de suivre la progression de l'objet métier sur chaque point de traitement dans son cycle de vie. A l'aide de Log Viewer, vous pouvez suivre la progression en consultant les messages de trace qui apparaissent. Un ID de déclencheur de flux est associé à chaque objet métier à cet effet. Si vous triez l'affichage dans Log Viewer par ID de déclencheur de flux et date/heure, les messages de trace pour l'objet métier sont regroupés ; vous pouvez ainsi suivre aisément son état. Triez par ordre croissant ou décroissant pour obtenir une perspective historique ou pour placer le dernier événement en tête de liste.
Pour exécuter le traçage des flux d'un objet métier, appliquez la procédure suivante :
Cette action utilise Business Object Viewer qui vous permet de sauvegarder les données dans un fichier séparé. Vous pouvez alors lire ce fichier à l'aide de l'outil Mapping ou de Test Connector.