Oracle E-Business Suite 配接器中的診斷追蹤和訊息記錄

發行項
10/14/2023

診斷追蹤有助於有效地診斷使用配接器時可能會遇到的問題。本主題提供 Microsoft BizTalk Adapter for Oracle E-Business Suite 支援的下列三種追蹤類型相關資訊：

使用用戶端識別碼的 Oracle 伺服器端追蹤
配接器用戶端與配接器之間的 WCF 追蹤
配接器內的 WCF 追蹤

使用用戶端識別碼的 Oracle 伺服器端追蹤

Oracle 可讓您針對 Oracle 資料庫上的用戶端應用程式所執行的作業執行伺服器端追蹤。由於用戶端應用程式的要求可以路由傳送至不同的資料庫會話，因此很難追蹤要求的來源。不過，Oracle 可協助使用用戶端識別碼進行端對端應用程式追蹤。

Oracle E-Business 配接器會 OracleConnectionClientId 公開系結屬性，可讓您在設計階段指定用戶端識別碼，讓配接器用來連接到 Oracle 的連線。配接器用戶端識別碼可協助您選擇性地追蹤 Oracle 上配接器用戶端所執行的作業，也可讓您根據用戶端識別碼篩選及檢視 Oracle 伺服器追蹤。如需如何在 Oracle 中啟用用戶端識別碼追蹤的資訊，請參閱 https://go.microsoft.com/fwlink/p/?LinkId=135746 。

配接器用戶端與配接器之間的 WCF 追蹤

配接器用戶端可以啟用 WCF 追蹤，以追蹤配接器用戶端與配接器之間的問題。 WCF 追蹤是用來使用 WCF 服務模型來追蹤來自配接器用戶端的輸入 XML，並有助於診斷序列化問題。 WCF 追蹤不會用於 WCF 通道模型，或用於從配接器到配接器用戶端的輸出訊息。您可以將摘錄新增至個別組態檔，以啟用 BizTalk 應用程式和 WCF 服務模型應用程式的 WCF 追蹤。此外，您也可以在設計階段和執行時間啟用追蹤。

在設計階段追蹤。針對設計階段體驗，您可以使用 [新增配接器服務參考外掛程式]、[取用配接器服務增益集] 或 [新增配接器中繼資料精靈]。所有這些工具都可以從 Visual Studio 使用。因此，若要啟用設計階段體驗的追蹤，您必須將摘錄新增至位於安裝磁片磁碟機 > ：\Program Files\Microsoft Visual Studio 版本\Common7\IDE 中的 < devenv.exe.config 檔案。><
在執行時間追蹤。針對執行時間追蹤，您必須根據您使用的應用程式來新增摘錄。
- 對於BizTalk Server應用程式，您必須將摘錄新增至 BizTalk 設定檔，通常 BTSNTSvc.exe.config。針對BizTalk Server，此檔案通常位於安裝磁片磁碟機 > ：\Program Files\Microsoft BizTalk Server下 < 。
- 針對 WCF 服務模型 .NET 應用程式，您必須將摘錄新增至專案的 app.config 檔案。
若要啟用 WCF 追蹤，請在標籤內 <configuration> 新增下列摘錄：

<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>

這會將 WCF 追蹤儲存至 C：\log\WCFTrace.svclog。 WCF 追蹤提供詳細資訊。

重要

請確定您減輕公開機密商務資料的潛在安全性威脅，這些威脅可能會在啟用追蹤時造成。如需建議，請參閱訊息和實例資料追蹤的最佳做法。

配接器內的 WCF 追蹤

配接器會將不同類別的實用資訊記錄到追蹤檔案，例如錯誤、警告和資訊訊息。這類資訊有助於瞭解配接器內的進程流程，以及診斷配接器的問題。您可以將摘錄新增至個別組態檔，以啟用 BizTalk 應用程式和 WCF 服務模型應用程式的 WCF LOB 配接器 SDK 和配接器追蹤。此外，您也可以在設計階段和執行時間啟用追蹤。

在設計階段追蹤。針對設計階段體驗，您可以使用 [新增配接器服務參考外掛程式]、[取用配接器服務增益集] 或 [新增配接器中繼資料精靈]。所有這些工具都可以從 Visual Studio 使用。因此，若要啟用設計階段體驗的追蹤，您必須將摘錄新增至位於安裝磁片磁碟機 > ：\Program Files\Microsoft Visual Studio 版本\Common7\IDE 中的 < devenv.exe.config 檔案。><
在執行時間追蹤。針對執行時間追蹤，您必須根據您使用的應用程式來新增摘錄。
- 對於BizTalk Server應用程式，您必須將摘錄新增至 BizTalk 設定檔，通常 BTSNTSvc.exe.config。對於 BizTalk Server 2006 R2，此檔案通常位於安裝磁片磁碟機 > ：\Program Files\Microsoft BizTalk Server 2006 下 < 。針對BizTalk Server，此檔案通常位於安裝磁片磁碟機 > ：\Program Files\Microsoft BizTalk Server下 < 。
- 針對 WCF 服務模型 .NET 應用程式，您必須將摘錄新增至專案的 app.config 檔案。
若要啟用 WCF LOB 配接器 SDK 和配接器追蹤，請在標籤中 <configuration> 新增下列摘錄：

<system.diagnostics>
    <sources>
      <source name="Microsoft.ServiceModel.Channels" switchValue="Error">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name="Microsoft.Adapters.OracleEBS" 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>

這會將 WCF 追蹤儲存至 C：\log\AdapterTrace.svclog。

檢視追蹤

您可以使用 Windows Communication Foundation (WCF) 服務追蹤檢視器工具來檢視追蹤。使用服務追蹤檢視器檢視相互關聯的追蹤和疑難排解，提供此工具的詳細資料。

設定 BizTalk 應用程式的追蹤

BizTalk Server管理主控台可讓您針對傳送埠和接收埠等專案設定各種追蹤選項。追蹤組態設定可讓您追蹤輸入和輸出事件資料、訊息屬性、訊息本文和協調流程。如需設定 BizTalk 應用程式追蹤的詳細資訊，請參閱管理和追蹤您的成品。

您也可以使用群組中樞來檢視追蹤的訊息和實例資料，包括最佳做法、儲存追蹤查詢等等。

另請參閱

針對配接器進行疑難排解

共用方式為