Diagnoseablaufverfolgung und Nachrichtenprotokollierung für den SAP-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 drei 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-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 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, 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 SAP-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 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 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.SAP" 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.
Ablaufverfolgung zwischen dem Adapter und der BRANCHENanwendung
Um Probleme zu diagnostizieren, von denen Sie vermuten, dass sie im Zusammenhang mit der LOB-Anwendung stehen, müssen Sie die Ablaufverfolgung für die Kommunikation zwischen dem Adapter und der LOB-Anwendung aktivieren. Adapter sind auch von der BRANCHENablaufverfolgung (Client-/Serverseite) abhängig, um auf diese Informationen zuzugreifen. Mit dem SAP-Adapter können Adapterclients die Ablaufverfolgung innerhalb des SAP-Systems aktivieren, indem sie den Parameter "RfcSdkTrace" im Verbindungs-URI angeben. Sie müssen diesen Parameter angeben, damit das RFC SDK den Informationsfluss innerhalb des SAP-Systems nachverfolgen kann. Weitere Informationen zum Verbindungs-URI finden Sie unter Erstellen des SAP-Systemverbindungs-URI.
Darüber hinaus können Sie eine RFC_TRACE Umgebungsvariable erstellen, die die Ebene der Ablaufverfolgung für das RFC SDK festlegt. RFC_TRACE ist eine von SAP definierte Umgebungsvariable und wird vom RFC SDK verwendet. Wenn diese Variable nicht definiert oder auf 0 festgelegt ist, ist die RFC SDK-Ablaufverfolgungsebene ein absolutes Minimum. Wenn die Variable auf 1 oder 2 festgelegt ist, ist die Ablaufverfolgungsebene ausführlicher.
Hinweis
Unabhängig davon, ob die RFC_TRACE Umgebungsvariable festgelegt ist, wird die RFC SDK-Ablaufverfolgung nur aktiviert, wenn der Parameter "RfcSdkTrace" im Verbindungs-URI auf true festgelegt ist. Der Wert dieser Umgebungsvariablen steuert ausschließlich die Ebene der RFC SDK-Ablaufverfolgung. Wenn RfcSdkTrace auf true festgelegt ist, werden die Nachrichtenablaufverfolgungen zwischen dem Adapter und dem SAP-System in den Ordner "system32" auf Ihrem Computer kopiert. Um die RFC SDK-Ablaufverfolgungen an einem anderen Speicherort zu speichern, können Sie die RFC_TRACE_DIR Umgebungsvariable festlegen. Weitere Informationen zu diesen Umgebungsvariablen finden Sie in der SAP-Dokumentation.
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.
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für