Utilisation des fichiers journaux et des fichiers de trace pour l'identification et la résolution des incidents

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

Présentation des fichiers journaux et des fichiers de trace

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.

Remarque :
Sous OS/400 et i5/OS, les informations de la sortie standard (STDOUT) sont écrites dans un fichier spoule associé au travail d'InterChange Server Express. Par conséquent, sous OS/400 et i5/OS, la consignation est configurée par défaut pour être envoyée vers un fichier du répertoire /QIBM/UserData/WBIServer44/Nom_serveur/logNom_serveur correspond au nom de l'instance InterChange Server Express (le nom du serveur par défaut est QWBIDFT44).

La messagerie est toujours active et fournit un outil de surveillance précis du système.

Remarque :
Si vous configurez l'envoi des messages générés par l'agent de connecteur vers un fichier journal distinct, vous devez indiquer un fichier journal ou un emplacement distinct du fichier journal d'InterChange Server Express.

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 :

Remarque :
Log Viewer s'exécute uniquement sur les systèmes d'exploitation Windows 2000 et Windows XP. Pour configurer ou visualiser un fichier journal ou un message Linux ou OS/400 et i5/OS à l'aide de Log Viewer, copiez le fichier sur une machine Windows sur laquelle est installé le produit IBM WebSphere InterChange Sever Express ou mappez un lecteur réseau du PC au système OS/400 et i5/OS, puis accédez au fichier journal directement à partir de l'unité mappée.
Remarque :
Sous OS/400 et i5/OS, les horodatages des fichiers journaux et des fichiers de trace sont déterminées par la configuration de deux valeurs système, QTIME et QUTCOFFSET, et par la configuration de la propriété user.timezone du fichier SystemDefault.properties, situé dans le répertoire /QIBM/UserData/Java400/. Lorsqu'une valeur est affectée à la propriété user.timezone, par exemple user.timezone=EDT, Java sous OS/400 et i5/OS génère les horodatages en Heure avancée de l'Est (HAE). Si la propriété user.timezone n'est pas définie, Java sous OS/400 et i5/OS génère les horodatages en Temps moyen de Greenwich (GMT) en utilisant la valeur QTIME et en lui soustrayant celle de QUTCOFFSET. Par exemple, si QUTCOFFSET est -04:00 (fuseau horaire de l'Est), Java soustrait -4 de la valeur en cours de QTIME pour obtenir le TMG. Sous OS/400 et i5/OS version 5R3, vous définissez la valeur système QTIMZON et non pas QUTCOFFSET. Reportez-vous au texte d'aide pour plus d'informations sur les valeurs système sous OS/400 et i5/OS.

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

Messages de connecteur

Formats des messages

Journaux système

Gestion des fichiers journaux et des fichiers de trace

Messages d'objet de collaboration

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.

Messages de connecteur

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.

Formats des messages

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:

Tableau 17. Format de message
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.

Tableau 18. Types de messages
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.

Remarque :
Si un message dont la gravité est Erreur interne ou Erreur bloquante interne apparaît, notez les circonstances de l'occurrence de l'incident, puis contactez le support technique d'InterChange Server Express.

Journaux système

Journaux d'InterChange Server Express

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.

Journaux d'agent de connecteur

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.

Tableau 19. Propriétés des messages de journalisation d'agent de connecteur
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.

Gestion des fichiers journaux et des fichiers de trace

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.

Figure 51. Journalisation d'archivage circulaire

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 :

Fichiers de trace

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.

Services de traçage d'InterChange Server Express

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.

Traçage d'objets de collaboration

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 :

Tableau 20. Niveaux de traçage des objets de collaboration
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.

Traçage de connecteurs

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 :

Tableau 21. Niveaux de traçage d'agent et de contrôleur de connecteur
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.

Traçage de mappes

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.

Traçage d'objets métier (traçage des flux)

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 :

Tableau 22. Niveaux de traçage des 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.

Traçage des passerelles Web

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 :

Tableau 23. Niveaux de 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).

Configuration de la notification par courrier électronique des messages de journal

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.

Remarque :
Si vous souhaitez configurer la notification par courrier électronique sur des collaborations, vous devez utiliser e-Mail Connector.

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.

