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管理主控台可讓您針對傳送埠和接收埠等專案設定各種追蹤選項。 追蹤組態設定可讓您追蹤輸入和輸出事件資料、訊息屬性、訊息本文和協調流程。 管理成品 包含詳細資訊。