Diagnostizieren von Problemen mit den WCF-Adaptern

  • Artikel

Die in diesem Abschnitt beschriebenen Schritte sollen können Sie bei der Diagnose von Problemen mit den WCF-Adaptern unterstützen.

Überprüfen sie das IIS-Protokoll und das HTTPERR-Protokoll des IIS-Servers auf Fehler.

  • Die Protokolldateien des IIS-Quell- oder Zielservers können Informationen enthalten, die bei der Behebung von Problemen mit den isolierten WCF-Adaptern hilfreich sind. Standardmäßig befinden sich die IIS-Protokolldateien auf einem Windows Server-Computer im folgenden Verzeichnis:

    %WinDir%\system32\LogFiles\W3SVC1\

    Hinweis

    %WinDir% ist ein Platzhalter für den Speicherort des Windows-Verzeichnisses auf dem IIS-Server.

    Standardmäßig befinden sich die HTTPERR-Protokolldateien auf einem Windows Server 2003- und Windows Server 2008 SP2-basierten Computer im folgenden Verzeichnis:

    Hinweis

    Die HTTPERR-Protokolldatei ist nur auf Windows Server 2003- und Windows Server 2008 SP2-basierten Computern verfügbar.

    %WinDir%\system32\LogFiles\HTTPERR\

Verwenden von WCF-Nachrichtenprotokollierung für Fehlerüberwachung und Diagnose von Problemen der WCF-Adapter

  1. WCF ermöglicht das Protokollieren ein- und ausgehender Nachrichten für die Offlineverarbeitung. Sie können Nachrichtenprotokollierung verwenden, um zu ermitteln, wie die über den WCF-Adapter ein- und ausgehenden Nachrichten aussehen. WCF protokolliert standardmäßig keine Nachrichten. Damit die Nachrichtenprotokollierung aktiviert wird, müssen Sie die von den WCF-Adaptern verwendeten Konfigurationsdateien ändern. Weitere Informationen zur WCF-Nachrichtenprotokollierung finden Sie unter "Nachrichtenprotokollierung" unter https://go.microsoft.com/fwlink/?LinkId=89003.

  2. Für die In-Process-WCF-Adapter können Sie die WCF-Nachrichtenprotokollierung aktivieren, indem Sie die Anwendungskonfigurationsdatei BTSNtSvc.exe.configfür BTSNtSvc.exeändern. Die Konfigurationsdatei finden Sie im BizTalk Server Installationspfad. Wenn Sie BizTalk Server am Standardspeicherort installiert haben, befindet sich BtsNtSvc.exe im Verzeichnis \Programme (x86)\Microsoft BizTalk Server <VERSION>.

  3. Für die isolierten WCF-Adapter können Sie die WCF-Nachrichtenprotokollierung aktivieren, indem Sie die Web.config Datei ändern, die der BizTalk WCF-Dienstveröffentlichungs-Assistent im Webanwendungsordner erstellt.

  4. Um BTSNtSvc.exe.config oder Web.configzu ändern, öffnen Sie die Konfigurationsdatei mithilfe von Editor, und konfigurieren Sie dann die WCF-Nachrichtenprotokollierung, wie im folgenden Konfigurationsbeispiel gezeigt:

    <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. Sie können das Tool Viewer für Dienstabläufe von WCF (Windows Communication Foundation) zum Analysieren von Nachrichten verwenden, die von WCF protokolliert werden. Service Trace Viewer ist im Microsoft Windows Software Development Kit (SDK) für Windows Vista und .NET Framework Runtime-Komponenten enthalten. Sie können das Windows SDK aus dem Microsoft Download Center herunterladen. Weitere Informationen zur Verwendung dieses Tools finden Sie unter "Service Trace Viewer Tool (SvcTraceViewer.exe)" unter https://go.microsoft.com/fwlink/?LinkId=88991.

Zurückgeben von Informationen zu verwalteten Ausnahmen an einen Client in einem SOAP-Fehler zum Vereinfachen des Debugvorgangs

  1. Sie können die Option Ausnahme in Fehler einschließen für den WCF-Standardspeicherort auswählen, um verwaltete Ausnahmeinformationen an den Client in SOAP-Fehlern zurückzugeben, um das Debuggen zu vereinfachen. Verwenden Sie die folgenden Schritte, um die Option Ausnahme in Fehler einschließen auszuwählen.

    1. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk ServerAdministration, erweitern Sie BizTalk-Gruppe, erweitern Sie Anwendungen, erweitern Sie Empfangsspeicherorte, klicken Sie mit der rechten Maustaste mit einem WCF-Standardadapter auf einen Empfangsspeicherort, und klicken Sie dann auf Eigenschaften.

    2. Klicken Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts auf Konfigurieren.

    3. Wählen Sie im Dialogfeld Transport auf der Registerkarte Nachrichten die Option Ausnahme in Fehler einschließen aus.

  2. Wenn Sie den WCF-Custom oder den WCF-CustomIsolated-Adapter verwenden, können Sie die IncludeExceptionDetailInFaults-Eigenschaft des ServiceDebugElement festlegen, um verwaltete Ausnahmeinformationen an den Client zurückzugeben. Führen Sie dazu die folgenden Schritte aus:

    1. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk ServerAdministration, BizTalk-Gruppe, Anwendungen, Empfangsspeicherorte, klicken Sie mit der rechten Maustaste mit dem WCF-Custom oder dem WCF-CustomIsolated-Adapter auf einen Empfangsspeicherort, und klicken Sie dann auf Eigenschaften.

    2. Klicken Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts auf Konfigurieren.

    3. Klicken Sie im Dialogfeld Transport auf der Registerkarte Verhalten mit der rechten Maustaste auf den Knoten ServiceBehavior , und klicken Sie dann auf Erweiterung hinzufügen.

    4. Wählen Sie im Dialogfeld Verhaltenserweiterung auswählen die Option serviceDebug aus, und klicken Sie dann auf OK.

    5. Klicken Sie im Dialogfeld Transport auf der Registerkarte Verhalten auf den Knoten serviceDebug , und wählen Sie dann True für die includeExceptionDetail-Eigenschaft in der Listenansicht Konfiguration aus.

    Hinweis

    Verwaltete Ausnahmeinformationen an Clients zurückzugeben kann ein Sicherheitsrisiko darstellen, da Ausnahmedetails Informationen zur internen Dienstimplementierung verfügbar machen, die von nicht autorisierten Clients verwendet werden könnten.

Weitere Informationen

Tools und Hilfsprogramme für dieProblembehandlung bei der Problembehandlung für die WCF-AdapterBTSNTSvc.exe.config-Datei