Procédure de configuration de la notification par courrier électronique au niveau du système

Pour configurer la notification par courrier électronique au niveau du système, appliquez la procédure suivante :

  1. Ouvrez System Manager.
  2. Dans la vue Gestion de composant InterChange Server, cliquez, à l'aide du bouton droit de la souris, sur le serveur, puis cliquez sur Modifier la configuration.

    L'outil d'édition s'ouvre, dans lequel vous pouvez éditer le fichier InterchangeSystem.cfg.

  3. Cliquez sur l'onglet Messagerie électronique.

    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).

    Figure 52. Modifier la configuration, onglet Messagerie électronique
  4. Sélectionnez un type de courrier électronique dans la liste Type d'envoi de courrier électronique :
  5. Entrez au moins une adresse électronique correcte dans chaque zone de sous-système. L'adresse doit être conforme au protocole SMTP.
  6. Dans System Manager, cliquez sur Fichier > SauvegarderNom_Serveur. Les informations de notification par courrier électronique au niveau du système que vous avez entrées sont sauvegardées dans le fichier InterchangeSystem.cfg.
  7. Etape supplémentaire si vous avez configuré Messagerie de connecteur : Configurez l'objet métier EmailNotification afin qu'il conserve l'adresse électronique de la personne qui reçoit le courrier électronique, si le destinataire de ce courrier n'est pas joignable. Par mesure de sécurité, il doit s'agir de l'administrateur de la messagerie et non pas de l'administrateur système d'InterChange Server Express, afin d'assurer que le courrier est délivré si l'administrateur système d'InterChange Server Express n'est pas joignable.

    Procédez comme suit :

  8. Etape supplémentaire si vous avez configuré Messagerie de connecteur : Configurez e-Mail Connector.

    Procédez comme suit :

Procédure de configuration de la notification par courrier électronique au niveau des objets de collaboration

Pour définir une adresse électronique de réception de messages pour une collaboration, appliquez la procédure suivante :

  1. Dans System Manager, accédez à la vue Gestion de composant InterChange Server, cliquez, à l'aide du bouton droit de la souris, sur l'objet de collaboration pour lequel vous souhaitez configurer la notification par courrier électronique et cliquez sur Propriétés.

    La boîte de dialogue Propriétés apparaît.

  2. Dans l'onglet Propriétés générales de collaboration, entrez une adresse électronique correcte dans la zone Adresse de notification par courrier électronique. L'adresse doit être conforme au protocole SMTP.
  3. Cliquez sur OK pour sauvegarder vos modifications et fermer la fenêtre.
  4. Redémarrez la collaboration pour appliquer les modifications.

Procédure de configuration de la notification par courrier électronique au niveau des connecteurs

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 :

  1. Dans System Manager, cliquez, à l'aide du bouton droit de la souris, sur le connecteur pour lequel vous souhaitez configurer la notification par courrier électronique et cliquez sur Modifiez la définition.

    La fenêtre Connector Configurator Express apparaît.

  2. Dans l'onglet Propriétés standard, sélectionnez true dans la zone Valeur de la propriété LogAtInterchangeEnd. Cette valeur active l'envoi par messagerie électronique des messages du connecteur vers le journal d'InterChange Server Express.
  3. Cliquez sur Fichier > Sauvegarder> Dans le projet.
  4. Fermez la fenêtre Connector Configurator Express.
  5. Redémarrez le connecteur pour appliquer la modification.

Configuration de la journalisation et du traçage

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 des destinations de journalisation et de traçage d'InterChange Server Express

Procédure de configuration d'autres paramètres de journalisation et de traçage d'InterChange Server Express

Procédure de configuration de la destination de la journalisation d'agent de connecteur

Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations

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

Procédure d'ouverture de l'outil Modifier la configuration

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 :

  1. Ouvrez System Manager.
  2. A l'aide du bouton droit de la souris, cliquez sur une instance de serveur dans la vue Gestion de composant InterChange Server, puis cliquez sur Modifier la configuration. L'outil Modifier la configuration s'ouvre vous permettant d'éditer le fichier InterchangeServer.cfg.

