SAP 配接器的診斷追蹤和訊息記錄
診斷追蹤有助於有效診斷使用配接器時可能會遇到的問題。 配接器用戶端可以在三個層級啟用診斷追蹤：
在配接器用戶端與配接器之間
在配接器內
配接器與企業營運 (LOB) 應用程式之間
本節提供在這些層級啟用追蹤的相關資訊。
配接器用戶端與配接器之間的追蹤
配接器用戶端可以啟用 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 追蹤的詳細資訊，請參閱 追蹤。
重要
藉由啟用追蹤，請務必降低公開機密商務資料的潛在安全性威脅。 如需建議，請參閱 保護 SAP 配接器的最佳做法。
配接器內的追蹤
配接器會將不同類別的實用資訊記錄到追蹤檔案，例如錯誤、警告和資訊訊息。 這類資訊有助於瞭解配接器內的程式流程，以及診斷配接器的問題。 您可以將摘錄新增至個別的組態檔，以啟用 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.SAP" 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 追蹤 (用戶端/伺服器端) 來存取這項資訊。 SAP 配接器可讓配接器用戶端在連線 URI 中指定 「RfcSdkTrace」 參數，以開啟 SAP 系統中的追蹤。 您必須指定此參數，才能讓 RFC SDK 追蹤 SAP 系統內的資訊流程。 如需連線 URI 的詳細資訊，請參閱 建立 SAP 系統連線 URI。
此外，您也可以建立RFC_TRACE環境變數，以設定 RFC SDK 的追蹤層級。 RFC_TRACE是由 SAP 定義的環境變數，並由 RFC SDK 使用。 如果未定義此變數或設定為 0，RFC SDK 追蹤層級會是最低限度的。 如果變數設定為 1 或 2，追蹤層級會更詳細。
注意
不論是否已設定RFC_TRACE環境變數， 只有在 連線 URI 中的 「RfcSdkTrace」 參數設定為 true 時，才會啟用 RFC SDK 追蹤。 此環境變數的值只會控管 RFC SDK 追蹤的層級。 如果 RfcSdkTrace 設定為 true，則介面卡與 SAP 系統之間的訊息追蹤會複製到您電腦上的 「system32」 資料夾。 若要將 RFC SDK 追蹤儲存到其他位置，您可以設定RFC_TRACE_DIR環境變數。 如需這些環境變數的詳細資訊，請參閱 SAP 檔。
檢視追蹤
您可以使用 Windows Communication Foundation (WCF) 服務追蹤檢視器工具來檢視追蹤。 如需工具的詳細資訊，請參閱 使用服務追蹤檢視器來檢視相互關聯的追蹤和問題。
設定 BizTalk 應用程式的追蹤
BizTalk Server 管理主控台可讓您為傳送埠和接收埠等專案設定各種追蹤選項。 追蹤組態設定可讓您追蹤輸入和輸出事件資料、訊息屬性、訊息本文和協調流程。 如需設定 BizTalk 應用程式追蹤的詳細資訊，請參閱 管理成品。
您也可以使用健康情況和活動追蹤 (HAT) 來檢視歷程記錄或追蹤的資料。 如需詳細資訊，請參閱 檢視歷程記錄和追蹤的資料。