Diagnoseablaufverfolgung und Nachrichtenprotokollierung im SQL-Adapter
Die Diagnoseablaufverfolgung hilft bei der effektiven Diagnose von Problemen, die bei der Verwendung der Adapter auftreten können. Adapterclients können die Diagnoseablaufverfolgung auf zwei Ebenen aktivieren:
Zwischen dem Adapterclient und dem Adapter
Innerhalb des Adapters
Dieser Abschnitt enthält Informationen zum Aktivieren der Ablaufverfolgung auf diesen Ebenen.
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 zu verfolgen, die vom Adapterclient mithilfe des WCF-Dienstmodells stammt und bei der Diagnose von Serialisierungsproblemen nützlich ist. 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 Adapterdienstreferenz-Plug-In hinzufügen, 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 Entwurfszeit zu aktivieren, müssen Sie den Auszug der devenv.exe.config Datei hinzufügen, die sich im <Installationslaufwerk> befindet:\Programme\Microsoft Visual Studio <version>\Common7\IDE.
Ablaufverfolgung zur Laufzeit. Für die Laufzeitablaufverfolgung müssen Sie den Auszug abhängig von der verwendeten Anwendung hinzufügen.
Für eine BizTalk Server-Anwendung 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 dem Tag den folgenden Auszug
<configuration>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. Weitere Informationen zur WCF-Ablaufverfolgung finden Sie unter Ablaufverfolgung.
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 SQL-Adapters.
Ablaufverfolgung innerhalb des Adapters
Die Adapter protokollieren verschiedene Kategorien nützlicher Informationen in der Ablaufverfolgungsdatei, z. B. Fehler, Warnungen und Informationsmeldungen. Solche 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 Adapterdienstreferenz-Plug-In hinzufügen, 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 Entwurfszeit zu aktivieren, müssen Sie den Auszug der devenv.exe.config Datei hinzufügen, die sich im <Installationslaufwerk> befindet:\Programme\Microsoft Visual Studio <version>\Common7\IDE.
Ablaufverfolgung zur Laufzeit. Für die Laufzeitablaufverfolgung müssen Sie den Auszug abhängig von der verwendeten Anwendung hinzufügen.
Für eine BizTalk Server-Anwendung 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 das WCF LOB Adapter SDK und die Adapterablaufverfolgung zu aktivieren, fügen Sie dem Tag den folgenden Auszug
<configuration>hinzu.
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels" switchValue="Error">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name="Microsoft.Adapters.Sql" 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 (WCF) Service Trace Viewer-Tool verwenden, um die Ablaufverfolgungen anzuzeigen. Weitere Informationen zum Tool finden Sie unter Verwenden des Dienstablaufverfolgungs-Viewers zum Anzeigen korrelierter Ablaufverfolgungen und Probleme.
Konfigurieren der Nachverfolgung für BizTalk-Anwendungen
Mit der BizTalk Server Verwaltungskonsole können Sie verschiedene Nachverfolgungsoptionen für Elemente wie Sendeports und Empfangsports konfigurieren. Mit den Konfigurationseinstellungen für die Nachverfolgung können Sie ein- und ausgehende Ereignisdaten, Nachrichteneigenschaften, Nachrichtentexte und Orchestrierungen nachverfolgen. Weitere Informationen zum Konfigurieren der Nachverfolgung für BizTalk-Anwendungen finden Sie unter Verwalten von Artefakten.
Sie können auch Die Integritäts- und Aktivitätsnachverfolgung (HAT) verwenden, um verlaufsbezogene oder nachverfolgte Daten anzuzeigen. Weitere Informationen finden Sie unter Anzeigen von Verlaufs- und Nachverfolgten Daten.