Partager via

Diagnostic des problèmes relatifs aux adaptateurs WCF

  • Article

Cette rubrique présente la procédure de diagnostic des problèmes relatifs aux adaptateurs WCF.

Vérifiez le journal IIS et le journal HTTPERR du serveur IIS pour les erreurs

  • Les fichiers journaux du serveur IIS source ou cible contiennent des informations qui peuvent s'avérer utiles pour la résolution de problèmes relatifs aux adaptateurs WCF isolés. Par défaut, les fichiers journaux IIS sur un ordinateur Windows Server se trouvent dans le répertoire suivant :

    %WinDir%\system32\LogFiles\W3SVC1\

    Notes

    %WinDir% est un espace réservé pour l’emplacement du répertoire Windows sur le serveur IIS.

    Par défaut, les fichiers journaux HTTPERR sur les ordinateurs Windows Server 2003 et Windows Server 2008 SP2 se trouvent dans le répertoire suivant :

    Notes

    Le fichier journal HTTPERR est disponible uniquement sur les ordinateurs Windows Server 2003 et Windows Server 2008 SP2.

    %WinDir%\system32\LogFiles\HTTPERR\

Utilisation de l'enregistrement des messages WCF à des fins de surveillance des pannes et de diagnostic des problèmes relatifs aux adaptateurs WCF.

  1. WCF intègre une fonctionnalité permettant d'enregistrer les messages entrants et sortants afin de pouvoir les utiliser hors connexion. Vous pouvez ainsi visualiser l'aspect de ces messages entrant et sortant via les adaptateurs WCF. Par défaut, WCF ne consigne pas les messages. Pour activer cette fonctionnalité, vous devez modifier les fichiers de configuration utilisés par les adaptateurs WCF. Pour plus d’informations sur la journalisation des messages WCF, consultez « Journalisation des messages » sur https://go.microsoft.com/fwlink/?LinkId=89003.

  2. Pour les adaptateurs WCF in-process, vous pouvez activer la journalisation des messages WCF en modifiant le fichier de configuration de l’application, BTSNtSvc.exe.config, pour BTSNtSvc.exe. Le fichier de configuration se trouve dans le chemin d’installation du BizTalk Server. Si vous avez installé BizTalk Server à l’emplacement par défaut, BtsNtSvc.exe se trouve dans le répertoire \Program Files (x86)\Microsoft BizTalk Server <VERSION>.

  3. Pour les adaptateurs WCF isolés, vous pouvez activer la journalisation des messages WCF en modifiant le fichier Web.config créé par l’Assistant Publication du service WCF BizTalk dans le dossier de l’application web.

  4. Pour modifier BTSNtSvc.exe.config ou Web.config, ouvrez le fichier de configuration à l’aide du Bloc-notes, puis configurez la journalisation des messages WCF, comme indiqué dans l’exemple de configuration suivant :

    <configuration>
  <system.serviceModel>
    <diagnostics>
      <messageLogging
           logEntireMessage="true"
           logMalformedMessages="false"
           logMessagesAtServiceLevel="true"
           logMessagesAtTransportLevel="true"
           maxMessagesToLog="300000"
           maxSizeOfMessageToLog="200000"
    />
    </diagnostics>
  </system.serviceModel>

  <system.diagnostics>
    <sources>
      <source name="System.ServiceModel.MessageLogging">
        <listeners>
          <add name="messages"
          type="System.Diagnostics.XmlWriterTraceListener"
          initializeData="c:\wcfTrace.e2e" />
        </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>

  5. L'outil Windows Communication Foundation (WCF) Service Trace Viewer permet d'analyser les messages consignés par WCF. La visionneuse de trace de service est incluse dans le Kit de développement logiciel (SDK) Microsoft Windows pour les composants Windows Vista et .NET Framework Runtime. Vous pouvez télécharger le Kit de développement logiciel (SDK) Windows à partir du Centre de téléchargement Microsoft. Pour plus d’informations sur l’utilisation de cet outil, consultez « Service Trace Viewer Tool (SvcTraceViewer.exe) » à l’adresse https://go.microsoft.com/fwlink/?LinkId=88991.

Renvoi d'informations sur les exceptions gérées au client sous la forme d'erreurs SOAP afin de simplifier le dépannage

  1. Vous pouvez sélectionner l’option Inclure une exception dans les erreurs pour l’emplacement de réception WCF standard afin de renvoyer des informations d’exception managées au client dans les erreurs SOAP afin de faciliter le débogage. Utilisez les étapes suivantes pour sélectionner l’option Inclure l’exception dans les erreurs .

    1. Dans la console Administration BizTalk Server, développez BizTalk ServerAdministration, BizTalk Group, Applications, Emplacements de réception, cliquez avec le bouton droit sur un emplacement de réception à l’aide d’un adaptateur WCF standard, puis cliquez sur Propriétés.

    2. Dans la boîte de dialogue Propriétés de l’emplacement de réception, cliquez sur Configurer.

    3. Dans la boîte de dialogue de transport, sous l’onglet Messages , sélectionnez l’option Inclure l’exception dans les erreurs .

  2. Si vous utilisez le WCF-Custom ou l’adaptateur WCF-CustomIsolated, vous pouvez définir la propriété IncludeExceptionDetailInFaults du ServiceDebugElement pour renvoyer des informations d’exception managées au client. Pour cela, utilisez les étapes suivantes :

    1. Dans la console Administration BizTalk Server, développez BizTalk ServerAdministration, BizTalk Group, Applications, Emplacements de réception, cliquez avec le bouton droit sur un emplacement de réception à l’aide de l’adaptateur WCF-Custom ou WCF-CustomIsolated, puis cliquez sur Propriétés.

    2. Dans la boîte de dialogue Propriétés de l’emplacement de réception, cliquez sur Configurer.

    3. Dans la boîte de dialogue de transport, sous l’onglet Comportement , cliquez avec le bouton droit sur le nœud ServiceBehavior , puis cliquez sur Ajouter une extension.

    4. Dans la boîte de dialogue Sélectionner une extension de comportement , sélectionnez serviceDebug, puis cliquez sur OK.

    5. Dans la boîte de dialogue de transport, sous l’onglet Comportement , cliquez sur le nœud serviceDebug , puis sélectionnez True pour la propriété includeExceptionDetail dans l’affichage liste Configuration .

    Notes

    Le retour d'informations sur les exceptions managées aux clients peut constituer un problème de sécurité, car les détails d'exception exposent des informations relatives à l'implémentation de service interne que des clients non autorisés pourraient utiliser.

Voir aussi

Outils et utilitaires à utiliser pour résoudre les problèmesliés aux adaptateurs WCFBTSNTSvc.exe.config Fichier