Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Diagnoseablaufverfolgung hilft bei der effektiven Diagnose von Problemen, die bei der Verwendung der Adapter auftreten können. Dieses Thema enthält Informationen zu den folgenden beiden Arten der Ablaufverfolgung, die mit Microsoft BizTalk Adapter for Oracle Database unterstützt werden:
WCF-Ablaufverfolgung zwischen dem Adapterclient und dem Adapter
WCF-Ablaufverfolgung innerhalb des Adapters
WCF-Ablaufverfolgung zwischen dem Adapterclient und dem Adapter
Adapterclients können die WCF-Ablaufverfolgung aktivieren, um Probleme zwischen dem Adapterclient und dem Adapter zu verfolgen. Die WCF-Ablaufverfolgung wird verwendet, um die Eingabe-XML nachzuverfolgen, die vom Adapterclient mithilfe des WCF-Dienstmodells stammt, und ist bei der Diagnose von Serialisierungsproblemen nützlich. Die WCF-Ablaufverfolgung wird nicht für das WCF-Kanalmodell oder für Ausgabemeldungen vom Adapter an den Adapterclient verwendet. Sie können die WCF-Ablaufverfolgung für BizTalk-Anwendungen und WCF-Dienstmodellanwendungen aktivieren, indem Sie den entsprechenden Konfigurationsdateien einen Auszug hinzufügen. Außerdem können Sie die Ablaufverfolgung sowohl zur Entwurfszeit als auch zur Laufzeit aktivieren.
Ablaufverfolgung zur Entwurfszeit. Für die Entwurfszeit können Sie das Add Adapter Service Reference Plug-In, Das Adapterdienst-Add-In nutzen oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden. Alle diese Tools können in Visual Studio verwendet werden. Um die Ablaufverfolgung für die Entwurfszeitumgebung zu aktivieren, müssen Sie den Auszug der devenv.exe.config Datei hinzufügen, die sich im <Installationslaufwerk>:\Programme\Microsoft Visual Studio-Version<>\Common7\IDE befindet.
Ablaufverfolgung zur Laufzeit. Für die Laufzeitablaufverfolgung müssen Sie den Auszug je nach verwendeter Anwendung hinzufügen.
Für eine BizTalk Server Anwendungen müssen Sie den Auszug der BizTalk-Konfigurationsdatei hinzufügen, in der Regel BTSNTSvc.exe.config. Für BizTalk Server ist diese Datei in der Regel unter <Installationslaufwerk>:\Programme\Microsoft BizTalk Server verfügbar.
Für eine .NET-Anwendung des WCF-Dienstmodells müssen Sie den Auszug der app.config-Datei Ihres Projekts hinzufügen.
Um die WCF-Ablaufverfolgung zu aktivieren, fügen Sie den folgenden Auszug innerhalb des
<configuration>-Tags hinzu.
<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>
Dadurch werden die WCF-Ablaufverfolgungen in C:\log\WCFTrace.svclog gespeichert. Die WCF-Ablaufverfolgung bietet weitere gute Informationen.
Wichtig
Stellen Sie sicher, dass Sie potenzielle Sicherheitsrisiken durch die Offenlegung vertraulicher Geschäftsdaten minimieren, indem Sie die Ablaufverfolgung aktivieren. Empfehlungen finden Sie unter Bewährte Methoden zum Schützen des Oracle Database-Adapters.
WCF-Ablaufverfolgung innerhalb des Adapters
Die Adapter protokollieren verschiedene Kategorien nützlicher Informationen in der Ablaufverfolgungsdatei, z. B. Fehler, Warnungen und Informationsmeldungen. Diese Informationen sind nützlich, um den Prozessablauf innerhalb des Adapters zu verstehen und Probleme mit dem Adapter zu diagnostizieren. Sie können das WCF LOB Adapter SDK und die Adapterablaufverfolgung für BizTalk-Anwendungen und WCF-Dienstmodellanwendungen aktivieren, indem Sie den entsprechenden Konfigurationsdateien einen Auszug hinzufügen. Außerdem können Sie die Ablaufverfolgung sowohl zur Entwurfszeit als auch zur Laufzeit aktivieren.
Ablaufverfolgung zur Entwurfszeit. Für die Entwurfszeit können Sie das Add Adapter Service Reference Plug-In, Das Adapterdienst-Add-In nutzen oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden. Alle diese Tools können in Visual Studio verwendet werden. Um die Ablaufverfolgung für die Entwurfszeitumgebung zu aktivieren, müssen Sie den Auszug der devenv.exe.config Datei hinzufügen, die sich im <Installationslaufwerk>:\Programme\Microsoft Visual Studio-Version<>\Common7\IDE befindet.
Ablaufverfolgung zur Laufzeit. Für die Laufzeitablaufverfolgung müssen Sie den Auszug je nach verwendeter Anwendung hinzufügen.
Für eine BizTalk Server Anwendungen müssen Sie den Auszug der BizTalk-Konfigurationsdatei hinzufügen, in der Regel BTSNTSvc.exe.config. Für BizTalk Server ist diese Datei in der Regel unter <Installationslaufwerk>:\Programme\Microsoft BizTalk Server verfügbar.
Für eine .NET-Anwendung des WCF-Dienstmodells müssen Sie den Auszug der app.config-Datei Ihres Projekts hinzufügen.
Fügen Sie den folgenden Auszug innerhalb des Tags hinzu, um das WCF LOB Adapter SDK und die
<configuration>Adapterablaufverfolgung zu aktivieren:
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels" switchValue="Error">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name=" Microsoft.Adapters.OracleDB" 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>
Dadurch werden die WCF-Ablaufverfolgungen in C:\log\AdapterTrace.svclog gespeichert.
Anzeigen der Ablaufverfolgungen
Sie können das Windows Communication Foundation-Tool (WCF) Service Trace Viewer verwenden, um die Ablaufverfolgungen anzuzeigen. Informationen zum Anzeigen korrelierter Ablaufverfolgungen und zur Problembehandlung finden Sie unter Verwenden von Service Trace Viewer.
Konfigurieren der Nachverfolgung für BizTalk-Anwendungen
Mit der BizTalk Server-Verwaltungskonsole können Sie verschiedene Nachverfolgungsoptionen für Elemente konfigurieren, z. B. Sende- und Empfangsports. Mit den Konfigurationseinstellungen für die Nachverfolgung können Sie ein- und ausgehende Ereignisdaten, Nachrichteneigenschaften, Nachrichtentexte und Orchestrierungen nachverfolgen. Die Verwaltung von Artefakten enthält weitere Informationen.