Suivi de diagnostic et journalisation des messages dans l’adaptateur Oracle E-Business Suite

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. Cette rubrique fournit des informations sur les trois types de suivi suivants pris en charge avec l’adaptateur Microsoft BizTalk pour Oracle E-Business Suite :

Suivi côté serveur Oracle à l’aide d’un identificateur de client
Suivi WCF entre le client de l’adaptateur et l’adaptateur
Suivi WCF dans l’adaptateur

Suivi côté serveur Oracle à l’aide d’un identificateur client

Oracle vous permet d’effectuer un suivi côté serveur pour les opérations effectuées par les applications clientes sur la base de données Oracle. Étant donné que les demandes provenant d’applications clientes peuvent être routées vers différentes sessions de base de données, il devient difficile de suivre l’origine de la requête. Toutefois, Oracle facilite le suivi des applications de bout en bout à l’aide d’identificateurs de client.

L’adaptateur Oracle E-Business expose la OracleConnectionClientId propriété de liaison qui vous permet de spécifier l’identificateur du client au moment de la conception de la connexion utilisée par l’adaptateur pour se connecter à Oracle. L’identificateur du client de l’adaptateur vous aide à effectuer un suivi sélectif des opérations effectuées par le client d’adaptateur sur Oracle, et vous permet également de filtrer et d’afficher les traces du serveur Oracle en fonction de l’identificateur du client. Pour plus d’informations sur la façon dont vous pouvez activer le suivi pour les identificateurs de client dans Oracle, consultez https://go.microsoft.com/fwlink/p/?LinkId=135746.

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 plus d’informations.

Important

Veillez à atténuer les menaces de sécurité potentielles liées à l’exposition de données métier sensibles qui peuvent être provoquées lors de l’activation du suivi. Pour obtenir des recommandations, consultez les meilleures pratiques pour le suivi des données des messages et des instances.

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 2006 R2, ce fichier est généralement disponible sous <lecteur> d’installation :\Program Files\Microsoft BizTalk Server 2006. 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.OracleEBS" 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. L’utilisation de la visionneuse de traces de service pour l’affichage des traces corrélées et la résolution des problèmes fournit plus de détails sur cet outil.

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 et suivi de vos artefacts.

Vous pouvez également utiliser le hub de groupe pour afficher les données de suivi des messages et des instance, notamment les meilleures pratiques, l’enregistrement des requêtes de suivi, etc.

Voir aussi

Résolution des problèmes liés à l’adaptateur

Partager via