Procédure de configuration des destinations de journalisation et de traçage d'InterChange Server Express

Lorsque vous configurez ces paramètres, tenez compte des informations suivantes, relatives à STDOUT :

Linux

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.

i5/OS

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.

Windows

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 :

  1. Dans l'outil Modifier la configuration, cliquez sur l'onglet Fichiers Trace/Journal.

    La fenêtre de configuration de la journalisation et du traçage apparaît (voir figure 53).

    Figure 53. Outil Modifier la configuration, onglet Fichiers Trace/Journal
  2. Sous Journalisation, sélectionnez la destination de la journalisation du système. Vous pouvez vous connecter à la console système et à un fichier journal, mais utilisez cette option uniquement pour le débogage et uniquement sur les systèmes de développement. Procédez comme suit :
  3. Sous Trace, sélectionnez la destination de la trace du système. Procédez comme suit :
  4. Pour configurer le traçage d'IBM WebSphere MQ, acceptez le nom de chemin par défaut du fichier ou cliquez sur le bouton Parcourir pour localiser le fichier journal.
  5. Sélectionnez Fichier > Sauvegarder ou cliquez sur Ctrl+S pour enregister les modifications et fermer la fenêtre.

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.

Procédure de configuration du traçage de pile

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 :

  1. Ouvrez l'outil Modifier la configuration (voir Procédure d'ouverture de l'outil Modifier la configuration).
  2. Cliquez sur l'onglet Fichiers Trace/Journal.
  3. Cochez la case Activer la fonction de trace de la pile. Lorsque vous activez cette fonction, la liste Niveau de gravité de la fonction de trace est accessible.
  4. Dans cette liste, sélectionnez le niveau de gravité selon lequel vous souhaitez imprimer le traçage de la pile. Les options sont les suivantes : INFO, AVERTISSEMENT, ERREUR et BLOQUANT. Lorsque la trace de pile est imprimée dans le fichier journal, le niveau que vous avez sélectionné ainsi que tous les niveaux supérieurs sont indiqués. Par exemple, si vous sélectionnez ERREUR, les messages de niveau ERREUR et BLOQUANT sont imprimés dans le fichier journal.

Procédure de configuration d'autres paramètres de journalisation et de traçage d'InterChange Server Express

Pour définir la taille et le nombre de fichiers archive des fichiers journaux et des fichiers de trace, appliquez la procédure suivante :

  1. Ouvrez l'outil Modifier la configuration (voir Procédure d'ouverture de l'outil Modifier la configuration).
  2. Cliquez sur l'onglet Fichiers Trace/Journal.
  3. Pour limiter la taille du fichier journal, cochez les cases Dans le fichier et Illimité(e), sélectionnez un nombre pour définir la taille maximale du fichier journal, dans la liste Fichier journal, puis sélectionnez Octet, Ko (kilooctet), Mo (mégaoctet) ou Go (gigaoctet).
  4. Pour limiter la taille du fichier de trace, cochez les cases Dans le fichier et Illimité(e), sélectionnez un nombre pour définir la taille maximale du fichier de trace, dans la liste Fichier de trace, puis sélectionnez Octet, Ko (kilooctet), Mo (mégaoctet) ou Go (gigaoctet).
  5. Pour définir le nombre d'archives de fichier journal ou de trace, sélectionnez un nombre dans la liste Nombre d'archives, sous la section Journalisation ou Trace.
  6. Arrêtez et redémarrez InterChange Server Express.

Procédure de configuration de la destination de la journalisation d'agent de connecteur

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 :

  1. Connectez-vous à un serveur.
  2. Dans System Manager, cliquez à l'aide du bouton droit de la souris sur un objet de connecteur, puis sélectionnez Modifier la définition. La fenêtre Connector Configurator Express apparaît.
  3. Cliquez sur l'onglet Propriétés standard.
  4. Sélectionnez l'une des valeurs de propriété de journalisation (voir tableau 19 pour une explication de ces valeurs) et cliquez sur Modifier.
  5. Entrez la nouvelle valeur dans la zone Valeur, puis cliquez sur OK.

    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.

  6. Répétez les étapes 3 et 4 pour modifier l'autre valeur de propriété de journalisation, si nécessaire.

    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.

  7. Redémarrez le connecteur pour appliquer les modifications.
