使用 WCF LOB 配接器 SDK 追蹤配接器

發行項
10/14/2023

WCF LOB 配接器 SDK 追蹤建置在 Systems.Diagnostics 之上。您可以使用 WCF LOB 配接器 SDK 執行時間的 Microsoft.ServiceModel.Channels 追蹤來源。您可以使用 Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse 追蹤來源新增配接器服務參考外掛程式和使用配接器服務增益集。 WCF 追蹤會寫入名為 System.ServiceModel 的來源。

配接器開發人員可以使用 Microsoft.ServiceModel.Channels.Common.AdapterTrace 類別，為配接器提供追蹤來源名稱。配接器開發精靈會產生追蹤包裝函式類別，供配接器開發人員用來在配接器程式碼中提供檢測。

如需 WCF 追蹤的相關資訊，請參閱追蹤。

如需在 WCF 中分析追蹤的資訊，請參閱服務追蹤檢視器工具 (SvcTraceViewer.exe) 。

範例追蹤包裝函式公用程式類別

public class EchoAdapterUtilities  
{  
    static AdapterTrace trace = new AdapterTrace("Microsoft.Adapters.Samples.Echo.EchoAdapter");  
  
    /// <summary>  
    /// Gets the AdapterTrace  
    /// </summary>  
    public static AdapterTrace Trace  
    {  
        get  
        {  
            return trace;  
        }  
    }  
}

接著，配接器開發人員可以使用先前的公用程式類別，在整個配接器程式碼中提供配接器取用者的檢測資料。

EchoAdapterUtilities.Trace.Trace (System.Diagnostics.TraceEventType.Information，「EchoAdapterConnection：：Open」，「Connection successfuled！」) ;

啟用配接器和 WCF LOB 配接器 SDK 執行時間的追蹤

您可以使用配接器在應用程式的 app.config 檔案中新增下一節，以啟用 WCF LOB 配接器 SDK 中提供的追蹤。

<system.diagnostics>  
  <sources>  
    <source name="Microsoft.Adapters.Samples.Echo.EchoAdapter" switchValue="Verbose">  
      <listeners>  
        <add name="xmlTrace" />  
      </listeners>  
    </source>  
    <source name="Microsoft.ServiceModel.Channels" switchValue="Verbose">  
      <listeners>  
        <add name="xmlTrace" />  
      </listeners>  
    </source>  
  </sources>  
  <sharedListeners>  
    <add initializeData="C:\logs\TestEchoAdapter_Browse.svclog" type="System.Diagnostics.XmlWriterTraceListener" name="xmlTrace">  
      <filter type="" />  
    </add>  
  </sharedListeners>  
  <trace autoflush="true" />  
</system.diagnostics>

您可以使用 add 元素來指定您想要使用之追蹤接聽程式的名稱和類型。在我們的範例組態中，我們命名為 Listener 「xmlTrace」，並將標準.NET Framework追蹤接聽程式 (System.Diagnostics.XmlWriterTraceListener) 作為我們想要使用的型別。您可以為每一個來源新增任何數量的追蹤接聽項。例如，在下列範例中，我們也新增另一個名為「textTrace」的接聽程式，其使用.NET Framework追蹤接聽程式 System.Diagnostics.TextWriterTraceListener。如果追蹤接聽項將追蹤發出到檔案中，則您必須在組態檔中指定輸出檔案位置與名稱。這可藉由將 initializeData 設定為該接聽程式檔案名來完成。

啟用新增配接器服務參考外掛程式的追蹤

您可以在位於 \Program Files (x86)\Microsoft Visual Studio\Common7\IDE 的 devenv.exe.config 檔案中新增下列區段，以啟用此外掛程式的追蹤。

<system.diagnostics>  
   <sources>  
    <source name="Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse" switchValue="Verbose, ActivityTracing">  
      <listeners>  
        <add name="textTrace"/>  
      </listeners>  
    </source>  
  </sources>  
  <sharedListeners>  
    <add initializeData="C:\logs\aasr.svclog" type="System.Diagnostics.XmlWriterTraceListener" name="xmlTrace">  
      <filter type="" />  
    </add>  
    <add initializeData="C:\logs\aasr.log" type="System.Diagnostics.TextWriterTraceListener" name="textTrace">  
      <filter type="" />  
    </add>  
  </sharedListeners>  
  <trace autoflush="true" indentsize="4" />  
</system.diagnostics>

啟用取用配接器服務增益集的追蹤

您可以在位於 \Program Files (x86)\Microsoft BizTalk Server 的 BTSNTSVC.exe.config 檔案中新增下列區段，以啟用此增益集的追蹤。

<system.diagnostics>  
   <sources>  
    <source name="Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse" switchValue="Verbose, ActivityTracing">  
      <listeners>  
        <add name="textTrace"/>  
      </listeners>  
    </source>  
  </sources>  
  <sharedListeners>  
    <add initializeData="C:\logs\aasr.svclog" type="System.Diagnostics.XmlWriterTraceListener" name="xmlTrace">  
      <filter type="" />  
    </add>  
    <add initializeData="C:\logs\aasr.log" type="System.Diagnostics.TextWriterTraceListener" name="textTrace">  
      <filter type="" />  
    </add>  
  </sharedListeners>  
  <trace autoflush="true" indentsize="4" />  
</system.diagnostics>

另請參閱

針對使用 WCF LOB 配接器 SDK 建立的配接器進行疑難排解

共用方式為