Suivi de diagnostic et journalisation des messages pour l’adaptateur SAP

Article
07/21/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 à trois niveaux :

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

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’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.SAP" 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.

Suivi entre l’adaptateur et l’application métier

Pour diagnostiquer les problèmes que vous soupçonnez liés à l’application métier, vous devez activer le suivi pour la communication entre l’adaptateur et l’application métier. Les adaptateurs dépendent également du suivi métier (côté client/serveur) pour accéder à ces informations. L’adaptateur SAP permet aux clients d’adaptateur d’activer le suivi dans le système SAP en spécifiant le paramètre « RfcSdkTrace » dans l’URI de connexion. Vous devez spécifier ce paramètre pour permettre au Kit de développement logiciel (SDK) RFC de suivre le flux d’informations dans le système SAP. Pour plus d’informations sur l’URI de connexion, consultez Créer l’URI de connexion système SAP.

En outre, vous pouvez également créer une variable d’environnement RFC_TRACE qui définit le niveau de suivi pour le Kit de développement logiciel (SDK) RFC. RFC_TRACE est une variable d’environnement définie par SAP et utilisée par le Kit de développement logiciel (SDK) RFC. Si cette variable n’est pas définie ou est définie sur 0, le niveau de suivi du SDK RFC est strict minimum. Si la variable est définie sur 1 ou 2, le niveau de suivi est plus détaillé.

Notes

Que la variable d’environnement RFC_TRACE soit définie ou non, le suivi du SDK RFC est activé uniquement si le paramètre « RfcSdkTrace » a la valeur true dans l’URI de connexion. La valeur de cette variable d’environnement régit uniquement le niveau de suivi du SDK RFC. Si RfcSdkTrace a la valeur true, les traces de message entre l’adaptateur et le système SAP sont copiées dans le dossier « system32 » de votre ordinateur. Pour enregistrer les traces du SDK RFC dans un autre emplacement, vous pouvez définir la variable d’environnement RFC_TRACE_DIR. Pour plus d’informations sur ces variables d’environnement, consultez la documentation SAP.

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

Partager via