Suivi de diagnostic et journalisation des messages pour l’adaptateur Siebel
Les clients d’adaptateurs peuvent activer le suivi des diagnostics pour diagnostiquer efficacement les problèmes rencontrés lors de l’utilisation des adaptateurs. Les clients d’adaptateur peuvent activer le suivi à trois niveaux différents :
Entre le client de l’adaptateur et l’adaptateur
Dans l’adaptateur
Entre l’adaptateur et l’application métier
Cette section fournit des informations sur l’activation du suivi à ces niveaux.
Suivi entre le client de l’adaptateur et l’adaptateur
Les clients d’adaptateur peuvent activer le suivi WCF pour suivre les problèmes entre le client de l’adaptateur et l’adaptateur. Le suivi WCF est utilisé pour suivre les XML d’entrée provenant du client de l’adaptateur à l’aide du modèle de service WCF et est utile pour diagnostiquer les problèmes de sérialisation. Le suivi WCF n’est pas utilisé pour le modèle de canal WCF ou pour les messages de sortie de l’adaptateur vers le client de l’adaptateur. Vous pouvez activer le suivi WCF pour les applications BizTalk et les applications de modèle de service WCF en ajoutant un extrait aux fichiers de configuration respectifs. En outre, vous pouvez activer le suivi au moment du design et de l’exécution.
Traçage au moment du design. Pour l’expérience de conception, vous pouvez utiliser le plug-in Add Adapter Reference Service Plug-in, Consume Adapter Service Add ou l’Assistant Ajout de métadonnées d’adaptateur. Tous ces outils peuvent être utilisés à partir de Visual Studio. Ainsi, pour activer le suivi pour l’expérience de conception, vous devez ajouter l’extrait au fichier devenv.exe.config situé dans <le lecteur> d’installation :\Program Files\Microsoft Visual Studio <version>\Common7\IDE.
Suivi au moment de l’exécution. Pour le suivi au moment de l’exécution, vous devez ajouter l’extrait en fonction de l’application que vous utilisez.
Pour une BizTalk Server applications, vous devez ajouter l’extrait au fichier de configuration BizTalk, généralement BTSNTSvc.exe.config. Pour BizTalk Server, ce fichier est généralement disponible sous <le lecteur> d’installation :\Program Files\Microsoft BizTalk Server.
Pour une application .NET de modèle de service WCF, vous devez ajouter l’extrait au fichier app.config de votre projet.
Pour activer le suivi WCF, vous devez ajouter l’extrait suivant dans la
<configuration>balise :
<system.diagnostics>
<sources>
<source name ="System.ServiceModel" switchValue="Verbose">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name ="System.ServiceModel.MessageLogging"
switchValue="Verbose, ActivityTracing">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name ="System.Runtime.Serialization" switchValue="Verbose">
<listeners>
<add name="xml" />
</listeners>
</source>
</sources>
<sharedListeners>
<add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
traceOutputOptions="LogicalOperationStack"
initializeData="C:\log\WCFTrace.svclog" />
</sharedListeners>
<trace autoflush="true" />
</system.diagnostics>
<system.serviceModel>
<diagnostics>
<messageLogging
logEntireMessage="true"
logMalformedMessages="false"
logMessagesAtServiceLevel="true"
logMessagesAtTransportLevel="false"/>
</diagnostics>
</system.serviceModel>
Cela enregistre les traces WCF dans C :\log\WCFTrace.svclog. Le suivi WCF fournit plus d’informations.
Important
Veillez à atténuer les menaces de sécurité potentielles liées à l’exposition de données métier sensibles en activant le suivi. Consultez Bonnes pratiques pour sécuriser l’adaptateur Siebel
Suivi dans l’adaptateur
Les adaptateurs du pack d’adaptateurs BizTalk consignent différentes catégories d’informations utiles dans le fichier de trace, telles que les erreurs, les avertissements et les informations. Ces informations sont utiles pour comprendre le flux de processus au sein de l’adaptateur et diagnostiquer les problèmes liés à l’adaptateur. Vous pouvez activer le SDK de l’adaptateur LOB WCF et le suivi de l’adaptateur pour les applications BizTalk et les applications de modèle de service WCF en ajoutant un extrait aux fichiers de configuration respectifs. En outre, vous pouvez activer le suivi au moment du design et de l’exécution.
Traçage au moment du design. Pour l’expérience de conception, vous pouvez utiliser le plug-in Add Adapter Reference Service Plug-in, Consume Adapter Service Add ou l’Assistant Ajout de métadonnées d’adaptateur. Tous ces outils peuvent être utilisés à partir de Visual Studio. Ainsi, pour activer le suivi pour l’expérience de conception, vous devez ajouter l’extrait au fichier devenv.exe.config situé dans <le lecteur> d’installation :\Program Files\Microsoft Visual Studio <version>\Common7\IDE.
Suivi au moment de l’exécution. Pour le suivi au moment de l’exécution, vous devez ajouter l’extrait en fonction de l’application que vous utilisez.
Pour une BizTalk Server applications, vous devez ajouter l’extrait au fichier de configuration BizTalk, généralement BTSNTSvc.exe.config. Pour BizTalk Server, ce fichier est généralement disponible sous <le lecteur> d’installation :\Program Files\Microsoft BizTalk Server.
Pour une application .NET de modèle de service WCF, vous devez ajouter l’extrait au fichier app.config de votre projet.
Pour activer le SDK de l’adaptateur LOB WCF et le suivi de l’adaptateur, vous devez ajouter l’extrait suivant dans la
<configuration>balise :
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels" switchValue="Error">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name="Microsoft.Adapters.Siebel" switchValue="Information">
<listeners>
<add name="xml" />
</listeners>
</source>
</sources>
<sharedListeners>
<add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
traceOutputOptions="LogicalOperationStack"
initializeData="C:\log\AdapterTrace.svclog" />
</sharedListeners>
<trace autoflush="true" />
</system.diagnostics>
Cela enregistrerait les traces WCF dans C :\log\AdapterTrace.svclog.
Suivi entre l’adaptateur et l’application métier
Vous devez activer le suivi pour la communication entre l’adaptateur et l’application métier afin de diagnostiquer les problèmes que vous soupçonnez au sein de l’application métier. Les adaptateurs dépendent également du suivi métier (côté client/serveur) pour accéder à ces informations. Les spécificités de l’activation du suivi métier sont exclues de ce document.
En outre, l’adaptateur Siebel fournit une propriété de liaison (LogData), qui, si elle est définie sur True et si le niveau de trace est défini sur Verbose, l’adaptateur Siebel enregistre le flux d’informations entre l’adaptateur et le système Siebel. Ces informations sont enregistrées avec les traces de l’adaptateur dans le même fichier de trace.
Pour plus d’informations sur cette propriété de liaison, consultez En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour Siebel.
Affichage des traces
Vous pouvez utiliser l’outil Visionneuse des traces de service Windows Communication Foundation (WCF) pour afficher les traces. Pour plus d’informations sur l’outil, consultez Utilisation de la visionneuse de traces de service pour l’affichage des traces corrélées et la résolution des problèmes.
Configuration du suivi pour les applications BizTalk
La console d’administration BizTalk vous permet de configurer différentes options de suivi pour des éléments tels que les ports d’envoi, les ports de réception. Les paramètres de configuration du suivi vous permettent de suivre les données d’événements entrants/sortants, les propriétés de message, les corps de message et les orchestrations. Pour plus d’informations sur la configuration du suivi pour les applications BizTalk, consultez Gestion des artefacts.
Vous pouvez également utiliser le hub de groupe pour afficher les données de message et d’instance suivies, y compris une liste de contrôle de suivi et les meilleures pratiques.