Remarque :
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.

Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations

Pour configurer le traçage, appliquez la procédure suivante :

  1. Ouvrez l'outil Modifier la configuration (voir Procédure d'ouverture de l'outil Modifier la configuration).
  2. Cliquez sur l'onglet Niveaux de traçage (voir figure 54).
    Figure 54. Outil Modifier la configuration, onglet Niveaux de traçage
  3. Pour configurer le traçage d'un sous-système, sous Niveaux de trace système d'IBM WebSphere Business Integration, sélectionnez un Niveau de trace pour les sous-systèmes que vous souhaitez configurer.

    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.

  4. Pour configurer le traçage de collaborations, appliquez la procédure suivante :
  5. Pour configurer le traçage d'objets métier, procédez comme suit :
  6. Sélectionnez Fichier > Sauvegarder ou cliquez sur Ctrl+S pour enregister les modifications et fermer la fenêtre.

    Les niveaux de trace pour les sous-systèmes, les objets métier et les collaborations prennent effet immédiatement.

Procédure de configuration du niveau de trace des objets de collaboration

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 :

  1. Dans System Manager, accédez à la vue Gestion de composant InterChange Server, cliquez, à l'aide du bouton droit de la souris, sur l'objet de collaboration, puis cliquez sur Propriétés. La boîte de dialogue Propriétés apparaît.
  2. Effectuez l'une des opérations suivantes dans l'onglet Propriétés générales de collaboration :

Procédure de configuration du traçage de connecteur

Pour configurer le traçage de connecteur, appliquez la procédure suivante :

  1. Dans System Manager, cliquez à l'aide du bouton droit de la souris sur un objet de connecteur, puis sélectionnez Modifier la définition. La fenêtre Connector Configurator Express apparaît.
  2. Procédez de l'une des façons suivantes :
  3. Cliquez sur Fichier > Sauvegarder> Dans le projet.
  4. Fermez Connector Configurator Express.

    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.

    Remarque :
    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.

Procédure de configuration du traçage de mappe

Pour définir le niveau de trace pour une mappe, appliquez la procédure suivante:

  1. Dans System Manager, accédez à la vue Gestion de composant InterChange Server, cliquez, à l'aide du bouton droit de la souris, sur l'objet de mappe, puis cliquez sur Propriétés. La Page de propriétés des mappes apparaît (voir figure 55).
    Figure 55. Page de propriétés des mappes
  2. Dans la zone Niveau de trace, entrez la valeur appropriée.
  3. Sélectionnez Fichier > Sauvegarder ou cliquez sur Ctrl+S.

Utilisation du traçage dans Log Viewer

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.

Présentation de Log Viewer 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).

OS/400

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.

Remarque :
Log Viewer permet de visualiser des fichiers journaux et ne nécessite donc pas l'exécution d'InterChange Server Express. L'administrateur système d'InterChange Server Express doit disposer des droits appropriés sur le système de fichiers, définis pour visualiser des fichiers journaux.

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.

Figure 56. Log Viewer

Procédure de démarrage de Log Viewer

Effectuez l'une des opérations suivantes pour démarrer Log Viewer :

Procédure de définition des préférences de Log Viewer

Pour définir les préférences de Log Viewer, appliquez la procédure suivante :

  1. Cliquez sur Editer > Préférences.

    La boîte de dialogue Options de configuration utilisateur apparaît, avec l'onglet Général sélectionné (voir figure 57).

    Figure 57. Boîte de dialogue Options de configuration utilisateur de Log Viewer, onglet Général
  2. Sous Action d'ouverture, sélectionnez le mode d'affichage du fichier journal lorsque vous ouvrez un fichier journal :
  3. Pour modifier la couleur d'arrière-plan et la police des messages de Log Viewer, cliquez sur l'onglet Format.

    L'onglet Format apparaît (voir figure 58).

    Figure 58. Options de configuration utilisateur de Log Viewer, onglet Format
  4. Sélectionnez des options pour afficher les différents types de messages de journal :
  5. Pour modifier le type de colonnes de Log Viewer affiché, cliquez sur l'onglet Colonnes.

    L'onglet Colonnes apparaît (voir figure 59).

    Figure 59. Options de configuration utilisateur de Log Viewer, onglet Colonnes

    Cette fenêtre vous permet de choisir les colonnes affichées dans Log Viewer :

