Diagnoseablaufverfolgung und Nachrichtenprotokollierung für den SAP-Adapter

Artikel
10/14/2023

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

Problembehandlung für den SAP-Adapter

Teilen über