共用方式為


Siebel 配接器的診斷追蹤和訊息記錄

配接器用戶端可以啟用診斷追蹤,以有效地診斷使用配接器時遇到的問題。 配接器用戶端可以在三個不同的層級啟用追蹤:

  • 在配接器用戶端與配接器之間

  • 在配接器內

  • 配接器與企業營運 (LOB) 應用程式之間

    本節提供在這些層級啟用追蹤的相關資訊。

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

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

  • 在設計階段追蹤。 針對設計階段體驗,您可以使用 [新增配接器服務參考外掛程式]、[取用配接器服務增益集] 或 [新增配接器中繼資料精靈]。 所有這些工具都可以從 Visual Studio 使用。 因此,若要啟用設計階段體驗的追蹤,您必須將摘錄新增至安裝磁片磁碟機 > :\Program Files\Microsoft Visual Studio version\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 追蹤 提供詳細資訊。

重要

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

配接器內的追蹤

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

  • 在設計階段追蹤。 針對設計階段體驗,您可以使用 [新增配接器服務參考外掛程式]、[取用配接器服務增益集] 或 [新增配接器中繼資料精靈]。 所有這些工具都可以從 Visual Studio 使用。 因此,若要啟用設計階段體驗的追蹤,您必須將摘錄新增至安裝磁片磁碟機 > :\Program Files\Microsoft Visual Studio version\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.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>  

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

配接器與 LOB 應用程式之間的追蹤

您必須啟用配接器與 LOB 應用程式之間的通訊追蹤,以診斷您在 LOB 應用程式內懷疑的問題。 配接器也會依賴 LOB 追蹤 (用戶端/伺服器端) 來存取此資訊。 開啟 LOB 追蹤的詳細資料會從本檔排除。

此外,Siebel 配接器會 (LogData) 提供系結屬性,如果設定為True,且追蹤層級設定為 Verbose,Siebel 配接器會記錄配接器與 Siebel 系統之間的資訊流程。 此資訊會與相同追蹤檔案中的配接器追蹤一起記錄。

如需這個系結屬性的詳細資訊,請參閱 閱讀 BizTalk Adapter for Siebel Binding Properties

檢視追蹤

您可以使用 Windows Communication Foundation (WCF) 服務追蹤檢視器工具來檢視追蹤。 如需工具的詳細資訊,請參閱 使用服務追蹤檢視器來檢視相互關聯的追蹤和疑難排解

設定 BizTalk 應用程式的追蹤

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

您也可以使用群組中樞來 檢視追蹤的訊息和實例資料,包括追蹤檢查清單和最佳做法。

另請參閱

針對 Siebel 配接器進行疑難排解