Diagnoseablaufverfolgung und Nachrichtenprotokollierung für den Siebel-Adapter
Adapterclients können die Diagnoseablaufverfolgung aktivieren, um Probleme effektiv zu diagnostizieren, die bei der Verwendung der Adapter auftreten. Adapterclients können die Ablaufverfolgung auf drei verschiedenen Ebenen aktivieren:
Zwischen dem Adapterclient und dem Adapter
Innerhalb des Adapters
Zwischen dem Adapter und der Branchenanwendung
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-XMLs vom Adapterclient mithilfe des WCF-Dienstmodells nachzuverfolgen und ist nützlich bei der Diagnose von Serialisierungsproblemen. 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 Entwurfs- 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 Anwendungen müssen Sie den Auszug der BizTalk-Konfigurationsdatei hinzufügen, die 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, müssen Sie dem Tag den folgenden Auszug
<configuration>hinzufügen:
<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 Informationen.
Wichtig
Stellen Sie sicher, dass Sie potenzielle Sicherheitsrisiken durch die Offenlegung vertraulicher Geschäftsdaten minimieren, indem Sie die Ablaufverfolgung aktivieren. Informationen finden Sie unter Bewährte Methoden zum Schützen des Siebel-Adapters.
Ablaufverfolgung innerhalb des Adapters
Die Adapter im BizTalk Adapter Pack protokollieren verschiedene Kategorien nützlicher Informationen in der Ablaufverfolgungsdatei, z. B. Fehler, Warnungen und Informationen. 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 Entwurfs- 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 Anwendungen müssen Sie den Auszug der BizTalk-Konfigurationsdatei hinzufügen, die 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.
Zum Aktivieren des WCF LOB Adapter SDK und der Adapterablaufverfolgung müssen Sie dem Tag den folgenden Auszug
<configuration>hinzufügen:
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels" switchValue="Error">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name="Microsoft.Adapters.Siebel" 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 würden die WCF-Ablaufverfolgungen in C:\log\AdapterTrace.svclog gespeichert.
Ablaufverfolgung zwischen dem Adapter und der BRANCHENanwendung
Sie müssen die Ablaufverfolgung für die Kommunikation zwischen dem Adapter und der LOB-Anwendung aktivieren, um Probleme zu diagnostizieren, die Sie innerhalb der LOB-Anwendung vermuten. Adapter sind auch von der BRANCHENablaufverfolgung (Client-/Serverseite) abhängig, um Zugriff auf diese Informationen zu erhalten. Die Besonderheiten des Aktivierens der BRANCHENablaufverfolgung werden in diesem Dokument ausgeschlossen.
Darüber hinaus stellt der Siebel-Adapter eine Bindungseigenschaft (LogData) bereit, die bei Festlegung auf True und wenn die Ablaufverfolgungsebene auf Ausführlich festgelegt ist, der Siebel-Adapter den Informationsfluss zwischen dem Adapter und dem Siebel-System protokolliert. Diese Informationen werden zusammen mit den Adapterablaufverfolgungen in derselben Ablaufverfolgungsdatei protokolliert.
Weitere Informationen zu dieser Bindungseigenschaft finden Sie unter Informationen zum BizTalk-Adapter für Siebel-Bindungseigenschaften.
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 Problembehandlung.
Konfigurieren der Nachverfolgung für BizTalk-Anwendungen
Mit der BizTalk-Verwaltungskonsole können Sie verschiedene Nachverfolgungsoptionen für Dinge wie Sendeports und Empfangsports konfigurieren. Mit den Konfigurationseinstellungen für die Nachverfolgung können Sie ein-/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 den Gruppenhub auch verwenden, um nachverfolgte Nachrichten und Instanzdaten anzuzeigen, einschließlich einer Prüfliste für die Nachverfolgung und bewährten Methoden.