Suivi de diagnostic et journalisation des messages pour l’adaptateur Oracle Database
Le suivi de diagnostic permet de diagnostiquer efficacement les problèmes que vous pouvez rencontrer lors de l’utilisation des adaptateurs. Cette rubrique fournit des informations sur les deux types de suivi suivants pris en charge avec l’adaptateur Microsoft BizTalk pour Oracle Database :
Suivi WCF entre le client de l’adaptateur et l’adaptateur
Suivi WCF dans l’adaptateur
Suivi WCF 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 le code 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, ajoutez 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 des informations plus correctes.
Important
Veillez à atténuer les menaces de sécurité potentielles liées à l’exposition de données métier sensibles en activant le suivi. Pour obtenir des recommandations, consultez Meilleures pratiques pour sécuriser l’adaptateur Oracle Database
Suivi WCF dans l’adaptateur
Les adaptateurs consignent différentes catégories d’informations utiles dans le fichier de trace, telles que les erreurs, les avertissements et les messages d’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, ajoutez 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.OracleDB" 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 enregistre les traces WCF dans C :\log\AdapterTrace.svclog.
Affichage des traces
Vous pouvez utiliser l’outil Visionneuse des traces de service Windows Communication Foundation (WCF) pour afficher les traces. Consultez Utilisation de la visionneuse de traces de service pour afficher les traces corrélées et résoudre les problèmes.
Configuration du suivi pour les applications BizTalk
La console Administration BizTalk Server vous permet de configurer différentes options de suivi pour des éléments tels que les ports d’envoi et les ports de réception. Les paramètres de configuration du suivi vous permettent de suivre les données d’événements entrants et sortants, les propriétés des messages, les corps de message et les orchestrations. La gestion des artefacts inclut plus d’informations.