共用方式為


Oracle 資料庫配接器的診斷追蹤和訊息記錄

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

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

  • 配接器內的 WCF 追蹤

配接器用戶端與配接器之間的 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 追蹤 提供更良好的資訊。

重要

啟用追蹤,請務必降低公開機密商務資料的潛在安全性威脅。 如需建議,請參閱 保護 Oracle 資料庫配接器的最佳做法

配接器內的 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,此檔案通常位於安裝磁片磁碟機 > :\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.OracleDB" 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管理主控台可讓您針對傳送埠和接收埠等專案設定各種追蹤選項。 追蹤組態設定可讓您追蹤輸入和輸出事件資料、訊息屬性、訊息本文和協調流程。 管理成品 包含詳細資訊。

另請參閱

針對 Oracle 資料庫配接器進行疑難排解