Présentation des options d'affichage de Log Viewer

Le menu Afficher contient des options supplémentaires permettant de modifier la présentation de Log Viewer :

Présentation de l'affichage de la sortie dans Log Viewer

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 :

$F
Nom du fichier
$A
Nom de l'application
$P
Numéro de page
$N
Nombre total de pages
$D
Date (peut être suivi de paramètres supplémentaires (par exemple $D{%y:%h:%m})

Procédure de filtrage des messages

Pour filtrer les messages dans Log Viewer, appliquez la procédure suivante :

  1. Cliquez sur Afficher > Filtrer > Utiliser filtre. La boîte de dialogue Paramètres de filtrage apparaît. La boîte de dialogue Paramètres de filtrage affiche les catégories correspondantes aux paramètres de format des messages de journalisation (voir tableau 18 pour une description de ces paramètres).
  2. Sélectionnez un onglet sous Définir des filtres pour afficher les critères à utiliser dans le filtrage des messages. Par exemple, sélectionnez l'onglet Objet métier pour afficher la liste des objets métier à utiliser dans le filtrage et sélectionnez Heure pour filtrer les messages en fonction de leur horodatage. Vous pouvez définir plusieurs filtres et les utiliser séparément ou ensemble.
  3. Dans la liste affichée des éléments, sélectionnez chaque élément pour lequel vous souhaitez visualiser les messages dans Log Viewer. Par exemple, pour visualiser des messages associés uniquement aux objets métier Coût et Client, sélectionnez uniquement ces objets métier dans la liste. Pour visualiser uniquement les messages horodatés entre le 5 mars 2002 à 9 heures et le 6 mars 2002 à 5 heures, sélectionnez la plage horaire correspondant à ces périodes, sous l'onglet Heure.

    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.

  4. Sous Activer les filtres, cochez la case associée à chaque type de filtre que vous souhaitez activer. Par exemple, pour visualiser tous les messages relatifs aux objets métier Coût et Client (que vous avez définis à l'étape précédente), activez uniquement le filtre Objet métier. Pour afficher uniquement les messages des objets métier Coût et Client comportant un horodatage spécifique, activez les deux filtres Objet métier et Heure.
  5. Cliquez sur OK. La boîte de dialogue Paramètres de filtrage se referme et Log Viewer est réactualisé pour afficher uniquement les messages que vous avez autorisés dans les filtres.

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.

Procédure de traçage d'un flux d'objet métier

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.

Remarque :
Le traçage de flux est effectué uniquement lorsque l'objet métier se trouve dans le domaine d'InterChange Server Express, à savoir du contrôleur de connecteur de l'application source vers le contrôleur de connecteur de l'application cible. Le traçage de flux d'un objet métier n'est pas effectué lorsque l'objet métier est traité par des agents de connecteur ou des applications.

Pour exécuter le traçage des flux d'un objet métier, appliquez la procédure suivante :

  1. Définissez la destination du fichier journal de trace, si besoin est (voir Configuration de la journalisation et du traçage).
  2. Sélectionnez l'objet métier déclencheur d'origine (et non pas l'objet métier générique) à tracer et définissez son niveau de trace (voir Procédure de configuration des niveaux de traçage pour InterChange Server Express, les objets métier et les collaborations).
  3. Envoyez un événement du connecteur source vers le connecteur de destination.
  4. Ouvrez Log Viewer (voir Procédure de démarrage de Log Viewer).
  5. Définissez les préférences d'affichage afin de visualiser le traçage des flux (voir Présentation des options d'affichage de Log Viewer).
  6. Cliquez sur un bouton de message d'erreur dans la colonne ID message pour afficher le texte du message.
  7. Cliquez sur l'un des boutons de nom d'objet métier dans la colonne Objet métier pour afficher les données contenues dans l'objet métier.

    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.

Copyright IBM Corp. 2004, 2005