SQL 配接器中的診斷追蹤和訊息記錄
診斷追蹤有助於有效診斷使用配接器時可能會遇到的問題。 配接器用戶端可以在兩個層級啟用診斷追蹤:
在配接器用戶端與配接器之間
在配接器內
本節提供在這些層級啟用追蹤的相關資訊。
配接器用戶端與配接器之間的追蹤
配接器用戶端可以啟用 WCF 追蹤,以追蹤配接器用戶端與配接器之間的問題。 WCF 追蹤是用來使用 WCF 服務模型來追蹤來自配接器用戶端的輸入 XML,而且在診斷序列化問題時很有用。 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 追蹤的詳細資訊,請參閱 追蹤。
重要
藉由啟用追蹤,請務必降低公開機密商務資料的潛在安全性威脅。 如需建議,請參閱 保護 SQL 配接器的最佳做法。
配接器內的追蹤
配接器會將不同類別的實用資訊記錄到追蹤檔案,例如錯誤、警告和資訊訊息。 這類資訊有助於瞭解配接器內的程式流程,以及診斷配接器的問題。 您可以將摘錄新增至個別的組態檔,以啟用 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.Sql" 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 應用程式追蹤的詳細資訊,請參閱 管理成品。
您也可以使用健康情況和活動追蹤 (HAT) 來檢視歷程記錄或追蹤的資料。 如需詳細資訊,請參閱 檢視歷程記錄和追蹤的資料。