Suivi des diagnostics et journalisation des messages dans l’adaptateur SQL

Article
10/14/2023

Le suivi de diagnostic permet de diagnostiquer efficacement les problèmes que vous pouvez rencontrer lors de l’utilisation des adaptateurs. Les clients d’adaptateur peuvent activer le suivi de diagnostic à deux niveaux :

Entre le client de l’adaptateur et l’adaptateur
Dans l’adaptateur

Cette section fournit des informations sur l’activation du suivi à ces niveaux.

Suivi entre le client d’adaptateur et l’adaptateur

Les clients d’adaptateur peuvent activer le suivi WCF pour suivre les problèmes entre le client d’adaptateur et l’adaptateur. Le suivi WCF est utilisé pour suivre le code XML d’entrée provenant du client d’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 ni pour les messages de sortie de l’adaptateur vers le client d’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. Vous pouvez également activer le suivi au moment de la conception et au moment de l’exécution.

Suivi au moment de la conception. Pour l’expérience au moment de la conception, vous pouvez utiliser le plug-in Add Adapter Service Reference 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. Par conséquent, 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 application BizTalk Server, vous devez ajouter l’extrait au fichier de configuration BizTalk, généralement BTSNTSvc.exe.config. Par BizTalk Server, ce fichier est généralement disponible sous <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. Pour plus d’informations sur le suivi WCF, consultez Traçage.

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 Bonnes pratiques pour sécuriser l’adaptateur SQL.

Suivi 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’information. 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 KIT de développement logiciel (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. Vous pouvez également activer le suivi au moment de la conception et au moment de l’exécution.

Suivi au moment de la conception. Pour l’expérience au moment de la conception, vous pouvez utiliser le plug-in Add Adapter Service Reference 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. Par conséquent, 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 application BizTalk Server, vous devez ajouter l’extrait au fichier de configuration BizTalk, généralement BTSNTSvc.exe.config. Par BizTalk Server, ce fichier est généralement disponible sous <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 et le suivi de l’adaptateur WCF LOB, 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.Sql" 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. Pour plus d’informations sur l’outil, consultez Utilisation de la visionneuse de traces de service pour l’affichage des traces et des problèmes corrélés.

Configuration du suivi pour les applications BizTalk

La console Administration BizTalk Server vous permet de configurer différentes options de suivi pour les é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 messages 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 suivi d’intégrité et d’activité (HAT) pour afficher les données historiques ou suivies. Pour plus d’informations, consultez Affichage des données historiques et suivies.

Voir aussi

Résoudre les problèmes liés à l’adaptateur SQL

Partager via